Ruby on Rails中MVC结构的数据传递解析

如果读者已经开发过基于 rails 的应用，但对其 mvc 间的数据传递还有诸多困惑，那么恭喜您，本文正是要总结梳理 rails 数据传递的方法和技巧。ruby on rails 3（以下统称为 rails 3）是当前的主要发布版本，本文所述及的内容和代码都基于此版本。
rails 3 简介

ruby on rails 是一个 ruby 实现、采用 mvc 模式的开源 web 应用开发框架，能够提供 web 应用的全套解决方案。它的“习惯约定优于配置”的设计哲理，使得 web 开发人员能够从繁琐的配置中解放出来，专注于核心的应用逻辑。“习惯约定优于配置”是 rails 根据最佳经验习惯，提供可直接使用的功能及规范，而不再需要开发人员通过复杂的配置文件进行具体繁琐的设置。ruby on rails 快速高质的开发特性及其数量众多的免费插件，吸引了包括 twitter、groupon 和 hulu 等大批互联网新贵。

快速创建 rails 3 应用程序

为了逐步演示 rails 3 的功能特性，此处采用增量模式开发一个简单的博客模型。 在安装完 rails3 之后，运行命令：rails new demoblog 。

demoblog 应用程序所需的各类文件就自动生成。进入生成的文件夹 demoblog，运行自动安装 demoblog 所需 gem 的命令：bundle install 。

然后在 $rorails/demoblog/config/database.yml 中简单地配置数据库文件，运行创建数据库的命令：rake db:create 。

至此，简单的 demoblog 创建完毕，运行服务器启动命令：rails server 。

打开 http://localhost:3000 就可以看到 rails 3 的典型欢迎页面，如图 1 所示。
图 1. rails 3 的典型欢迎页面

rails 脚手架可以快速地为新资源建立起模型、视图和控制器，而不必处理其中的细节。直接运行以下命令，为 demoblog 建立一个 article 脚手架，用于管理博客里的文章。运行脚手架建立命令：rails generate scaffold article title:string keywords:string content:text

这将生成 article 控制器、 article 的视图文件和含有 title、 keyword 及 content 三个属性的 article 模型。运行数据库迁移命令，生成相关数据表：rake db:migrate 。 此时，一个简单但结构完整的文章管理系统就开发完成。 通过 url：http://localhost:3000/articles/就可以直接访问其文章管理页面。

rails 3 mvc 架构解析

rails 3 采用 mvc（model 模型、view 视图、controller 控制器）层级架构实现核心功能模块。这不仅使业务逻辑独立于用户界面，代码清晰易于维护，还能够提高代码重复利用率，达成 rails“不重复自己”的原则。rails 中 mvc 的功能分别如下：

•     model（模型）：代表应用系统的数据信息以及操作这些数据的规则；
•     view（视图）：代表应用系统的用户接口，通常是包含嵌入式 ruby 代码的 html 文件，用于向浏览器提供数据的工作；
•     controller（控制器）：主要负责处理 web 请求，检索模型数据并按要求将数据传递给视图。控制器是模型和视图的联系桥梁。

以上文创建的 demoblog 应用程序为例，用户为访问文章列表，输入页面的 url：http://localhost:3000/article 打开页面，对应的 web 请求处理流程如图 2 所示，大致步骤如下：

•     浏览器发出 web 请求
•     路由模块将请求信息发送给相应的控制器，由控制器决定如何处理请求；
•     控制器根据请求处理逻辑，调用相应的模型来完成业务逻辑；
•     根据实际需求，完成数据的检索或存储；
•     控制器组织处理信息，调用视图解析从模型返回的数据；
•     完成页面渲染，返还数据给浏览器。

图 2. rails 3 mvc 事件处理流程图

通过 rails 3 典型的内部处理流程，可以看到 rails 3 的 mvc 结构清晰，分工明确。那么这些功能紧密联系的模块，是如何完成数据传递，又有哪些技巧呢？许多初学者都为此困惑不已，笔者将在下文的进行详细地分析介绍。

控制器与视图间的数据传递方法技巧

