Rage: Khám Phá Ruby Framework Mới Cực Đỉnh - Xây API Nhanh Như Gió!

Lê Lân

12/08/2025

Xây Dựng API Todo List Hiện Đại Với Rage – Framework Ruby Tối Ưu Hiệu Năng

Mở Đầu

Bước vào thế giới phát triển web hiện đại với Ruby chưa bao giờ dễ dàng và nhanh chóng đến thế! Với Rage, một framework Ruby mạnh mẽ được thiết kế để xây dựng các API hiện đại, bạn có thể tận hưởng sự cân bằng hoàn hảo giữa hiệu năng, tính đơn giản, và khả năng mở rộng.

Trong bài viết này, chúng ta sẽ cùng tìm hiểu cách xây dựng một ứng dụng Todo list chia sẻ sử dụng Rage. Ứng dụng cho phép người dùng thêm mục công việc, đánh dấu hoàn thành, và nhóm các mục theo danh mục cụ thể. Hơn nữa, chúng ta sẽ khám phá cách tạo tài liệu OpenAPI tự động, tích hợp cập nhật thời gian thực và đánh giá sự vượt trội của Rage so với các framework Ruby truyền thống.

Bắt đầu thôi!

Tạo Dự Án Mới Với Rage

Cài Đặt Và Khởi Tạo Dự Án

Để bắt đầu với Riot, hãy tiến hành cài đặt gem cũng như tạo một dự án mới với cơ sở dữ liệu SQLite:

$ gem install rage-rb
$ rage new todo-list -d sqlite3
$ cd todo-list
$ bundle install

Tạo Models Và Thiết Lập Quan Hệ

Tiếp theo, hãy tạo hai model là Item và Group cùng với các file migration tương ứng:

$ rage g model Item
$ rage g model Group

=> Bạn có thể xem danh sách đầy đủ các lệnh bằng cách chạy rage --tasks .

Cập nhật các model để định nghĩa quan hệ:

# app/models/group.rb
class Group < ApplicationRecord
  has_many :items
end

# app/models/item.rb
class Item < ApplicationRecord
  belongs_to :group
end

Cập nhật các migration để tạo bảng:

# db/migrate/20250401110130_create_groups.rb
class CreateTodoGroups < ActiveRecord::Migration[8.0]
  def change
    create_table :groups do |t|
      t.string :name, null: false
      t.timestamps
    end
  end
end

# db/migrate/20250401110130_create_items.rb
class CreateItems < ActiveRecord::Migration[8.0]
  def change
    create_table :items do |t|
      t.string :content, null: false
      t.boolean :is_completed, null: false, default: false
      t.references :group, index: true, null: false
      t.timestamps
    end
  end
end

Khởi Tạo Cơ Sở Dữ Liệu Với Dữ Liệu Mẫu

Thêm bản ghi đầu tiên vào file seed:

# db/seeds.rb
Item.create!(
  group: Group.new(name: "New Year's resolutions"),
  content: "Build fast APIs with Rage",
  created_at: Time.now.beginning_of_year
)

Tạo cơ sở dữ liệu, chạy migration và seed dữ liệu:

$ rage db:create && rage db:migrate && rage db:seed

Xây Dựng API Danh Sách Todo

Định Nghĩa Route

Cập nhật file route để thiết lập namespace và chỉ định hành động được phép:

# config/routes.rb
Rage.routes.draw do
  scope path: "api/v1" do
    resources :items, only: %i[index]
  end
end

Tạo Controller Để Trả Về Danh Sách

# app/controllers/items_controller.rb
class ItemsController < ApplicationController
  def index
  end
end

Thiết Kế Serializer Với Alba

Chúng ta sẽ dùng gem Alba để định dạng JSON response sao cho các items được gộp theo group một cách cấu trúc:

Thêm gem alba vào Gemfile:

gem 'alba'

Cấu hình inflector để Alba tự động xác định serializer cho các quan hệ:

# config/initializers/alba_inflector.rb
Alba.inflector = :active_support

Tạo các resource serializer:

# app/resources/application_resource.rb
class ApplicationResource
  include Alba::Resource
  root_key :data, :data
  transform_keys :lower_camel
end

# app/resources/group_resource.rb
class GroupResource < ApplicationResource
  attributes :id, :name
  has_many :items
end

# app/resources/item_resource.rb
class ItemResource < ApplicationResource
  attributes :content, is_completed: :Boolean
end

Hoàn Thành Controller

Cập nhật controller để truy xuất dữ liệu và render bằng serializer:

class ItemsController < ApplicationController
  def index
    groups = Group.includes(:items).all
    render json: GroupResource.new(groups)
  end
end

Chạy server:

$ rage s

Truy cập: http://localhost:3000/api/v1/items để xem kết quả.

