Rails源代码分析（46）：ActionView::Partials

这个module，主要是为了支持，render的:partial属性

if partial = options[:partial] partial = default_template_name if partial == true add_variables_to_assigns if collection = options[:collection] render_for_text( @template.send!(:render_partial_collection, partial, collection, options[:spacer_template], options[:locals]), options[:status] ) else render_for_text( @template.send!(:render_partial, partial, ActionView::Base::ObjectWrapper.new(options[:object]), options[:locals]), options[:status] ) end 

如果有:collection那么调用render_partial_collection

如果没有那么调用render_partial

 

方法实现如下：

render_partial

def render_partial(partial_path, object_assigns = nil, local_assigns = {}) #:nodoc: case partial_path when String, Symbol, NilClass # Render the template ActionView::PartialTemplate.new(self, partial_path, object_assigns, local_assigns).render_template when ActionView::Helpers::FormBuilder builder_partial_path = partial_path.class.to_s.demodulize.underscore.sub(/_builder$/, '') render_partial(builder_partial_path, object_assigns, (local_assigns || {}).merge(builder_partial_path.to_sym => partial_path)) when Array, ActiveRecord::Associations::AssociationCollection, ActiveRecord::NamedScope::Scope if partial_path.any? collection = partial_path render_partial_collection(nil, collection, nil, local_assigns) else "" end else render_partial(ActionController::RecordIdentifier.partial_path(partial_path, controller.class.controller_path), partial_path, local_assigns) end end 

分情况处理：

1 如果是String Symbol NilClass => 调用PartialTemplate处理

2 如果是ForumBuilder => 那么先创建路径，然后再调此方法

3 如果是Array之类的数组，那么调用render_partial_collection

4 否则统一用ActionController::RecordIdentifier.partial_path来处理路径

render_partial_collection

def render_partial_collection(partial_path, collection, partial_spacer_template = nil, local_assigns = {}) #:nodoc: return " " if collection.empty? local_assigns = local_assigns ? local_assigns.clone : {} spacer = partial_spacer_template ? render(:partial => partial_spacer_template) : '' if partial_path.nil? render_partial_collection_with_unknown_partial_path(collection, local_assigns) else render_partial_collection_with_known_partial_path(collection, partial_path, local_assigns) end.join(spacer) end

显式制定路径的情况下调用render_partial_collection_with_known_partial_path方法

否则调用render_partial_collection_with_unknown_partial_path

render_partial_collection_with_known_partial_path

def render_partial_collection_with_known_partial_path(collection, partial_path, local_assigns) template = ActionView::PartialTemplate.new(self, partial_path, nil, local_assigns) collection.map do |element| template.render_member(element) end end 

render_partial_collection_with_unknown_partial_path

def render_partial_collection_with_unknown_partial_path(collection, local_assigns) templates = Hash.new i = 0 collection.map do |element| partial_path = ActionController::RecordIdentifier.partial_path(element, controller.class.controller_path) template = templates[partial_path] ||= ActionView::PartialTemplate.new(self, partial_path, nil, local_assigns) template.counter = i i += 1 template.render_member(element) end end