Building a Small Rails API with Serializers

Bài đăng này đã không được cập nhật trong 4 năm

Prerequisites

Bài viết này sẽ hướng dẫn các bước cần thiết để thiết lập một Rails API. Trước khi bắt đầu, hãy chắc chắn rằng Postgres đã được install và active trên máy tính của bạn. Nếu không, chúng ta có thể tìm thấy nó trên https://postgresapp.com. Thêm nữa, Postman sẽ được sử dụng để test các API endpoints. Download và install Postman tại địa chỉ https://www.getpostman.com/.

Models

Mục tiêu của API là gửi những Photos trở lại các comment mà mà nó được liên kết. Model sẽ được thiết lập đơn giản, chúng ta chỉ có 2 model là Photos và Comments. Quan hệ giữa chúng là một photo sẽ có nhiều comments trong khi đó, 1 comments sẽ belongs to một photo

Photo -< Comments

Các attributes của một Photo sẽ là title và photo_url_string. Còn attributes của comments là content, owner và photo_id.

Setup

Ở terminal chúng ta sinh ra một API project với command:

rails new photo_api --database=postgresql --api

Để làm rõ, chúng ta include flag --database để chỉ ra Postgres sẽ được sử dụng thay vì SQLite, và flag --api để tránh sinh ra các views cũng như các view helpers vì chúng không cần thiết cho một API.

Tiếp theo, trong Gemfile add thêm:

gem 'active_model_serializers'

Gem serializer được sử dụng để cấu trúc format của dữ liệu mỗi khi request được tạo. Điều này sẽ được giải thích sau thông qua việc sử dụng Postman. Sau đó run:

bundle install

Generating Models and Controllers

Tạo ra các model Photo và Comment bằng việc chạy các lệnh:

rails g model Photo title:string photo_url_string:string
rails g model Comment content:string owner:string photo_id:integer

Di chuyển đến file app/models/photo.rb và add thjeem quan hệ với comments cũng như validate cho nó:

Trong file app/models/comment.rb, add thêm:

Bây giờ, tạo các controller cho Photo và Comment bằng lệnh:

rails g controller api/v1/Photos
rails g controller api/v1/Comments

Các lệnh này sẽ sinh ra các đường dẫn lồng nhau trong controllers. Trong file app/controllers/api/v1/photos_controller.rb add thêm:

Có một vài thứ sẽ xảy ra với đoạn code phía trên:

Tất cả photos sẽ được hiển thị dưới dạng JSON
check_params đại diện cho dữ liệu nhận được từ front-end.
Method check_params permit các key title và photo_url_string mỗi khi một request PATCH được tạo

Cũng trong file app/controllers/api/v1/comments_controller.rb, add thêm các methods:

Tiếp theo, di chuyển đến file config/route.rb và add thêm một số routes sau tương ứng với các controller bên trên:

Thêm vào nữa, hãy chắc chắn rằng dữ liệu được tồn tại để trả về các dữ liệu tương ứng một khi request được tạo. Di chuyển đến file db/seed.rb và input một số dữ liệu seed:

Sau đó chạy:

rails db:seed

Bây giờ, Rails API đã được set, chúng ta sẽ cùng run server và test các endpoints sử dụng Postman

GET Requests with Postman

Thông qua API chúng ta có thể access và xem được danh sách các route trong hệ thống:

http://localhost:3000/rails/info/routes

Mở postman và test các đường dẫn. Bắt đầu với request get all các photo. Trong Postman, method HTTP là GET và URL request là: http://localhost:3000/api/v1/photos

Một khi button send được click, nột request sẽ được tạo đến API với status code là 200 và response từ API trong body

Trong file seed data, bốn comment được sinh ra thuộc về một photo, nhưng chúng không được hiển thị trong response. Hơn nữa, thuộc tính created_at và updated_at có vẻ như không cần thiết. Có một giải pháp để thực thi cho những dữ liệu trả về ở đây là, serializers.

Trở lại với Rails API, dừng server và chạy lệnh sau:

rails g serializer photo

Việc này sẽ sinh ra đường dẫn serializer cho model Photo. Di chuyển đến file serializers/photo_serializer.rb. Trong file này, các attribites avaiable trong response có thể được config. Chúng ta có thể chỉnh sửa lại như sau:

class PhotoSerializer < ActiveModel::Serializer
   attributes :title, :photo_url_string
end

Với việc thay đổi đó, khi tạo một request khác trên Postman thì response trả về đã thay đổi:

Chúng ta có thể thấy, chỉ còn title và photo_url_string trong response trả về. Với serializers có thể được cấu trúc để chứa một số thông tin nhất định. Với các comment bị thiếu khi hiển thị photo, chúng ta có thể include các comment vào trong photo. Vẫn trong file serializers/photo_serializer.rb include thêm như sau: