Ruby on Rails - 脚手架

在开发 Rails 应用程序时，特别是那些主要提供数据库中数据简单界面的应用程序，使用脚手架方法通常很有用。

脚手架提供的不仅仅是廉价的演示效果。以下是一些好处：

您可以快速向用户提供代码以获取反馈。
您会被更快的成功所激励。
您可以通过查看生成的代码来了解 Rails 的工作原理。
您可以使用脚手架作为基础来启动您的开发。

脚手架示例

为了理解脚手架，让我们创建一个名为cookbook的数据库和一个名为recipes的表。

创建空的 Rails Web 应用程序

打开命令窗口并导航到您要创建此cookbook Web 应用程序的位置。因此，运行以下命令以创建完整的目录结构。

tp> rails new cookbook

设置数据库

以下是创建数据库的方法：

mysql> create database cookbook;
Query OK, 1 row affected (0.01 sec)

mysql> grant all privileges on cookbook.*
to 'root'@'localhost' identified by 'password';
Query OK, 0 rows affected (0.00 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

要指示 Rails 如何查找数据库，请编辑配置文件 cookbook\config\database.yml 并将数据库名称更改为 cookbook。密码留空。完成后，它应如下所示：

development:
   adapter: mysql
   database: cookbook
   username: root
   password: [password]
   host: localhost
	
test:
   adapter: mysql
   database: cookbook
   username: root
   password: [password]
   host: localhost
	
production:
   adapter: mysql
   database: cookbook
   username: root
   password: [password]
   host: localhost

Rails 允许您在开发模式、测试模式或生产模式下运行，使用不同的数据库。此应用程序对每个模式都使用相同的数据库。

生成的脚手架代码

使用脚手架操作，Rails 会动态生成它所需的所有代码。通过运行scaffold作为脚本，我们可以将所有代码写入磁盘，在那里我们可以检查它，然后开始根据我们的需求对其进行调整。

现在，让我们再次开始使用脚手架辅助脚本手动生成脚手架代码：

cookbook> rails generate scaffold recipe

它生成如下所示的自动文件：

控制器

让我们看一下控制器背后的代码。此代码由scaffold生成器生成。如果您打开 app/controllers/recipes_controller.rb，那么您会发现如下内容：

class RecipesController < ApplicationController
   before_action :set_recipe, only: [:show, :edit, :update, :destroy]
   
   # GET /recipes
   # GET /recipes.json
   def index
      @recipes = Recipe.all
   end
   
   # GET /recipes/1
   # GET /recipes/1.json
   def show
   end
   
   # GET /recipes/new
   def new
      @recipe = Recipe.new
   end
   
   # GET /recipes/1/edit
   def edit
   end
   
   # POST /recipes
   # POST /recipes.json
   def create
      @recipe = Recipe.new(recipe_params)
      
      respond_to do |format|
         if @recipe.save
            format.html { redirect_to @recipe, notice: 'Recipe was successfully created.' }
            format.json { render :show, status: :created, location: @recipe }
         else
            format.html { render :new }
            format.json { render json: @recipe.errors, status: :unprocessable_entity }
         end
      end
      
   end
   
   # PATCH/PUT /recipes/1
   # PATCH/PUT /recipes/1.json
   def update
      respond_to do |format|
         if @recipe.update(recipe_params)
            format.html { redirect_to @recipe, notice: 'Recipe was successfully updated.' }
            format.json { render :show, status: :ok, location: @recipe }
         else
            format.html { render :edit }
            format.json { render json: @recipe.errors, status: :unprocessable_entity }
         end
      end
      
   end
   
   # DELETE /recipes/1
   # DELETE /recipes/1.json
   def destroy
      @recipe.destroy
         respond_to do |format|
         format.html { redirect_to recipes_url, notice: 'Recipe was successfully destroyed.' }
         format.json { head :no_content }
      end
   end
   
   private
   
   # Use callbacks to share common setup or constraints between actions.
   def set_recipe
      @recipe = Recipe.find(params[:id])
   end
   
   # Never trust parameters from the scary internet, only allow the white list through.
   def recipe_params
      params.require(:recipe).permit(:tittle, :instructions)
   end
end

当 Rails 应用程序的用户选择一个操作（例如“显示”）时，控制器将执行相应部分中的任何代码（“def show”），然后默认情况下将呈现同名的模板（“show.html.erb”）。此默认行为可以被覆盖。

控制器使用 ActiveRecord 方法（如find、find_all、new、save、update_attributes 和 destroy）将数据移入和移出数据库表。请注意，您不必编写任何 SQL 语句，Rails 将自动处理它。

这单行代码将使数据库表活跃起来。它将提供一个简单的数据库接口，以及以下方法：

创建新条目
编辑当前条目
查看当前条目
删除当前条目

在创建或编辑条目时，脚手架将为您完成所有繁重的工作，例如表单生成和处理，甚至提供智能表单生成，支持以下类型的输入：

简单的文本字符串
文本区域（或大块文本）
日期选择器
日期时间选择器

您可以使用 Rails 迁移来创建和维护表。

rake db:migrate RAILS_ENV=development

现在，转到 cookbook 目录并使用以下命令运行 Web 服务器：

cookbook> rails server

现在，打开浏览器并导航到http://127.0.0.1:3000/recipe/new。这将为您提供一个屏幕，用于在 recipes 表中创建新条目。屏幕截图如下所示：

一旦您按下创建按钮来创建一个新的食谱，您的记录就会添加到 recipes 表中，并显示以下结果：

您可以看到编辑、显示和删除记录的选项。因此，您可以试用这些选项。

您还可以使用 URL http://127.0.0.1:3000/recipe/list 列出 recipes 表中所有可用的食谱。

增强模型

Rails 为您提供了大量的错误处理。要理解这一点，请向空的 recipe 模型添加一些验证规则：

修改 app/models/recipe.rb 如下，然后测试您的应用程序：

class Recipe < ActiveRecord::Base
   validates_length_of :title, :within => 1..20
   validates_uniqueness_of :title, :message => "already exists"
end

这些条目将进行自动检查。

validates_length_of - 字段不为空且不太长。
validates_uniqueness_of - 重复值会被捕获。在这里，我们给出了自定义消息，而不是默认的 Rails 错误消息。

创建脚手架的替代方法

如上所示创建应用程序，并使用如下所示的生成的脚手架代码

rails g scaffold Recipe tittle:string instructions:text

上面的代码使用 sqlite3 生成包含数据库的自动文件，标题和说明列如下图所示。

我们需要使用以下语法迁移数据库。

$ rake db:migrate RAILS_ENV=development

最后，使用以下命令行运行应用程序：

rails server

它将生成如上所示的输出图像结果。

视图

所有视图和相应的控制器方法都是由scaffold命令创建的，它们位于 app/views/recipes 目录中。

脚手架有何不同？

如果您已经阅读了前面的章节，那么您一定已经看到我们创建了列出、显示、删除和创建数据等方法，但脚手架会自动完成这项工作。

打印页面