module Mongoid::Factory

Instantiates documents that came from the database.

Public Instance Methods

build(klass, attributes = nil) click to toggle source

Builds a new Document from the supplied attributes.

@example Build the document.

Mongoid::Factory.build(Person, { "name" => "Durran" })

@param [ Class ] klass The class to instantiate from if _type is not present. @param [ Hash ] attributes The document attributes. @param [ Hash ] options The mass assignment scoping options.

@return [ Document ] The instantiated document.

# File lib/mongoid/factory.rb, line 17
def build(klass, attributes = nil)
  type = (attributes || {})["_type"]
  if type && klass._types.include?(type)
    type.constantize.new(attributes)
  else
    klass.new(attributes)
  end
end
from_db(klass, attributes = nil, selected_fields = nil) click to toggle source

Builds a new Document from the supplied attributes loaded from the database.

@example Build the document.

Mongoid::Factory.from_db(Person, { "name" => "Durran" })

@param [ Class ] klass The class to instantiate from if _type is not present. @param [ Hash ] attributes The document attributes. @param [ Array ] selected_fields If instantiated from a criteria using

#only we give the document a list of the selected fields.

@return [ Document ] The instantiated document.

# File lib/mongoid/factory.rb, line 38
def from_db(klass, attributes = nil, selected_fields = nil)
  type = (attributes || {})["_type"]
  if type.blank?
    klass.instantiate(attributes, selected_fields)
  else
    type.camelize.constantize.instantiate(attributes, selected_fields)
  end
end