method

assign_nested_attributes_for_collection_association

v2.3.2 - Show latest stable - 0 notes - Class: ActiveRecord::NestedAttributes

1.0.0
1.1.0
1.1.1
1.1.6
1.2.0
1.2.6
2.0.0
2.0.1
2.0.3
2.1.0
2.2.1
2.3.2 (0)
2.3.8 (2)
3.0.0 (-1)
3.0.5 (0)
3.0.7 (0)
3.0.9 (-38)
3.1.0 (0)
3.2.1 (0)
3.2.3 (0)
3.2.8 (0)
3.2.13 (0)
What's this?

assign_nested_attributes_for_collection_association(association_name, attributes_collection, allow_destroy) private

Assigns the given attributes to the collection association.

Hashes with an :id value matching an existing associated record will update that record. Hashes without an :id value will build a new record for the association. Hashes with a matching :id value and a :_delete key set to a truthy value will mark the matched record for destruction.

For example:

  assign_nested_attributes_for_collection_association(:people, {
    '1' => { :id => '1', :name => 'Peter' },
    '2' => { :name => 'John' },
    '3' => { :id => '2', :_delete => true }
  })

Will update the name of the Person with ID 1, build a new associated person with the name `John’, and mark the associatied Person with ID 2 for destruction.

Also accepts an Array of attribute hashes:

  assign_nested_attributes_for_collection_association(:people, [
    { :id => '1', :name => 'Peter' },
    { :name => 'John' },
    { :id => '2', :_delete => true }
  ])

Show source

# File activerecord/lib/active_record/nested_attributes.rb, line 284
    def assign_nested_attributes_for_collection_association(association_name, attributes_collection, allow_destroy)
      unless attributes_collection.is_a?(Hash) || attributes_collection.is_a?(Array)
        raise ArgumentError, "Hash or Array expected, got #{attributes_collection.class.name} (#{attributes_collection.inspect})"
      end

      if attributes_collection.is_a? Hash
        attributes_collection = attributes_collection.sort_by { |index, _| index.to_i }.map { |_, attributes| attributes }
      end

      attributes_collection.each do |attributes|
        attributes = attributes.stringify_keys

        if attributes['id'].blank?
          unless reject_new_record?(association_name, attributes)
            send(association_name).build(attributes.except(*UNASSIGNABLE_KEYS))
          end
        elsif existing_record = send(association_name).detect { |record| record.id.to_s == attributes['id'].to_s }
          assign_to_or_mark_for_destruction(existing_record, attributes, allow_destroy)
        end
      end
    end

assign_nested_attributes_for_collection_association

Related methods

Flowdock - Team Inbox With Chat