module Mongoid::Factory

Instantiates documents that came from the database.

Public Instance Methods

build(klass, attributes = nil, options = {}) 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, options = {})
  type = (attributes || {})["_type"]
  if type && klass._types.include?(type)
    type.constantize.new(attributes, options)
  else
    klass.new(attributes, options)
  end
end
from_db(klass, attributes = nil, criteria_instance_id = 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.

@return [ Document ] The instantiated document.

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