打开视图文件夹，找到用于实现文章列表的源文件 $rorails/demoblog/app/views/articles/index.html.erb，可以看到清单 1 所示代码。这段代码对变量 @articles 迭代，显示所有文章列表的属性值。
清单 1. 视图 index.html.erb 代码片段

 <% @articles.each do |article| %> 
 <tr> 
  <td><%= article.title %></td> 
  <td><%= article.keywords %></td> 
  <td><%= article.content %></td> 
  <td><%= link_to 'show', article %></td> 
  <td><%= link_to 'edit', edit_article_path(article) %></td> 
  <td><%= link_to 'destroy', article, :confirm => 
  'are you sure?', :method => :delete %></td> 
 </tr> 
 <% end %>

让初学者困惑不已的是，此处的变量 @articles 来自何处呢？为了解决这个问题，打开 article 控制器的源文件 $rorails/demoblog/app/controllers/articles_controller.rb，找到与 index.html.erb 对应的 index 方法，可以看到变量 @articles，如清单 2 所示。视图中的 @articles 变量正是由控制器生成赋值，然后传递给视图的，并且这个传递过程对开发人员而言是透明的。换句话说，视图可以直接使用对应控制器中对应方法的变量。
清单 2. 控制器中获取数据的代码片段

 def index 
  @articles = article.all 
  respond_to do |format| 
   format.html # index.html.erb 
   format.xml { render :xml => @articles } 
  end 
 end

用户打开 http://localhost:3000/articles/new 发表新文章，控制器将通过 @article = article.new，基于 article 模型创建一个值为空的数据，然后传输给 new.html.erb 视图，显示效果如图 3 所示。用户在这个空的页面上填写数据，点击“create article”创建文章。文章创建成功，返回文章创建成功的提示信息和新创建文章的内容，如图 4 所示。这里看似一个简单的过程，实际上包含了将数据从表单传递到控制器，进而传递到模型完成存储的过程。
图 3. 新创建文章

图 4. 文章创建成功

渲染视图的代码位于 _form.html.erb（被 new.html.erb 调用）。用户点击提交后，rails 将根据路由规则跳转到控制器的 create 方法。过程的确简单，但是用户填写到表单的数据是如何传递给控制器的呢？

控制器的 create 方法如下清单 3 所示。为了创建新的 article 对象，create 方法将从 params 中读取数据 :article 参数。这里的 params 是哈希表，它是 rails 里最重要的传递参数之一，包含浏览器请求传递的数据。正是这个 params 将数据从客户端表单传递到控制器。以此处为例，新建的文章表单数据（包括 title，keywords，content）将被封装到 article 对象，通过 params 传递到控制器。
清单 3. 控制器的 create 方法

 def create 
  @article = article.new(params[:article]) 
  respond_to do |format| 
   if @article.save 
    format.html { 
   redirect_to(@article, :notice => 'article was successfully created.') }
    format.xml { 
   render :xml => @article, :status => :created, :location => @article } 
   else 
    format.html { 
   render :action => "new" } 
    format.xml { 
   render :xml => @article.errors, :status => :unprocessable_entity } 
   end 
  end 
 end

rails 应用程序可以用两种方法的把数据传给 params，进而由控制器的某个方法获取。一种是将用户输入到 html 表单的数据封装到 http 请求，通过 post 方法将数据传给控制器的 params。上文采用的就是这种方法，将 new.html.erb 视图的表单数据通过 post 方法提交。另外一种方法就是通过把数据作为 url 的一部分，位于 url 中 ? 之后，通常称为 url 查询字符串参数。rails 并没有对这两种方法传递的数据做出区分，控制器都能够以前文述及的方法从 params 中获取数据。以 url：http://127.0.0.1:3000/articles?keywords%5b%5d=hello&keywords%5b%5d=test& keywords%5b%5d=article 为例，params[:keywords] 将存储 [“hello”, “test”, “article”]。

控制器与模型间的数据传递方法技巧

正如图 2 所示，控制器是连接视图与模型的关键组件，它不仅接收来自视图的表单数据，还可以将模型里的数据传递给视图。比起控制器与视图之间的数据传递，控制器与模型的数据相互传递更容易理解。

