Module: Mongoid::Association::Embedded::EmbedsMany::Buildable

Includes:
Threaded::Lifecycle
Included in:
Mongoid::Association::Embedded::EmbedsMany
Defined in:
build/mongoid-8.1/lib/mongoid/association/embedded/embeds_many/buildable.rb

Overview

Builder class for embeds_many associations.

Instance Method Summary collapse

Instance Method Details

#build(base, object, type = nil, selected_fields = nil) ⇒ Array<Document ] The documents.

Builds the document out of the attributes using the provided association metadata. Instantiates through the factory in order to make sure subclasses and allocation are used if fitting. This case will return many documents.

Examples:

Build the documents.

Builder.new(meta, attrs).build

Parameters:

  • base (Document)

    The base object.

  • object (Array<Document> | Array<Hash>)

    The object to use to build the association.

  • type (String) (defaults to: nil)

    Not used in this context.

  • selected_fields (Hash) (defaults to: nil)

    Fields which were retrieved via #only. If selected_fields are specified, fields not listed in it will not be accessible in the built documents.

Returns:

  • (Array<Document ] The documents.)

    Array<Document ] The documents.



29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'build/mongoid-8.1/lib/mongoid/association/embedded/embeds_many/buildable.rb', line 29

def build(base, object, type = nil, selected_fields = nil)
  return [] if object.blank?
  return object if object.first.is_a?(Document)
  docs = []
  object.each do |attrs|
    if _loading? && base.persisted?
      docs.push(Factory.execute_from_db(klass, attrs, nil, selected_fields, execute_callbacks: false))
    else
      docs.push(Factory.build(klass, attrs))
    end
  end
  docs
end