剖析 Rails 3 MVC 中的數據傳遞

引用連接:https://www.ibm.com/developerworks/cn/web/1108_linhx_rails3mvc/javascript

 

 

若是讀者已經開發過基於 Rails 的應用,但對其 MVC 間的數據傳遞還有諸多困惑,那麼恭喜您,本文正是要總結梳理 Rails 數據傳遞的方法和技巧。Ruby on Rails 3(如下統稱爲 Rails 3)是當前的主要發佈版本,本文所述及的內容和代碼都基於此版本。html

Rails 3 簡介java

Ruby on Rails 是一個 Ruby 實現、採用 MVC 模式的開源 Web 應用開發框架,可以提供 Web 應用的全套解決方案。它的「習慣約定優於配置」的設計哲理,使得 Web 開發人員可以從繁瑣的配置中解放出來,專一於核心的應用邏輯。「習慣約定優於配置」是 Rails 根據最佳經驗習慣,提供可直接使用的功能及規範,而再也不須要開發人員經過複雜的配置文件進行具體繁瑣的設置。Ruby on Rails 快速高質的開發特性及其數量衆多的免費插件,吸引了包括 Twitter、Groupon 和 Hulu 等大批互聯網新貴。web

快速建立 Rails 3 應用程序瀏覽器

爲了逐步演示 Rails 3 的功能特性,此處採用增量模式開發一個簡單的博客模型。 在安裝完 Rails3 以後,運行命令:Rails new demoBlog 。服務器

demoBlog 應用程序所需的各種文件就自動生成。進入生成的文件夾 demoblog,運行自動安裝 demoBlog 所需 gem 的命令:bundle install 。cookie

而後在 $rorails/demoblog/config/database.yml 中簡單地配置數據庫文件,運行建立數據庫的命令:rake db:create 。session

至此,簡單的 demoBlog 建立完畢,運行服務器啓動命令:rails server 。架構

打開 http://localhost:3000 就能夠看到 Rails 3 的典型歡迎頁面,如圖 1 所示。


圖 1. Rails 3 的典型歡迎頁面
圖 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 所示,大體步驟以下:

  1. 瀏覽器發出 Web 請求
  2. 路由模塊將請求信息發送給相應的控制器,由控制器決定如何處理請求;
  3. 控制器根據請求處理邏輯,調用相應的模型來完成業務邏輯;
  4. 根據實際需求,完成數據的檢索或存儲;
  5. 控制器組織處理信息,調用視圖解析從模型返回的數據;
  6. 完成頁面渲染,返還數據給瀏覽器。


圖 2. Rails 3 MVC 事件處理流程圖
圖 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. 新建立文章
圖 3. 新建立文章

圖 4. 文章建立成功
圖 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. 文章總篇數的最終顯示效果
圖 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. 提示文章更新成功
圖 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. 讀者發表文章評論
圖 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. 文章評論顯示效果
圖 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. 頁面上顯示用戶列表
圖 9. 頁面上顯示用戶列表

從實現的效果上看,flash、cookie 及 session 都可以完成視圖間的數據傳遞。但 flash 通常用於簡單的提示消息,而 cookie 及 session 則常見於用戶信息管理。

結語

本文結合實際的演示程序,首先介紹了 Rails 3 的 MVC 架構,而後逐步對控制器與視圖、控制器與模型以及視圖內部的關係進行了介紹,對數據傳遞方法於技巧進行了具體分析。

相關文章
相關標籤/搜索