参考代码清单 3，控制器通过 article.new(params[:article]) 的方法创建一个 article 实例，然后由 @article.save 将数据存储到数据库表中。这个过程如此的简单，看起来控制器是直接与数据库交换的，并没有涉及任何模型。打开模型源文件 $rorails/rorails/demoblog/app/models/ article.rb，如清单 4 所示。模型代码竟然如此简洁，连实体关系模型中常见的属性定义都没有。实际上，rails 中模型的属性是靠命名规则与数据库字段实现关联的。模型数据的属性定义是在对应的 migrate 文件中。控制器直接使用 create，save 和 update 等继承自父类 activerecord::base 的方法，实现数据创建、存储和更新，不需要额外的编写代码。
清单 4. article 模型的代码

 class article < activerecord::base 
 end

在 rails 中，控制器获取模型数据过程也是相当的方便快捷。打开控制器源文件，update 方法如清单 5 所示。rails 按照路由规则把请求 url 中的 id 值，通过 params 传递给控制器。article.find 方法根据 :id 查找现有的数据，然后使用 update_attributes 方法更新记录。rails 控制器正是通过 activerecord 的 find 方法从模型中读取数据。
清单 5. 控制器 update 方法

 def update 
  @article = article.find(params[:id]) 
  respond_to do |format| 
   if @article.update_attributes(params[:article]) 
    format.html { 
    redirect_to(
    @article, :notice => 'article was successfully updated.') } 
    format.xml { head :ok } 
   else 
    format.html { render :action => "edit" } 
    format.xml { 
    render :xml => 
    @article.errors, :status => :unprocessable_entity } 
   end 
  end 
 end

rails 3 封装了控制器、模型乃至数据库之间的数据映射关系，极大地简化了数据操作过程，数据存取异常方便，充分体现了 rails 的“习惯约定优于配置”设计哲理。

视图内的数据共享
视图与布局间的数据共享

在 rails 3 之后，通过脚手架生成的视图布局位于 layouts/application.html.erb，能够被所有的控制器共享。布局和视图可以共享控制器中的数据。也就是说，布局可以用与视图完全一样的方法获取控制器中的数据。

然而在某些特殊的情况下，布局需要读取一些视图的信息。以 demoblog 为例，为了能够在文章列表显示页面的标题上显示文章的总篇数，可以在 index.html.erb 末尾添加代码如清单 6 所示。
清单 6. 视图 index 读取文章总篇数

 <% content_for :articlenumber do %> 
 <%= @articles.length %> 
 <% end %>

在布局源文件的头部，添加 yield 方法，如清单 7 所示。这样 <% content_for :articlenumber do %> 标签里的信息，就可以在 <%= yield :articlenumber %> 指定的位置显示。文章的篇数信息在页面头部的最终显示效果如图 5 所示。
清单 7. 通过布局源文件显示

 <head> 
 <title>demoblog has <%= yield :articlenumber %> articles. </title> 
 <%= stylesheet_link_tag :all %> 
 <%= javascript_include_tag :defaults %> 
 <%= csrf_meta_tag %> 
 </head>

图 5. 文章总篇数的最终显示效果

上述的例子比较特殊，但却很好地阐述了布局读取视图数据的方法。需要注意的是，布局是不能向视图传递信息的，因为视图的执行是在布局引入或者说发生作用之前。
视图之间的数据

视图之间经常需要传递数据，rails 为此进行了精心设计。它不仅提供特有的 flash 快捷机制，也支持传统的 session 和 cookie 功能。需要说明的是，此节讲述的数据传递过程，本质上还是从控制器到视图的。因为对用户而言，数据是从某个视图获取，然后通过另外一个视图显示出来。因为中间的控制器对开发者而言近乎透明，所以姑且将此类型定义为视图之间的数据传递。

rails 的 flash 机制尤其适用于前后关联的视图页面之间传递数据。从本质上看， flash 是 rails 内建的一个哈希表，用于从一个控制器向另一个控制器的视图发送用户所需的消息。当控制器调用 redirect_to 时，重定向会清空除 flash 之外的所有变量。

