引用連接:https://www.ibm.com/developerworks/cn/web/1108_linhx_rails3mvc/javascript
若是讀者已經開發過基於 Rails 的應用,但對其 MVC 間的數據傳遞還有諸多困惑,那麼恭喜您,本文正是要總結梳理 Rails 數據傳遞的方法和技巧。Ruby on Rails 3(如下統稱爲 Rails 3)是當前的主要發佈版本,本文所述及的內容和代碼都基於此版本。html
Ruby on Rails 是一個 Ruby 實現、採用 MVC 模式的開源 Web 應用開發框架,可以提供 Web 應用的全套解決方案。它的「習慣約定優於配置」的設計哲理,使得 Web 開發人員可以從繁瑣的配置中解放出來,專一於核心的應用邏輯。「習慣約定優於配置」是 Rails 根據最佳經驗習慣,提供可直接使用的功能及規範,而再也不須要開發人員經過複雜的配置文件進行具體繁瑣的設置。Ruby on Rails 快速高質的開發特性及其數量衆多的免費插件,吸引了包括 Twitter、Groupon 和 Hulu 等大批互聯網新貴。web
回頁首數據庫
爲了逐步演示 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 所示。
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(Model 模型、View 視圖、Controller 控制器)層級架構實現核心功能模塊。這不只使業務邏輯獨立於用戶界面,代碼清晰易於維護,還可以提升代碼重複利用率,達成 Rails「不重複本身」的原則。Rails 中 MVC 的功能分別以下:
以上文建立的 demoBlog 應用程序爲例,用戶爲訪問文章列表,輸入頁面的 URL:http://localhost:3000/article 打開頁面,對應的 Web 請求處理流程如圖 2 所示,大體步驟以下:
經過 Rails 3 典型的內部處理流程,能夠看到 Rails 3 的 MVC 結構清晰,分工明確。那麼這些功能緊密聯繫的模塊,是如何完成數據傳遞,又有哪些技巧呢?許多初學者都爲此困惑不已,筆者將在下文的進行詳細地分析介紹。
打開視圖文件夾,找到用於實現文章列表的源文件 $rorails/demoBlog/app/views/articles/index.html.erb,能夠看到清單 1 所示代碼。這段代碼對變量 @articles 迭代,顯示全部文章列表的屬性值。
<% @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 變量正是由控制器生成賦值,而後傳遞給視圖的,而且這個傳遞過程對開發人員而言是透明的。換句話說,視圖能夠直接使用對應控制器中對應方法的變量。
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 所示。這裏看似一個簡單的過程,實際上包含了將數據從表單傳遞到控制器,進而傳遞到模型完成存儲的過程。
渲染視圖的代碼位於 _form.html.erb(被 new.html.erb 調用)。用戶點擊提交後,Rails 將根據路由規則跳轉到控制器的 create 方法。過程的確簡單,可是用戶填寫到表單的數據是如何傳遞給控制器的呢?
控制器的 create 方法以下清單 3 所示。爲了建立新的 article 對象,create 方法將從 params 中讀取數據 :article 參數。這裏的 params 是哈希表,它是 Rails 裏最重要的傳遞參數之一,包含瀏覽器請求傳遞的數據。正是這個 params 將數據從客戶端表單傳遞到控制器。以此處爲例,新建的文章表單數據(包括 Title,Keywords,Content)將被封裝到 article 對象,經過 params 傳遞到控制器。
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 的方法,實現數據建立、存儲和更新,不須要額外的編寫代碼。
class Article < ActiveRecord::Base end |
在 Rails 中,控制器獲取模型數據過程也是至關的方便快捷。打開控制器源文件,update 方法如清單 5 所示。Rails 按照路由規則把請求 URL 中的 ID 值,經過 params 傳遞給控制器。Article.find 方法根據 :id 查找現有的數據,而後使用 update_attributes 方法更新記錄。Rails 控制器正是經過 ActiveRecord 的 find 方法從模型中讀取數據。
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 所示。
<% content_for :ArticleNumber do %> <%= @articles.length %> <% end %> |
在佈局源文件的頭部,添加 yield 方法,如清單 7 所示。這樣 <% content_for :ArticleNumber do %> 標籤裏的信息,就能夠在 <%= yield :ArticleNumber %> 指定的位置顯示。文章的篇數信息在頁面頭部的最終顯示效果如圖 5 所示。
<head> <title>Demoblog has <%= yield :ArticleNumber %> articles. </title> <%= stylesheet_link_tag :all %> <%= javascript_include_tag :defaults %> <%= csrf_meta_tag %> </head> |
上述的例子比較特殊,但卻很好地闡述了佈局讀取視圖數據的方法。須要注意的是,佈局是不能向視圖傳遞信息的,由於視圖的執行是在佈局引入或者說發生做用以前。
視圖之間常常須要傳遞數據,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 所示。
一般,添加到 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 所示的讀者評論功能。
Cookie 一般是由服務器端發送給瀏覽器的,用於存儲少許用戶信息的文本。基於 Rails 的應用多數狀況下不須要直接存取 Cookie,由於 Rails 內置的會話機制或者第三方的插件都可以支持用戶信息管理。存儲在 Cookie 中的數據能夠跨請求甚至跨會話, 因此用戶也能夠直接使用 Cookie 存取數據。
Rails 提供很是簡便的 Cookie 訪問方法。爲了提示用戶使用相同的用戶名發表評論,此處採用 Cookie 來保存用戶最近一次發表評論時使用的用戶名。如清單 8 所示,經過 cookies[:name] 來讀取或者保存用戶名。
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 所示。
def show @article = Article.find(params[:id]) @last_name = cookies[:last_name] unless @last_name == nil @name = cookies[:name] end |
Rails 應用程序常用 session 來實現多個請求之間的數據傳遞,session 對象在控制器和視圖中均可以使用。如今咱們新增長一個 session 對象,用於保存用戶使用過的姓名列表。在 CommentsController 中,session 對象的操做如清單 10 所示。
@names = session[:name] if @names @names = [] end if @name @names << @name end session[:names] = @names |
在視圖中,添加顯示用戶名列表的代碼,如清單 11 所示。頁面最終顯示效果如圖 9 所示。
<% if @names %> <p>The names you have used:</p> <ul> <% @names.each do |name| %> <li><%=h name %></li> <% end %> </ul> <% end %> |
從實現的效果上看,flash、cookie 及 session 都可以完成視圖間的數據傳遞。但 flash 通常用於簡單的提示消息,而 cookie 及 session 則常見於用戶信息管理。
本文結合實際的演示程序,首先介紹了 Rails 3 的 MVC 架構,而後逐步對控制器與視圖、控制器與模型以及視圖內部的關係進行了介紹,對數據傳遞方法於技巧進行了具體分析。