Trong bài đăng blog này, chúng ta sẽ khám phá quá trình xây dựng một GraphQL API trong Ruby on Rails, một framework mạnh mẽ và thân thiện với nhà phát triển.

GraphQL là gì?

GraphQL là một ngôn ngữ truy vấn dành cho API và là một runtime để thực hiện những truy vấn đó đối với dữ liệu của bạn. Khác với các API REST truyền thống, nơi máy khách có kiểm soát hạn chế về dữ liệu mà nó nhận được, GraphQL cho phép máy khách yêu cầu chỉ những dữ liệu cần thiết. Điều này dẫn đến quá trình truy xuất dữ liệu hiệu quả và chính xác hơn.

Thiết Lập Dự Án Rails

Trước khi đào sâu vào GraphQL, hãy thiết lập một dự án Rails mới. Mở terminal và chạy các lệnh sau:

rails new graphql_api 
cd graphql_api

Thêm Dependencies

Để tích hợp GraphQL vào dự án Rails của bạn, bạn sẽ cần thêm một số gems vào Gemfile. Mở Gemfile và bao gồm các dòng sau:

# Gemfile 

gem 'graphql' 
gem 'graphiql-rails', group: :development

Chạy bundle install để cài đặt các gems này.

Tạo Schema GraphQL

Trong GraphQL, schema xác định các loại và các hoạt động có thể thực hiện trên dữ liệu của bạn. Hãy tạo một schema đơn giản cho ứng dụng blog. Chạy lệnh sau để tạo một schema GraphQL mới:

rails generate graphql:install

Lệnh này sẽ tạo một thư mục graphql trong thư mục dự án của bạn, chứa một tệp schema cơ bản (app/graphql/types/query_type.rb). Tùy chỉnh tệp này để xác định schema GraphQL của bạn.

# app/graphql/types/query_type.rb 

module Types 
  class QueryType < Types::BaseObject 
    field :posts, [Types::PostType], null: false 
    
    def posts 
      Post.all
    end 
  end 
end

Định Nghĩa Các Loại

Trong ví dụ này, chúng ta đã tạo một trường posts trả về một mảng các đối tượng Post. Bạn cũng cần xác định PostType.

• Đừng quên là hãy chạy lệnh rails generate model Post title:string content:text và rails db:migrate để tạo ra bảng Post trước

Tạo một tệp mới app/graphql/types/post_type.rb:

# app/graphql/types/post_type.rb 

module Types 
  class PostType < Types::BaseObject 
    field :id, ID, null: false 
    field :title, String, null: false 
    field :content, String, null: false 
  end 
end

Tệp này xác định cấu trúc của một loại Post với các trường id, title, và content.

Kiểm Thử với GraphiQL

GraphiQL là một công cụ đồ họa tương tác trực tuyến dành cho GraphQL giúp đơn giản hóa quá trình kiểm thử các truy vấn GraphQL của bạn. Để kích hoạt GraphiQL, mở tệp config/routes.rb và thêm các dòng sau:

# config/routes.rb 

if Rails.env.development? 
  mount GraphiQL::Rails::Engine, at: "/graphiql", graphql_path: "/graphql" end 
  
post "/graphql", to: "graphql#execute"

Bây giờ, khi bạn chạy máy chủ Rails của mình (rails server), bạn có thể truy cập http://localhost:3000/graphiql để tương tác với GraphQL API của bạn.

Thực Hiện Các Truy Vấn

Bây giờ, bạn có thể kiểm thử các truy vấn GraphQL của mình trong GraphiQL. Ví dụ:

query {
  posts {
    id
    title
    content
  }
}

Truy vấn này sẽ truy xuất tất cả các bài viết cùng với các trường id, title, và content.

Chúc mừng! Bạn đã xây dựng thành công một GraphQL API trong Ruby on Rails.
Happy coding!

The post Building a GraphQL API in Rails appeared first on Tomoshare.

1. Giới Thiệu Về CarrierWave

CarrierWave là một gem Ruby on Rails mạnh mẽ được thiết kế để giúp bạn quản lý và xử lý tệp tin tải lên, đặc biệt là ảnh. Với tính năng linh hoạt và dễ sử dụng, CarrierWave giúp bạn dễ dàng thay đổi kích thước ảnh, lưu trữ trên các dịch vụ như Amazon S3, và thậm chí cả tạo các phiên bản ảnh thumbnail.

2. Cài Đặt CarrierWave

Để bắt đầu, thêm gem CarrierWave vào Gemfile của bạn:

gem 'carrierwave'

Sau đó, cài đặt và sinh ra file cấu hình:

bundle install
rails generate uploader Avatar

3. Sử Dụng CarrierWave Trong Model

class User < ApplicationRecord
  mount_uploader :avatar, AvatarUploader
end

Ở đây, avatar là tên của trường chứa đường dẫn đến tệp tin đã được tải lên, và AvatarUploader là tên của uploader đã được sinh ra trước đó.

