Rails简介 #

Rails应用架构
    ├── Action Pack
    │   ├── Action Controller（控制器）
    │   ├── Action Dispatch（路由）
    │   └── Action View（视图）
    ├── Active Record（ORM）
    │   ├── 模型层
    │   ├── 数据库抽象
    │   └── 关联关系
    ├── Active Support（工具库）
    │   ├── 扩展类
    │   └── 工具方法
    └── Action Mailer（邮件）
        ├── 邮件发送
        └── 邮件预览

# 约定优于配置的体现
# 只需创建一个模型文件，Rails自动：
# - 创建对应的数据库表（复数形式）
# - 提供CRUD方法
# - 支持关联关系

class User < ApplicationRecord
  # Rails自动映射到 users 表
  # 自动提供 User.find, User.create 等方法
end

请求流程
    │
    ▼
┌─────────────┐
│   Router    │ ─── 路由分发
└─────────────┘
    │
    ▼
┌─────────────┐
│ Controller  │ ─── 处理请求
└─────────────┘
    │
    ├──▶ ┌─────────────┐
    │    │    Model    │ ─── 数据操作
    │    └─────────────┘
    │
    ▼
┌─────────────┐
│    View     │ ─── 渲染页面
└─────────────┘
    │
    ▼
   响应

# config/routes.rb
Rails.application.routes.draw do
  # 自动创建7个RESTful路由
  resources :articles
end

# 生成的路由：
# GET    /articles      => articles#index
# GET    /articles/new  => articles#new
# POST   /articles      => articles#create
# GET    /articles/:id  => articles#show
# GET    /articles/:id/edit => articles#edit
# PATCH  /articles/:id  => articles#update
# DELETE /articles/:id  => articles#destroy

# 模型定义简洁优雅
class Article < ApplicationRecord
  belongs_to :user
  has_many :comments
  has_many :tags, through: :article_tags
  
  validates :title, presence: true
  validates :body, length: { minimum: 10 }
  
  scope :published, -> { where(published: true) }
end

# 使用方式直观
article = Article.find(1)
article.comments.create(body: "Great article!")
Article.published.order(created_at: :desc)

# app/models/article.rb
class Article < ApplicationRecord
  # 关联
  belongs_to :user
  has_many :comments, dependent: :destroy
  
  # 验证
  validates :title, presence: true, length: { maximum: 100 }
  validates :body, presence: true
  
  # 作用域
  scope :recent, -> { order(created_at: :desc) }
  scope :published, -> { where(status: 'published') }
end

<!-- app/views/articles/index.html.erb -->
<h1>文章列表</h1>

<% @articles.each do |article| %>
  <div class="article">
    <h2><%= article.title %></h2>
    <p><%= truncate(article.body, length: 100) %></p>
    <%= link_to '阅读全文', article_path(article) %>
  </div>
<% end %>

# app/controllers/articles_controller.rb
class ArticlesController < ApplicationController
  def index
    @articles = Article.recent.published
  end
  
  def show
    @article = Article.find(params[:id])
  end
  
  def create
    @article = Article.new(article_params)
    
    if @article.save
      redirect_to @article, notice: '文章创建成功'
    else
      render :new, status: :unprocessable_entity
    end
  end
  
  private
  
  def article_params
    params.require(:article).permit(:title, :body, :status)
  end
end

# config/routes.rb
Rails.application.routes.draw do
  root 'home#index'
  
  resources :articles do
    resources :comments, only: [:create, :destroy]
    member do
      post :publish
    end
  end
  
  namespace :admin do
    resources :users
  end
end

前端层
    ├── Hotwire（Turbo + Stimulus）
    ├── Importmap
    └── CSS Bundling

应用层
    ├── Rails框架
    ├── Ruby语言
    └── Gem生态

数据层
    ├── PostgreSQL / MySQL
    ├── Redis（缓存/队列）
    └── ElasticSearch（搜索）

部署层
    ├── Puma服务器
    ├── Nginx反向代理
    └── Docker容器化

# Turbo Drive - 无需刷新页面
<%= turbo_frame_tag "comments" do %>
  <%= render @comments %>
<% end %>

# Turbo Streams - 实时更新
<%= turbo_stream.append "comments" do %>
  <%= render @comment %>
<% end %>

# 异步执行数据库查询
async_posts = Post.where(published: true).load_async

# 在查询完成前可以执行其他操作
do_something_else

# 需要结果时会等待查询完成
async_posts.each { |post| puts post.title }

class User < ApplicationRecord
  encrypts :email, deterministic: true
  encrypts :credit_card_number
end

# 自动加密存储，透明解密使用
user = User.create(email: 'test@example.com')
user.email # => 'test@example.com'