以文章修改更新为例，需要在下一个页面（此处是显示文章的页面，对应 show 的 action）告诉用户完成的结果。对应的 update 方法如前文代码清单 5 所示，很显然，更新成功的提示消息 'article was successfully updated.' 赋值给了 :notice， 而后者正是 flash 哈希表的最常用的一个键。除了 :notice 之外，:error, :alert, warning 键也是相当常见的。提示文章更新成功的消息显示效果如图 6 所示。
图 6. 提示文章更新成功

通常，添加到 flash 的数据能够在紧接着的下个请求里读取。但是某些情况下，您想在当前请求中直接使用。比如文章创建失败，直接渲染页面的情况下，就不会导致新的请求。如果此时需要显示 flash 中的信息，可以用 flash.now 方法实现。

flash 的使用必须注意几点：首先，为了保证性能， flash 中存储的数据不能过长。其次，flash 的内容只能跨越一次重定向，如果希望数据能够在重定向后依然有效，需要在重定向之前使用 flash.keep。

为了演示 rails 是如何使用 cookie 和 session 的，此处将为文章添加读者评论功能。整个创建过程非常简单，以下一条命令就能够创建评论所需的数据库表并实现嵌套映射：

rails generate model comment user:string comment:text article:references

运行迁移数据库命令：rake db:migrate，添加评论显示代码，就可以获取如图 7 所示的读者评论功能。
图 7. 读者发表文章评论

cookie 通常是由服务器端发送给浏览器的，用于存储少量用户信息的文本。基于 rails 的应用多数情况下不需要直接存取 cookie，因为 rails 内置的会话机制或者第三方的插件都能够支持用户信息管理。存储在 cookie 中的数据可以跨请求甚至跨会话， 所以用户也可以直接使用 cookie 存取数据。

rails 提供非常简便的 cookie 访问方法。为了提示用户使用相同的用户名发表评论，此处采用 cookie 来保存用户最近一次发表评论时使用的用户名。如清单 8 所示，通过 cookies[:name] 来读取或者保存用户名。
清单 8. 创建评论的控制器代码片段

 class commentscontroller < applicationcontroller 
 def create 
  @last_name = cookies[:name] 
  @name = params[:comment][:user] 
  unless @name == @last_name 
   cookies[:last_name] = @last_name 
   cookies[:name] = @name 
  else 
   cookies[:last_name] = nil 
  end 
 end 
 end

在文章控制器中，如清单 9 所示，可以将 cookies 保存的数据读取出来，使用非常方便。评论页面的显示效果如图 8 所示。
清单 9. 通过 cookie 操作数据

 def show 
  @article = article.find(params[:id]) 
  @last_name = cookies[:last_name] 
  unless @last_name == nil 
  @name = cookies[:name] 
 end

图 8. 文章评论显示效果

rails 应用程序经常使用 session 来实现多个请求之间的数据传递，session 对象在控制器和视图中都可以使用。现在我们新增加一个 session 对象，用于保存用户使用过的姓名列表。在 commentscontroller 中，session 对象的操作如清单 10 所示。
清单 10. 通过 session 操作数据的代码片段

  @names = session[:name] 
  if @names 
   @names = [] 
  end 
  if @name 
   @names << @name 
  end 
  session[:names] = @names

在视图中，添加显示用户名列表的代码，如清单 11 所示。页面最终显示效果如图 9 所示。
清单 11. 视图读取用户名列表的代码

 <% if @names %> 
 <p>the names you have used:</p> 
 <ul> 
 <% @names.each do |name| %> 
  <li><%=h name %></li> 
 <% end %> 
 </ul> 
 <% end %>

图 9. 页面上显示用户列表

从实现的效果上看，flash、cookie 及 session 都能够完成视图间的数据传递。但 flash 一般用于简单的提示消息，而 cookie 及 session 则常见于用户信息管理。

结语

本文结合实际的演示程序，首先介绍了 rails 3 的 mvc 架构，然后逐步对控制器与视图、控制器与模型以及视图内部的关系进行了介绍，对数据传递方法于技巧进行了具体分析。