實(shí)例應(yīng)用
??? 我們以《RapidWeb Development mit Ruby on Rails》中的一個(gè)例子“項(xiàng)目管理應(yīng)用”來描述Rails的REST方面的特性。
??? 首先創(chuàng)建一個(gè)rails的應(yīng)用：(原書中的rails為1.2)
> rails ontrack
??? 創(chuàng)建 開發(fā) 和 測(cè)試 的數(shù)據(jù)庫(kù)。
> mysql -u rails -p
Enter password: *****
mysql> create database ontrack_development;
mysql> create database ontrack_test;
mysql> quit

基于REST的rails 應(yīng)用可以使用新的腳手架(scaffold)命令 scaffold_resource 來方便的創(chuàng)建。可以傳遞給生成器這樣一些參數(shù)：在本例中，就是資源的名字 “project”, 和 這個(gè)model 的字段名字以及類型。字段的類型是必須的，因?yàn)槲覀円褂胢igration,以及在視圖中顯示這些字段。
> cd ontrack
> ruby script/generate scaffold_resource project name:string desc:text


生成器不僅生成了 model, controller, view, 還生成了完整的migration腳本，以及在 routes.rb 里生成了一個(gè)映射：map.resources :projects ，對(duì)于新生成controller來說，這是用于REST方面的最后一個(gè)映射項(xiàng)目。

創(chuàng)建表：
> rake db:migrate

如果我們來看看剛才生成的ProjectController，會(huì)發(fā)現(xiàn)其實(shí)并沒有什么新鮮的東西，無非也就是這么一些操作：創(chuàng)建(create)，讀取 (retrieve)，更新(update)，刪除(delete)這些操作。需要強(qiáng)調(diào)注意：這些操作都是針對(duì)Project這個(gè)資源的。 Controller 和 Action 看起來都很普通，但是仔細(xì)看一下，每個(gè)Action 都會(huì)有一些注釋，這些注釋表明了 url 和 http 所使用的動(dòng)作。這些注釋所體現(xiàn)的，就是 REST風(fēng)格的 URL。接下來的章節(jié)，我們會(huì)仔細(xì)分析一下這些URL的內(nèi)容。


REST 風(fēng)格的 URL
REST風(fēng)格的URL，并不像以往的Rails 應(yīng)用一樣，是由 controller/action/model id 所組成的，例如 /projects/show/1 。相反，REST風(fēng)格的URL僅僅由 controller 和資源的id 所組成，例如/projects/1。
注意：我們一直再?gòu)?qiáng)調(diào)“資源”這個(gè)詞。URL中沒有了 action，我們也就看不到該對(duì)資源進(jìn)行什么操作了。
“/projects/1”這個(gè)URL到底應(yīng)該是顯示一個(gè)資源，還是應(yīng)該刪除一個(gè)資源？答案來自我們之前提到的 http 協(xié)議的4個(gè)動(dòng)作。

下面的列表可以展示 http 協(xié)議的4個(gè)動(dòng)作是如何和REST風(fēng)格的URL所關(guān)聯(lián)的，并且什么樣的組合，對(duì)應(yīng)什么樣的action:

在Action 中使用 respond_to
我們已經(jīng)知道，我們可以通過一個(gè) 指定資源id的URL 和http協(xié)議的動(dòng)作的組合，來調(diào)用一個(gè) action。這使得一個(gè)URL看起來非常簡(jiǎn)潔：一個(gè)URL就指定了哪個(gè)資源要被操作，而不像以往那樣去指定一個(gè)Action。

那么到底有什么樣的需求，會(huì)讓我們?nèi)ナ褂眠@種風(fēng)格的URL呢？一個(gè) REST的action可以應(yīng)付不同的客戶端所需要的不同的信息格式。對(duì)于一個(gè)WEB迎來說，典型的客戶端當(dāng)然就是瀏覽器了，但是別忘了，對(duì)于一個(gè)web service 來說，它需要的則是 xml 格式的信息；對(duì)于一個(gè)RSS閱讀器來說，它需要的則是 RSS格式的信息。對(duì)于客戶端的請(qǐng)求，我們已經(jīng)使用 scaffold 生成器生成了 CRUD 4個(gè)方法來處理。下面的代碼片斷展示了 “show” 這個(gè) action 中 respond_to 的使用方法：
Listing 1.2: ontrack/app/controllers/projects controller.rb
??? # GET /projects/1
??? # GET /projects/1.xml
??? def show
??? ??? @project = Project.find(params[:id])
??? ??? respond_to do |format|
??? ??? format.html # show.rhtml
??? ??? format.xml { render :xml => @project.to_xml }
??? ??? end
??? end
respond_to 方法是用了代碼塊(block)技術(shù)，在這個(gè)例子中，代碼塊(block)部分處理了2種格式的信息：html 和 xml。針對(duì)客戶端不同的請(qǐng)求，會(huì)執(zhí)行代碼塊(block)中不同的部分。例如如果客戶端請(qǐng)求的是html 信息，那么會(huì)執(zhí)行“format.html”，如果客戶端請(qǐng)求的是xml 信息，那么會(huì)執(zhí)行“format.xml”部分。

如果 format.html 代碼塊里是空的，那么默認(rèn)就顯示 show.rhtml。
控制 respond_to 可以通過2種方式：一是在 http-header 里面；二是在URL后面追加一些東西，也就是改變URL的樣式。

改變URL的樣式
第二種控制 action 返回不同格式的信息的方法，就是改變URL的樣式。假設(shè)我們沒有刪除 id=1 這個(gè)資源project，那么我們通過以下這個(gè)方式來在瀏覽器里顯示這個(gè)資源：http://localhost:3000/projects/1.xml
這里MAC的用戶要注意，這種情況下 firefox 表現(xiàn)的不錯(cuò)，但是Safari就差些，因?yàn)镾afari 會(huì)忽略xml 格式的信息。甚至 firefox 會(huì)把xml 顯示的非常漂亮！到這里，我們已經(jīng)知道一個(gè)controller 和 URL是如何工作的，在接下來的2個(gè)章節(jié)里，我們會(huì)學(xué)習(xí)如何在 controller 和 view 里使用和構(gòu)造這種REST風(fēng)格的URL。

好了，今天我們就介紹到這里，到現(xiàn)在為止都還是理論上的東西，下節(jié)將開始說view、controller中的rest風(fēng)格。

應(yīng)用Rails進(jìn)行REST 開發(fā)(二)