Rails: 用Resource_controller插件给Controllers减肥

作者 Rick DeNatale 译者 贾晓楠 发布于 2008年2月4日

领域

架构 & 设计,

企业架构,

语言 & 开发

主题

REST ,

Ruby on Rails ,

Ruby

标签

Rails插件 ,

Ruby on Rails ,

Rails

许多Rails大师提倡的一个导向原则是“丰满的模型，精瘦的控制器”。 Rails控制器只应该包含一些在模型和视图之间周转用的代码。事务逻辑属于模型，而不属于控制器或视图。在如今支持REST的Rails 2.0中，控制器变得非常相象，都包括七个基本的动作（索引、获取、创建、更新、删除、新增和编辑），且具有非常相似的实现方式。在Rails 2.0中，可以简单地用script/generate scaffold standard来建立控制器框架，即生成了一段具有REST特性的控制器代码，如下所示： 

class StandardsController < ApplicationController
  # GET /standards
  # GET /standards.xml
  def index
    @standards = Standard.find(:all)

    respond_to do |format|
      format.html # index.html.erb
      format.xml  { render :xml => @standards }
    end
  end

  # GET /standards/1
  # GET /standards/1.xml
  def show
    @standard = Standard.find(params[:id])

    respond_to do |format|
      format.html # show.html.erb
      format.xml  { render :xml => @standard }
    end
  end

  # GET /standards/new
  # GET /standards/new.xml
  def new
    @standard = Standard.new

    respond_to do |format|
      format.html # new.html.erb
      format.xml  { render :xml => @standard }
    end
  end

  # GET /standards/1/edit
  def edit
    @standard = Standard.find(params[:id])
  end

  # POST /standards
  # POST /standards.xml
  def create
    @standard = Standard.new(params[:standard])

    respond_to do |format|
      if @standard.save
        flash[:notice] = 'Standard was successfully created.'
        format.html { redirect_to(@standard) }
        format.xml  { render :xml => @standard, :status => :created, :location => @standard }
      else
        format.html { render :action => "new" }
        format.xml  { render :xml => @standard.errors, :status => :unprocessable_entity }
      end
    end
  end

  # PUT /standards/1
  # PUT /standards/1.xml
  def update
    @standard = Standard.find(params[:id])

    respond_to do |format|
      if @standard.update_attributes(params[:standard])
        flash[:notice] = 'Standard was successfully updated.'
        format.html { redirect_to(@standard) }
        format.xml  { head :ok }
      else
        format.html { render :action => "edit" }
        format.xml  { render :xml => @standard.errors, :status => :unprocessable_entity }
      end
    end
  end

  # DELETE /standards/1
  # DELETE /standards/1.xml
  def destroy
    @standard = Standard.find(params[:id])
    @standard.destroy

    respond_to do |format|
      format.html { redirect_to(standards_url) }
      format.xml  { head :ok }
    end
  end
end

除了特别的名字以外，所有自动生成的控制器代码都是这样的。

使用自动生成的控制器非常简单。在许多情况下，很少或者不需要对生成的代码做任何改变，尤其是当你把“精瘦的控制器”这个理念铭记于心时。

另一方面，Ruby/Rails还有一条理念，就是 “不要重复自己（DRY）”。 如果存在几乎重复的代码，即便不是你自己写的，也是违背DRY原则的。

输入：resource_controller。James Golick贡献了一个新的rails插件，称为resource_controller，它可以实现与上面同样的控制器，代码如下：

class StandardsController < ApplicationController
resource_controller
end

然而，这里仍有一个小小的瑕疵。 它没有提供标准的xml响应能力，但可以用一小段代码来实现：

class StandardsController < ApplicationController
  resource_controller

  index.wants.xml   { render :xml => @standards }
  [new, show].each  do |action|
     action.wants.xml   { render :xml => @standard })
  end
  create.wants.xml  { render :xml => @standard, :status => :created, :location => @standard }
  [update, destroy].each do |action|
     action.wants.xml  { head :ok }
  end
  [create_fails, update_fails].each do |action|
     action.wants.xml { render :xml => @standard.errors, :status => :unprocessable_entity }
  end
end

有了这个插件，写控制器代码如同写模型代码一样，只需加上像resource_controller这样的声明的类方法，以及action.wants之类的“回调”。这个插件自动为控制器的每个方法分配实例变量。在上面的代码中，给index方法分配了@standards ，给其他方法分配了@standard。

Rails有一些公用的模式强迫改变控制器代码。其中包括嵌套资源。很容易在config/routes.rb中设置路由：

map.resources :organization, :has_many => :standards

但是，一旦你这样做了，你就需要更改控制器来获取和使用上层资源，并在每个动作中正确使用。resource_controller插件简化了这些。在如上面那样更改路由后，你只需添加一个声明来调用我们的控制器：

class StandardsController < ApplicationController
resource_controller
belongs_to :organization
end

belongs_to声明允许嵌套资源使用控制器。现在，当一个控制器动作通过嵌套资源URL被访问时，例如/organization/1234 /standards，控制器会自动创建一个名为@organization的实例变量，适当地设置好，并使用standards所关联地父对象来查找和 建立Standard模型的实例。

注意， 同样的控制器也工作在非嵌套的URL下，因此我们可以在routes.rb中做另一个映射，来允许在organization之外访问starnards:

map.resources :standard
map.resources :organization, :has_many :standards

这样resource控制器就会自动地工作在这两种上下文中了。

这个插件也处理命名空间控制器、多态嵌套资源（与ActiveRecord多态关联相似和相关）和其他一些奇妙地东西。你也可以获得URL以及工作在请求的URL上下文中的路径辅助函数。

看来Resource_controller是个有用的插件，毫无疑问随着它的成熟，会变得越来越好。细节见James Golicks的博客。另外还有Fabio Akita制作的一段屏幕录像，演示了这个插件的实际使用情况。

查看英文原文：Rails: Resource_controller Plugin Puts Controllers on a Diet

• 更早的 >