Sha256: 8edaa6953d39bf6dd827134e5b1b8365094962f244ba84a779d35bff15174386

Contents?: true

Size: 1.87 KB

Versions: 8

Compression:

Stored size: 1.87 KB

Contents

# encoding: utf-8
module Mongoid
  module Persistence
    module Operations

      # Update is a persistence command responsible for taking a document that
      # has already been saved to the database and saving it, depending on
      # whether or not the document has been modified.
      #
      # Before persisting the command will check via dirty attributes if the
      # document has changed, if not, it will simply return true. If it has it
      # will go through the validation steps, run callbacks, and set the changed
      # fields atomically on the document. The underlying query resembles the
      # following MongoDB query:
      #
      #   collection.update(
      #     { "_id" : 1,
      #     { "$set" : { "field" : "value" },
      #     false,
      #     false
      #   );
      #
      # For embedded documents it will use the positional locator:
      #
      #   collection.update(
      #     { "_id" : 1, "addresses._id" : 2 },
      #     { "$set" : { "addresses.$.field" : "value" },
      #     false,
      #     false
      #   );
      #
      class Update
        include Modification
        include Operations
        include Mongoid::Atomic::Positionable

        # Persist the document that is to be updated to the database. This will
        # only write changed fields via MongoDB's $set modifier operation.
        #
        # @example Update the document.
        #   Update.persist
        #
        # @return [ true, false ] If the save passed.
        def persist
          prepare do
            unless updates.empty?
              collection.find(selector).update(positionally(selector, updates))
              conflicts.each_pair do |key, value|
                collection.find(selector).update(
                  positionally(selector, { key => value })
                )
              end
            end
          end
        end
      end
    end
  end
end

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
mongoid-3.1.7 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.6 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.5 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.4 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.3 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.2 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.1 lib/mongoid/persistence/operations/update.rb
mongoid-3.1.0 lib/mongoid/persistence/operations/update.rb