Thông tin quan trọng: Việc sử dụng includes(:items) giúp giảm thiểu truy vấn lặp lại khi lấy nhóm và các mục tương ứng.

Tự Động Tạo Tài Liệu OpenAPI

Bước 0: Mount Thành Phần OpenAPI

Thêm dòng mount trong config/routes.rb :

mount Rage::OpenAPI.application, at: "/publicapi"

Bước 1: Chú Thích Controller Để Sinh Tài Liệu

Sử dụng định dạng YARD style trong controller:

class ItemsController < ApplicationController
  # Get all Todo items grouped by their parent groups.
  # @response Array<GroupResource>
  def index
    groups = Group.includes(:items)
    render json: GroupResource.new(groups)
  end
end

Truy cập http://localhost:3000/publicapi để xem giao diện tài liệu API tự động生成.

Bạn có thể dùng công cụ OpenAPI Explorer để thử nghiệm nhanh với Rage::OpenAPI.

Thêm Tính Năng Phân Trang (Pagination)

Để hỗ trợ phân trang cho danh sách dài, áp dụng phân trang dựa trên offset và limit:

class ItemsController < ApplicationController
  # Get all Todo items grouped by their parent groups.
  # @param limit? Number of items per page
  # @param offset? The offset of the first item to return
  # @response Array<GroupResource>
  def index
    limit = params[:limit] || 10
    offset = params[:offset] || 0
    groups = Group.includes(:items).limit(limit).offset(offset)
    render json: GroupResource.new(groups)
  end
end

API Tạo Mục Mới Cho Todo List

Cập Nhật Route

Rage.routes.draw do
  scope path: "api/v1" do
    resources :items, only: %i[index create]
  end
end

Controller Xử Lý Yêu Cầu Tạo Mới

class ItemsController < ApplicationController
  # Create a new Todo item.
  # @request { item: { content: String, group_id: Integer } }
  # @response ItemResource
  def create
    item = Item.create!(item_params)
    render json: ItemResource.new(item)
  end

  private

  def item_params
    params.fetch(:item).slice(:content, :group_id)
  end
end

Cập Nhật Thời Gian Thực Với Rage::Cable

Mount Thành Phần Cable

mount Rage::Cable.application, at: "/cable"

Tạo Channel

# app/channels/items_channel.rb
class ItemsChannel < Rage::Cable::Channel
  def subscribed
    stream_from "todo-items"
  end
end

Client có thể dùng package actioncable để subscribe và nhận cập nhật.

Gửi Thông Báo Khi Tạo Item Mới

Cập nhật controller:

class ItemsController < ApplicationController
  # Create a new Todo item.
  # @request { item: { content: String, group_id: Integer } }
  # @response ItemResource
  def create
    item = Item.create!(item_params)
    render json: ItemResource.new(item)
    Rage::Cable.broadcast("todo-items", { action: "new-item", data: item })
  end
end

Việc broadcast dữ liệu giúp khách hàng được cập nhật tức thì mà không cần tải lại trang.

Vì Sao Nên Chọn Rage?

Bạn có thể cảm thấy Rage “giống Rails”, nhưng đó chính là điểm mạnh giúp chuyển đổi dễ dàng với:

Cú pháp quen thuộc giúp tiết kiệm thời gian học hỏi.

Tận dụng asynchronous I/O nâng cao hiệu năng.

Tốc độ nhanh, ngang tầm Python và Elixir.

Hỗ trợ tạo tài liệu OpenAPI tự động.

Module tích hợp real-time dễ dùng.

Benchmark Rage So Với Ruby on Rails

Test Case	Kết Quả
Hello World	Rage vượt trội với độ trễ thấp hơn nhiều
Waiting on I/O	Xử lý bất đồng bộ tốt hơn, tiết kiệm thời gian chờ
ActiveRecord	Truy xuất dữ liệu nhanh và ổn định hơn

Kết Luận

Qua bài viết, bạn đã:

Hiểu cách sử dụng Rage để tạo một ứng dụng Todo list mạnh mẽ và hiệu quả.

Triển khai API RESTful phong cách hiện đại có phân trang và tài liệu OpenAPI tự động.

Tích hợp tính năng cập nhật thời gian thực với Rage::Cable.

Nhận định sức mạnh của Rage qua các benchmark so sánh với Rails.

Nếu bạn là lập trình viên Ruby muốn nâng cao hiệu suất và trải nghiệm phát triển, hãy thử ngay Rage! Khám phá thêm tài liệu chính thức và đóng góp để mọi người cùng phát triển công nghệ thú vị này.

Tham Khảo

Rage Ruby Framework GitHub

Alba – Ruby Serializer

Rage OpenAPI Explorer

Rage Performance Benchmarks

ActionCable Package

Mcfunley – Why Choose Boring Technology

Zuplo Documentation