rails的REST特性简记

1.关于REST的URL的详细讨论，参见《RESTful Rails development》文档，这里有中文翻译。Path-Methods对照表：


2.在Controller和View中新增加了一些helper方法，URL路由的设置来自config目录下的routes.rb中的一行代码：

<!----> map.resources :projects

这行代码将自动产生用于Controller的系列url方法和用于View的系列Path方法，对照表
路由             产生的Helper
-----------------------------------------------------------
projects       projects_url, projects_path
project        project_url(id), project_path(id)
new_project    new_project_url, new_project_path
edit_project   edit_project_url(id), edit_project_path(id)

3.路由的定制，通过下面的选项来定制符合个人需要的路由规则：

<!---->:controller.   设置使用的Controller.
:path_prefix.  URL前缀.
:name_prefix.  用于设置产生的helper方法的前缀 
:singular. To name the singular name to be used for the member route.

4.Nested Resource（嵌套资源乎？），当rails采用REST架构时如何处理过去的Model之间的关联关系，比如1：N？比如以文档中的例子来说明，一个project可能有多个iteration，典型的一对多关系，我们在产生Model后，与传统rails一样，设置关联关系：

<!---->class Project < ActiveRecord::Base
  has_many :iterations
end

class Iteration < ActiveRecord::Base
  belongs_to :project
end

1）既然是REST架构，那么路由改如何设置呢？或者说我们该怎么访问某个project的所有itration呢？直观的感觉应该是http://localhost:3000/project/:project_id/iterations，那么可以这样修改routes.rb，把生成的

<!---->map.resources :iterations

修改为：

<!---->map.resources :projects do |projects|
   projects.resources :iterations
end

将自动产生如下格式的路由：

<!---->/project/:project_id/iterations
/project/:project_id/iterations/:id

2）接下来，应当修改IterationsController的增、改、查action了，因为要关联project对象，在Controller中可以通过params[:project_id]获取该iteration所在的project。比如修改index action:

<!---->def index
  project = Project.find(params[:project_id])
  @iterations = project.iterations.find(:all)
  respond_to do |format|
     format.html # index.rhtml
     format.xml { render :xml => @iterations.to_xml }
  end
end

3）相应的iteration的Controller和View的Url和Path等helper都增加了一个参数，他们的第一个参数都将是project_id，比如

<!----><%= link_to "Show",iteration_path(iteration.project,
iteration) %>

<%= link_to "Edit", edit_iteration_path(iteration.project,
iteration) %>

同样，所有form_for指向的url的helper也都增加了这个参数。总结一句话，被嵌套类（这里的iteration）的所有helper都增加一个参数并且是第一个参数——外包类（这里的project）的id

5.自定义action，对于不能归结为crud操作的action，我们需要自己定义action，已经说过，REST把所有的远程调用抽象为对远程资源的CRUD操作，非CRUD操作应当转化或者说抽象成CRUD操作，比如对于project可以有一个关闭操作close，我们可以把它理解成一个http POST请求去修改project的closed字段为true,这样一来这个操作也可以当作CRUD操作了。需要做的是在routes.rb增加一行：

<!---->map.resources :projects, :member => { :close => :post }

定义close action是POST方法，在Controller增加close方法：

<!---->def close
   respond_to do |format|
      if Project.find(params[:id]).update_attribute(:closed, true)
       flash[:notice] = "Project was successfully closed."
       format.html { redirect_to projects_path }
       format.xml { head :ok }
     else
       flash[:notice] = "Error while closing project."
       format.html { redirect_to projects_path }
       format.xml { head 500 }
     end
   end
end

你可以通过http://localhost:3000/project/:project_id;close来调用此方法，请注意，POST的方法需要通过Form来实现，因此我们使用button_to：

<!----><td><%= button_to "Close", close_project_path(project) %></td>

自定义action不仅仅可以使用REST风格，传统的controller/action/id的方式仍然可以使用，注意下routes.rb的最后两行即可。

6.自定义格式，rails支持的格式有：

<!---->respond_to do |wants|
  wants.text
  wants.html
  wants.js
  wants.ics
  wants.xml
  wants.rss
  wants.atom
  wants.yaml
end

自定义格式需要在config/environment.rb中增加一行进行注册，比如pdf格式？

<!---->Mime::Type.register "application/pdf", :pdf

当然，你需要实现自己的to_pdf方法了

7.在rails1.2中使用AJAX与过去没有什么不同，仅仅是页面调用的URL全部改成新增加的那些Path helper

8.激动人心的ActiveResource，目前还未正式加入rails1.2，值的期待，简单来说就是就是通过这个库你将可以使用所有按照REST实现的web APIS，操作远程的资源将和操作本地的ActiveRecord一样。

《RESTful Rails Development》下载

dennis 2007-03-21 15:28 发表评论