Method: Mongoid::Persistable::Creatable#insert

Defined in:
lib/mongoid/persistable/creatable.rb

#insert(options = {}) ⇒ Document

Insert a new document into the database. Will return the document itself whether or not the save was successful.

Examples:

Insert a document.

document.insert

Parameters:

  • options (Hash) (defaults to: {}) —

    Options to pass to insert.

Returns:

  • (Document) —

    The persisted document.



20
21
22
23
24
25
26
27
28
 
# File 'lib/mongoid/persistable/creatable.rb', line 20

def insert(options = {})
  prepare_insert(options) do
    if embedded?
      insert_as_embedded
    else
      insert_as_root
    end
  end
end