homeASCIIcasts

165: 批量修改记录 

(view original Railscast)

Other translations: En

Other formats:

Written by darkbaby123 (darkbaby123.javaeye.com)

第52集 演示了如何编辑多条数据库记录的例子。那个示例程序允许你一次选中多个任务,然后每个被选中的任务(Task )都会被设置成“完成”。

这一集中我们将对这种想法进行扩展。但这次,我们可以让用户选择更新一批记录的多个属性,而不是上一集的单个属性。

网上商店应用程序

下面显示的就是我们要改造的应用程序。目前,如果我们要修改表格的最后两条记录,就要单独编辑它们。如果要修改的记录很少,这不成问题。但如果面对成堆的记录这就很乏味了。下面我们将修改这个程序,让它可以同时修改一批记录的多个属性。

修改index视图

我们将在每条产品之前加上一个checkbox,这样我们可以轻易地选择要修改的产品。但在此之前,我们先把显示所有产品的table标签用form包起来。目前我们在Controller层还没有一个用来编辑多个产品的action,所以先把url地址空着,以后再来填吧。

  <% form_tag ... do %>

我们没有为form指定提交方式,所以它默认是POST。虽然这个form将带我们到一个显示所有选中产品的新页面,我们似乎应该用GET,但因为我们要传递多个产品的id过去,这是GET做不到的。

在table的每一行中,我们要加入一个checkbox,它的值是对应的产品的 id (还要在table的标题部分加上一个空的<th> ,保证表格是对齐的)。

  <td><%= check_box_tag "product_ids[]", product.id %></td>
  

注意check_box_tag的name,它是以一个方括号结尾的,这是所有传上去的值将会被集合成一个数组。

最后我们在table下面加上提交按钮。

  <%= submit_tag "Edit Checked" %>
  

现在我们的index视图应该是这个样子:

  <h1>Products</h1>
  <% form_tag ... do %>
  <table>
    <thead>
      <tr>
        <th>Name</th>
        <th>Category</th>
        <th>Price</th>
      </tr>
    </thead>
    <tbody>
      <% for product in @products %>
        <tr>
          <td><%= check_box_tag "product_ids[]", product.id %></td>
          <td><%= product.name %></td>
          <td><%= product.category.name %></td>
          <td><%= number_to_currency product.price, :unit => "&pound;" %></td>
          <td><%= link_to "Edit", edit_product_path(product) %></td>
          <td><%= link_to "Destroy", product_path(product), :confirm => "Are you sure?", :method => :delete %></td>
        </tr>
      <% end %>
    </tbody>
  </table>
  <%= submit_tag "Edit Checked" %>
  <% end %>
  <%= link_to "New Product", new_product_path %>
  

修改products控制器

我们的products控制器包含了有用的RESTful action。现在我们要增加两个action来编辑和更新多条记录。

  def edit_multiple
  end

  def update_multiple
  end
  

这两个action的用处和标准的 editupdate 差不多,但它们用来处理多条记录的编辑和更新。其中 edit_multiple 方法需要对应的视图,我们过一会儿再写它。

在我们的程序中,Products 是一个RESTful资源,所以我们必须修改routes文件使这两个新action可以访问。因为我们要对products集合添加方法,所以我们用 :collection 参数添加这两个方法。

  map.resources :products, :collection => { :edit_multiple => :post, :update_multiple => :put }
  

:collection 参数需要一个hash,其中hash的键代表action的名字,值代表这个action的html method。如同上文提到的,我们采用POST作为 edit_multiple 的method,虽然理想情况下我们应该用GET。

现在我们的action定义好了,我们可以回到index视图,给 form_tag 填上正确的url地址

  <% form_tag edit_multiple_products_path do %>
  

现在我们刷新index页面,就可以看到每个产品前面的checkbox,下面的“Edit Checked”按钮会带我们到edit_multiple页面。

新的form

如果我们选中一些产品,然后点击下面的"Edit Checked"按钮,会看到一个missing template错误。这是因为我们还没有创建视图代码,所以下一步工作就是完成它。我们将把视图代码写在 /app/views/products/edit_multiple.html.erb 文件中。但在此之前,我们先看看点击按钮后,development日志中生成的信息。

    Processing ProductsController#edit_multiple (for 127.0.0.1 at 2009-06-06 19:24:37) [POST]
    Parameters: {"product_ids"=>["3", "4", "5"], "commit"=>"Edit Checked", "authenticity_token"=>"s5z3KEJpBM7zC2JooC/relZ2oZtVpfxL/IMklpcBuYU="}
  

在Parameters部分,我们可以看到我们选中的产品的id以数组的形式组织着。在控制器中,我们将用这些参数找到之前选中的产品。

  def edit_multiple
    @products = Product.find(params[:product_ids])
  end
  

现在转到我们的edit_multiple视图。在我们之前的程序中,我们已经有了一个放在partial中的form,它用在新建和编辑产品的页面。看起来似乎我们可以直接把这个form拿过来用。但因为它做一些修改来适应批量记录,所以我们干脆建立一个新的form。

在视图的开头我们先定义一个没有关闭block的 form_for (译者注:原文写的form_tag,但实际代码是form_for,所以翻译时改了一下)。因为这个form是用来更新多个产品的,我们为它的第一个参数指定一个symbol而不是实际的Product对象。我们还要为它指定 :url:method (注意是PUT,所以要单独指定)。

  <% form_for :product, :url => update_multiple_products_path, :html => { :method => :put } do |form| %>
  