4. Xử Lý Ảnh Trong Controller

class UsersController < ApplicationController
  def update
    @user = User.find(params[:id])
    @user.update(user_params)
  end

  private

  def user_params
    params.require(:user).permit(:avatar)
  end
end

5. Hiển Thị Ảnh Trong View

<%= image_tag @user.avatar.url if @user.avatar.present? %>

6. Tính Năng Mở Rộng

CarrierWave cho phép bạn thực hiện nhiều tính năng hấp dẫn như:

• Thay Đổi Kích Thước Ảnh:

# Trong AvatarUploader
version :thumb do
  process resize_to_fill: [150, 150]
end

• Lưu Trữ Trên S3:

# Trong config/initializers/carrierwave.rb
config.fog_credentials = {
  provider: 'AWS',
  aws_access_key_id: 'your_access_key',
  aws_secret_access_key: 'your_secret_key',
  region: 'your_region'
}

config.fog_directory = 'your_bucket_name'

7. Kết Luận

Gem CarrierWave không chỉ giúp bạn dễ dàng quản lý tệp tin tải lên mà còn mở ra nhiều khả năng mở rộng. Sử dụng nó để tối ưu hóa trải nghiệm người dùng trong ứng dụng Rails của bạn và tận dụng tất cả những tính năng mà nó mang lại. Happy coding!

The post Generating Image Thumbnails in Your Rails Application with CarrierWave appeared first on Tomoshare.

• Ngrok là một ứng dụng cho phép bạn truy cập từ bên ngoài internet đến hệ thống nội bộ (localhost) thông qua đường hầm an toàn được mã hoá mà ai cũng có thể truy cập được thông qua custom domain của Ngrok.

• Trong một ngày đẹp trời khách hàng đang cần một demo gấp mà chưa kịp xây dựng môi trường staging để kiểm thử sản phẩm, việc sử dụng Ngrok là một giải pháp tuyệt vời để giải quyết vấn đề này.
• Bạn có thể chạy ứng dụng của mình trên máy tính cá nhân và sử dụng Ngrok để tạo ra một đường link truy cập từ xa. Khách hàng có thể truy cập vào sản phẩm của bạn ngay lập tức, mà không cần phải chờ đợi xây dựng môi trường staging. Điều này giúp tiết kiệm thời gian và giúp bạn đáp ứng nhanh chóng yêu cầu của khách hàng.

Install Ngrok:

Trên MacOS, sử dụng HomeBrew:

brew install ngrok/ngrok/ngrok

Trên Linux, sử dụng Apt:

  $ sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null && \\
  $ echo "deb <https://ngrok-agent.s3.amazonaws.com> buster main" | \\
  $ sudo tee /etc/apt/sources.list.d/ngrok.list && \\
  $ sudo apt update && sudo apt install ngrok\\

Trên Windows, sử dụng Chocolatey:

choco install ngrok

Unzip to install: Trên Linux hoặc Mac OS X, bạn có thể giải nén ngrok từ terminal bằng lệnh sau. Trên Windows, chỉ cần nhấp đúp vào ngrok.zip để giải nén nó.

$ unzip /path/to/ngrok.zip

Tạo tài khoản trên ngrok dashboard:

Kết nối với tài khoản của bạn:

Ở đây, chúng ta sẽ cần authtoken từ bước trước. Authtoken là điều mà agent sử dụng để đăng nhập vào tài khoản của bạn khi tạo một đường hầm. Chạy dòng lệnh sau trong dòng lệnh.

ngrok config add-authtoken TOKEN

Config Ngrok trong Rails development enviroment:

• Trong ứng dụng của bạn, bạn sẽ có một file config/environments/development.rb. Tệp này cho Rails biết cách cấu hình môi trường phát triển.
• Ở đây chúng ta sẽ cần thêm một dòng:

config.hosts << /.*\\.ngrok-free.app/

Bây giờ chúng ta có thể chạy máy chủ rails của chúng ta: rails s Và connect đến locahost thông qua ngrok bằng câu lệnh sau: ngrok http <port>

Lưu ý: Thay <port> bằng địa chỉ localhost mà bạn đã cấu hình trong backend. Rails mặc định là 3000, nhưng bạn nên sử dụng bất cứ cái nào bạn muốn.

Như vậy là bạn đã connect thành công và có thể truy cập đến địa chỉ của ngrok https://9b7c-118-69-55-83.ngrok-free.app để test ở trình duyệt như sau:

Cảm ơn bạn đã đọc bài viết này về tính năng ngrok và cách sử dụng trong rails . Hy vọng rằng bạn đã tìm thấy thông tin hữu ích và có thêm kiến thức về cách sử dụng tính năng này để tạo ra đường hầm kết nối từ localhost đến internet trong ứng dụng của mình. Cảm ơn các bạn đã ủng hộ.

The post Ngrok And Using Ngrok for Rails Application appeared first on Tomoshare.