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 发表评论