在form中我们需要设定所有选中的产品的 id s,否则form提交时,我们不知道哪些产品会被更新。我们可以用一系列的hidden_field_tag来存放产品的 id s,同时我们做一个列表来显示这些待更新的产品。

  <ul>
    <% for product in @products %>
      <li>
        <%= h product.name %>
        <%= hidden_field_tag "product_ids[]", product.id%>
      </li>
    <% end %>
  </ul>
  

下一步,我们将为form添加表单元素来表示 Product 的属性。这些属性包括产品名称、分类名称、价格、和是否停售的信息。当我们提交这个form时,我们只希望更新那些填写了具体值的属性。所以对那些有一系列选择的下拉框,我们要加一个空选项,这样用户就可以选择“空”来跳过这些属性的修改。

  <ol class="formList">
    <li>
      <%= form.label :category_id %>
      <%= form.collection_select :category_id, Category.all, :id, :name, :include_blank => true %>
    </li>
    <li>
      <%= form.label :name %>
      <%= form.text_field :name %>
    </li>
    <li>
      <%= form.label :price %>
      <%= form.text_field :price %>
    </li>
    <li>
      <%= form.label :discontinued %>
      <%= form.select :discontinued, [["Yes", true], ["No", false]], :include_blank => true %>
    </li>
    <li>
      <%= form.submit "Submit" %>
    </li>
  </ol>
  

最后,我们关闭 form_for 的block,我们的form也完成了。

  <% end %>
  

现在如果我们刷新页面,我们会看到我们选中的产品的列表,还有下面用来修改产品信息的form。注意所有的下拉框都已经被设置成了空值,这样我们就不会去修改它们的在数据库中的值。

编写用于更新的action

现在我们已经几近完成了,但我们还要为 update_multiple 方法编写代码,当上图的form提交时,更新所有被选中的产品。

  def update_multiple
    @products = Product.find(params[:product_ids])
    @products.each do |product|
      product.update_attributes!(params[:product].reject { |k,v| v.blank? })
    end
    flash[:notice] = "Updated products!"
    redirect_to products_path
  end
  

update_multiple 的开始,我们用产品的 id s 数组(从form的隐藏字段中传上来的)获取了被选中的产品,然后我们遍历每个产品并进行更新。因为我们只要更新不为空的属性,所以我们用 reject 遍历每一个参数,去掉了值为空的属性。注意我们用的是带感叹号(!)的 update_attributes! 方法,因为我们没有对模型做任何校验。如果这个程序是一个实际产品,我们会去做校验,但这超出了这一集讨论的范围。使用 update_attributes! 表示如果有些数据不正确,程序将会抛出异常。一旦所有的产品都更新完成,我们设置一个flash信息然后跳转回到产品列表页面。

让我们看看它是否能正常工作。我们有两个产品,Video Game Console和Video Game Disc,被放在Toys & Games分类下。现在我们要把分类改成Electronics。如果我们选中这两个产品并点击“Edit Checked”按钮(译者注:原文是“Submit”按钮,但实际页面上是"Edit Checked")。我们将会看到它们被列在edit_multiple页面上。

如果我们选择从category下拉框中选择“Electronics”然后点击“Submit”按钮,我们会回到产品列表页面。

可以看到,这两个产品的分类已经改成了“Electronics”,但其他的属性都没有变化。

更进一步

目前我们已经提供了一种很有效的方式去同时修改多个模型对象。但在这一集的结尾,我们将更进一步,让价格可以按相对的数值来改变。比如,这样我们就可以让所有家具的价格降低20%。我们现在可以选中多个产品,但如果我们改变form中的价格,那么所有的产品都会变成一样的价格。如果我们利用虚拟属性,更改相对价格的逻辑就变得非常直观。虚拟属性在第16集中有介绍,如果想了解它们,你可以去 看看视频读读文章

我们将在 Product 模型中创建一个虚拟属性price_modification 。我们会修改 edit_multiple 视图中的form这样它会修改我们的新属性而不是直接修改 price 属性。

  <li>
    <%= form.label :price_modification %>
    <%= form.text_field :price_modification %>
  </li>
  

现在我们要在 Product 模型中设定新属性的getter和setter。

  class Product < ActiveRecord::Base
    belongs_to :category

    def price_modification
      price
    end

    def price_modification=(new_price)
      if new_price.ends_with? "%"
        self.price += (price * (new_price.to_f / 100)).round(2)
      else
        self.price = new_price
      end
    end
  end
  

getter方法很直观:我们只需要返回price就行,但setter方法稍微复杂一点。如果输入的值(new_value)以百分号结束,我们将把值转换成浮点数(new_price.to_f ),除以100然后乘以原始的价格,来求出价格改变的具体数值。然后把它和原始价格相加。如果那个具体数值是负数,价格就会降低。最后,我们用ActiveSupport扩展的 round 方法让新的价格保留小数点后两位。

现在,让我们开始贱卖家具。我们选中两个家具产品然后修改他们。

然后在“Price modification”一栏中,填写“-20%”。

当我们提交form并返回产品列表,我们可以看到选中的那些产品都降价了20%。

这一集中讲的技术非常有用,并且可以应用在一系列的场景中。经过这次实验,你应该可以发现在你的Rails应用的很多地方,能相对地修改属性都是非常有用的。