在写网站的过程中,时常会用到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>