Module: Mongoid::Copyable

Extended by:
ActiveSupport::Concern
Included in:
Composable
Defined in:
lib/mongoid/copyable.rb

Overview

This module contains the behaviour of Mongoid's clone/dup of documents.

Instance Method Summary collapse

Instance Method Details

#cloneDocument Also known as: dup

Clone or dup the current Document. This will return all attributes with the exception of the document's id, and will reset all the instance variables.

This clone also includes embedded documents.

Examples:

Clone the document.

document.clone

Parameters:

  • other (Document)

    The document getting cloned.

Returns:


20
21
22
23
24
25
26
27
28
29
30
31
# File 'lib/mongoid/copyable.rb', line 20

def clone
  # @note This next line is here to address #2704, even though having an
  # _id and id field in the document would cause problems with Mongoid
  # elsewhere.
  attrs = clone_document.except("_id", "id")
  begin
    self.class.new(attrs)
  rescue Errors::UnknownAttribute
    self.class.send(:include, Attributes::Dynamic)
    self.class.new(attrs)
  end
end