Class: Mongoid::Association::Eager

Inherits:

Object

• Object
• Mongoid::Association::Eager

Defined in:

lib/mongoid/association/eager.rb

Overview

Base class for eager load preload functions.

Direct Known Subclasses

Mongoid::Association::Embedded::Eager, Referenced::BelongsTo::Eager, Referenced::HasAndBelongsToMany::Eager, Referenced::HasMany::Eager, Referenced::HasOne::Eager

Instance Method Summary

• #initialize(associations, docs) ⇒ Base constructor

  Instantiate the eager load class.

• #run ⇒ Array

  Run the preloader.

Constructor Details

#initialize(associations, docs) ⇒ Base

Instantiate the eager load class.

Examples:

Create the new belongs to eager load preloader.

BelongsTo.new(association, parent_docs)

Parameters:

• associations (Array<Mongoid::Association::Relatable>) —

  Associations to eager load

• docs (Array<Document>) —

  Documents to preload the associations

# File 'lib/mongoid/association/eager.rb', line 19

def initialize(associations, docs)
  @associations = associations
  @docs = docs
  @grouped_docs = {}
end

Instance Method Details

#run ⇒ Array

Run the preloader.

Examples:

Preload the associations into the documents.

loader.run

Returns:

• (Array) —

  The list of documents given.

# File 'lib/mongoid/association/eager.rb', line 31

def run
  @loaded = []
  while shift_association
    preload
    @loaded << @docs.collect { |d| d.send(@association.name) if d.respond_to?(@association.name) }
  end
  @loaded.flatten
end