How rails nested model form works(上)

在写网站的过程中，时常会用到nested model form。而由于nested model form牵扯的东西比较多，理解起来并不容易。我打算从最简单的form讲起，介绍一下nested model form是如何工作的，以及一些常见的问题。

通过form更新实例的流程大体是这样的，我们使用FormHelper来构建form，Rails会将form内的数据以'hash'的形式放入parmas；参数(params)被permit后，通过方法调用的方式，赋值给某个实例。

我将从后向前解释这个流程

赋值 -- assign_attribute

params被permit后，我们一般会调用assign_attribute，对实例进行赋值。
而assign_attributes最终调用了_assign_attribute,

只考虑最简单的情况的话，_assign_attribute的代码将会是这样的：

def _assign_attribute(k, v)
  public_send("#{k}=", v)
end

可以被这样调用_assign_attribute(:name, "2dian718")

这个方法是通过k(key)找到对应的setter方法，并传入v(value)。

permit

assign_attributes内调用了sanitize_for_mass_assignment（给大量赋值消消毒），其作用是检查传入的参数是否有被permit。
如果没有，则抛出异常ActiveModel::ForbiddenAttributesError。

ActionController::Parameters在初始化的时候，params的@permitted被设置为false。所以我们想用params进行赋值的时候，必须先要对参数进行permit。

我们可以用ActionController::Parameters.permit_all_parameters = true来改变这个默认行为。

form_for

<%= form_for(@company) do |f| %>
  <%= f.text_field :name %>
  <%= f.submit %>
<% end %>

将会生成

<form class="new_company" id="new_company" action="/companies" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓"><input type="hidden" name="authenticity_token" value="NeSXiKXJcMAyFcGQWfTDGE/7q21QWGjQoYN7IABUIFlnFkAtHFiv9PAjDaUOB0lu0pq7pDRj0JHsz+0jLJGDdw==">
  <input type="text" name="company[name]" id="company_name">
  <input type="submit" name="commit" value="Create Company">
</form>

我们看到 <%= f.text_field :name %>被解释成了<input type="text" name="company[name]" id="company_name">

关于f -- form builder

请注意，form_for的do后面跟了一个f
关于这个 f , rails的文档里是这样解释的，form_for会吐出来（yield）一个form builder的对象(就是那个f)，他既了解form，也了解model（会在下文进行详细介绍）。

我们也可以定制一个form builder，比如说给input自动加上标签，代码如下。

class LabellingFormBuilder < ActionView::Helpers::FormBuilder
  (field_helpers - [:label, :check_box, :radio_button, :fields_for, :hidden_field, :file_field]).each do |selector|
    class_eval <<-RUBY_EVAL, __FILE__, __LINE__ + 1
          def #{selector}(method, options = {})  # def text_field(method, options = {})
            @template.send("label", @object_name, method) +
             @template.send( #{selector.inspect}, @object_name, method, objectify_options(options))
          end
        RUBY_EVAL
  end
end

我们可以这样用

<%= form_for(@company, builder: LabellingFormBuilder) do |f| %>
  <%= f.text_field :name %>
  <%= f.submit %>
<% end %>

将会生成

<form class="new_company" id="new_company" action="/companies" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓"><input type="hidden" name="authenticity_token" value="EeUl+Px6CvNhgs1nNucJfFiIYEc2zbsNDLzTwfxXcVxDF/JdRevVx6O0AVJhFIMKxelwjlL2A0xB8EXC0JLScg==">
  <label for="company_name">Name</label><input type="text" name="company[name]" id="company_name">
  <input type="submit" name="commit" value="Create Company">
</form>