123456789_123456789_123456789_123456789_123456789_

Module: Mongoid::Persistable::Creatable::ClassMethods

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Extended In:
::Mongoid::Composable, ::Mongoid::Document, ::Mongoid::Persistable
Defined in: lib/mongoid/persistable/creatable.rb

Instance Method Summary

Instance Method Details

#create(attributes = nil, &block) ⇒ Document | Array<Document>

Create a new document. This will instantiate a new document and insert it in a single call. Will always return the document whether save passed or not.

Examples:

Create a new document.

Person.create(:title => "Mr")

Create multiple new documents.

Person.create({ title: "Mr" }, { title: "Mrs" })

Parameters:

  • attributes (Hash | Array) (defaults to: nil) —

    The attributes to create with, or an ::Array of multiple attributes for multiple documents.

Returns:

[ GitHub ] 

  


# File 'lib/mongoid/persistable/creatable.rb', line 145



def create(attributes = nil, &block)
  _creating do
    if attributes.is_a?(::Array)
      attributes.map { |attrs| create(attrs, &block) }
    else
      doc = new(attributes, &block)
      doc.save
      doc
    end
  end
end


  








  

    #create!(attributes = nil, &block)  ⇒ Document | Array<Document> 
  



  

    

Create a new document. This will instantiate a new document and insert it in a single call. Will always return the document whether save passed or not, and if validation fails an error will be raise.


  





    

    
Examples:

        


Create a new document.



      
Person.create!(:title => "Mr")

        


Create multiple new documents.



      
Person.create!({ title: "Mr" }, { title: "Mrs" })

  


Parameters:


    
  
  • 
    attributes
    (Hash | Array)
    (defaults to: nil)
—    
    

    The attributes to create with, or an ::Array of multiple attributes for multiple documents.
    

    
  
    • 



Returns:





  [ GitHub ]


  

  


# File 'lib/mongoid/persistable/creatable.rb', line 172



def create!(attributes = nil, &block)
  _creating do
    if attributes.is_a?(::Array)
      attributes.map { |attrs| create!(attrs, &block) }
    else
      doc = new(attributes, &block)
      doc.fail_due_to_validation! unless doc.insert.errors.empty?
      doc.fail_due_to_callback!(:create!) if doc.new_record?
      doc
    end
  end
end