mongoid 3.1.6 → 4.0.0

data/lib/mongoid/persistence/modification.rb

@@ -1,35 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-
-    # Contains common logic for modification operations.
-    module Modification
-
-      # Wrap all the common modification logic for both root and embedded
-      # documents and then yield to the block.
-      #
-      # @example Execute common modification logic.
-      #   prepare do |doc|
-      #     collection.update({ :_id => 1 }, { :field => "value })
-      #   end
-      #
-      # @param [ Proc ] block The block to call.
-      #
-      # @return [ true, false ] If the save passed or not.
-      #
-      # @since 2.1.0
-      def prepare(&block)
-        return false if validating? && document.invalid?(:update)
-        document.process_flagged_destroys
-        result = document.run_callbacks(:save) do
-          document.run_callbacks(:update) do
-            yield(document); true
-          end
-        end
-        document.post_persist unless result == false
-        document.errors.clear unless validating?
-        result
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations/embedded/insert.rb

@@ -1,46 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-    module Operations
-      module Embedded
-
-        # Insert is a persistence command responsible for taking a document that
-        # has not been saved to the database and saving it. This specific class
-        # handles the case when the document is embedded in another.
-        #
-        # The underlying query resembles the following MongoDB query:
-        #
-        #   collection.update(
-        #     { "_id" : 1 },
-        #     { "$push" : { "field" : "value" } },
-        #     false
-        #   );
-        class Insert
-          include Insertion
-          include Operations
-          include Mongoid::Atomic::Positionable
-
-          # Insert the new document in the database. If the document's parent is a
-          # new record, we will call save on the parent, otherwise we will $push
-          # the document onto the parent.
-          #
-          # @example Insert an embedded document.
-          #   Insert.persist
-          #
-          # @return [ Document ] The document to be inserted.
-          def persist
-            prepare do
-              raise Errors::NoParent.new(document.class.name) unless parent
-              if parent.new_record?
-                parent.insert
-              else
-                selector = parent.atomic_selector
-                collection.find(selector).update(positionally(selector, inserts))
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations/embedded/remove.rb

@@ -1,43 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-    module Operations
-      module Embedded
-
-        # Remove is a persistence command responsible for deleting a document from
-        # the database.
-        #
-        # The underlying query resembles the following MongoDB query:
-        #
-        #   collection.remove(
-        #     { "_id" : 1 },
-        #     false
-        #   );
-        class Remove
-          include Deletion
-          include Operations
-          include Mongoid::Atomic::Positionable
-
-          # Remove the document from the database. If the parent is a new record,
-          # it will get removed in Ruby only. If the parent is not a new record
-          # then either an $unset or $set will occur, depending if it's an
-          # embeds_one or embeds_many.
-          #
-          # @example Remove an embedded document.
-          #   RemoveEmbedded.persist
-          #
-          # @return [ true ] Always true.
-          def persist
-            prepare do |doc|
-              parent.remove_child(doc) if notifying_parent?
-              if parent.persisted?
-                selector = parent.atomic_selector
-                collection.find(selector).update(positionally(selector, deletes))
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations/insert.rb

@@ -1,34 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-    module Operations
-
-      # Insert is a persistence command responsible for taking a document that
-      # has not been saved to the database and saving it.
-      #
-      # The underlying query resembles the following MongoDB query:
-      #
-      #   collection.insert(
-      #     { "_id" : 1, "field" : "value" },
-      #     false
-      #   );
-      class Insert
-        include Insertion, Operations
-
-        # Insert the new document in the database. This delegates to the standard
-        # MongoDB collection's insert command.
-        #
-        # @example Insert the document.
-        #   Insert.persist
-        #
-        # @return [ Document ] The document to be inserted.
-        def persist
-          prepare do |doc|
-            collection.insert(doc.as_document)
-            IdentityMap.set(doc)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations/remove.rb

@@ -1,33 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-    module Operations
-
-      # Remove is a persistence command responsible for deleting a document from
-      # the database.
-      #
-      # The underlying query resembles the following MongoDB query:
-      #
-      #   collection.remove(
-      #     { "_id" : 1 },
-      #     false
-      #   );
-      class Remove
-        include Deletion, Operations
-
-        # Remove the document from the database: delegates to the MongoDB
-        # collection remove method.
-        #
-        # @example Remove the document.
-        #   Remove.persist
-        #
-        # @return [ true ] Always true.
-        def persist
-          prepare do |doc|
-            collection.find(doc.atomic_selector).remove
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations/update.rb

@@ -1,59 +0,0 @@
-# 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

data/lib/mongoid/persistence/operations/upsert.rb

@@ -1,28 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-    module Operations
-
-      # Wraps behaviour for performing upserts in Mongodb. No matter if the
-      # document has been modified or not, it will be sent to the db and Mongo
-      # will determin whether or not to insert or update.
-      class Upsert
-        include Upsertion, Operations
-
-        # Persist the upsert operation.
-        #
-        # @example Execute the upsert.
-        #   operation.persist
-        #
-        # @return [ true ] Always true.
-        #
-        # @since 3.0.0
-        def persist
-          prepare do
-            collection.find(selector).update(document.as_document, [ :upsert ])
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/operations.rb

@@ -1,214 +0,0 @@
-# encoding: utf-8
-require "mongoid/persistence/operations/insert"
-require "mongoid/persistence/operations/remove"
-require "mongoid/persistence/operations/update"
-require "mongoid/persistence/operations/upsert"
-require "mongoid/persistence/operations/embedded/insert"
-require "mongoid/persistence/operations/embedded/remove"
-
-module Mongoid
-  module Persistence
-
-    # Persistence operations include this module to get basic functionality
-    # on initialization.
-    module Operations
-
-      attr_reader :conflicts, :document, :options
-
-      # Get the collection we should be persisting to.
-      #
-      # @example Get the collection.
-      #   operation.collection
-      #
-      # @return [ Collection ] The collection to persist to.
-      #
-      # @since 2.1.0
-      def collection
-        @collection ||= document._root.collection
-      end
-
-      # Get the atomic delete operations for embedded documents.
-      #
-      # @example Get the atomic deletes.
-      #   operation.deletes
-      #
-      # @return [ Hash ] The atomic delete selector.
-      #
-      # @since 2.1.0
-      def deletes
-        { document.atomic_delete_modifier =>
-          { document.atomic_path =>
-            document._index ? { "_id" => document.id } : true } }
-      end
-
-      # Instantiate the new persistence operation.
-      #
-      # @example Create the operation.
-      #   Operation.new(document, { :safe => true }, { "field" => "value" })
-      #
-      # @param [ Document ] document The document to persist.
-      # @param [ Hash ] options The persistence options.
-      #
-      # @since 2.1.0
-      def initialize(document, options = {})
-        @document, @options = document, options
-      end
-
-      # Get the atomic insert for embedded documents, either a push or set.
-      #
-      # @example Get the inserts.
-      #   operation.inserts
-      #
-      # @return [ Hash ] The insert ops.
-      #
-      # @since 2.1.0
-      def inserts
-        { document.atomic_insert_modifier =>
-          { document.atomic_position => document.as_document } }
-      end
-
-      # Should the parent document (in the case of embedded persistence) be
-      # notified of the child deletion. This is used when calling delete from
-      # the associations themselves.
-      #
-      # @example Should the parent be notified?
-      #   operation.notifying_parent?
-      #
-      # @return [ true, false ] If the parent should be notified.
-      #
-      # @since 2.1.0
-      def notifying_parent?
-        @notifying_parent ||= !@options.delete(:suppress)
-      end
-
-      # Get the parent of the provided document.
-      #
-      # @example Get the parent.
-      #   operation.parent
-      #
-      # @return [ Document ] The parent document.
-      #
-      # @since 2.1.0
-      def parent
-        document._parent
-      end
-
-      # Get the atomic selector for the document.
-      #
-      # @example Get the selector.
-      #   operation.selector.
-      #
-      # @return [ Hash ] The mongodb selector.
-      #
-      # @since 2.1.0
-      def selector
-        @selector ||= document.atomic_selector
-      end
-
-      # Get the atomic updates for the document without the conflicting
-      # modifications.
-      #
-      # @example Get the atomic updates.
-      #   operation.updates
-      #
-      # @return [ Hash ] The updates sans conflicting mods.
-      #
-      # @since 2.1.0
-      def updates
-        @updates ||= init_updates
-      end
-
-      # Should we be running validations on this persistence operation?
-      # Defaults to true.
-      #
-      # @example Run validations?
-      #   operation.validating?
-      #
-      # @return [ true, false ] If we run validations.
-      #
-      # @since 2.1.0
-      def validating?
-        @validating ||= @options[:validate].nil? ? true : @options[:validate]
-      end
-
-      private
-
-      # Initialize the atomic updates and conflicting modifications.
-      #
-      # @example Initialize the updates.
-      #   operation.init_updates
-      #
-      # @return [ Hash ] The atomic updates.
-      #
-      # @since 2.1.0
-      def init_updates
-        updates = document.atomic_updates
-        @conflicts = updates.delete(:conflicts) || {}
-        updates
-      end
-
-      class << self
-
-        # Get the appropriate removal operation based on the document.
-        #
-        # @example Get the deletion operation.
-        #   Operations.remove(doc, options)
-        #
-        # @param [ Document ] doc The document to persist.
-        # @param [ Hash ] options The persistence options.
-        #
-        # @return [ Operations ] The operation.
-        #
-        # @since 2.1.0
-        def remove(doc, options = {})
-          (doc.embedded? ? Embedded::Remove : Remove).new(doc, options)
-        end
-
-        # Get the appropriate insertion operation based on the document.
-        #
-        # @example Get the insertion operation.
-        #   Operations.insert(doc, options)
-        #
-        # @param [ Document ] doc The document to persist.
-        # @param [ Hash ] options The persistence options.
-        #
-        # @return [ Operations ] The operation.
-        #
-        # @since 2.1.0
-        def insert(doc, options = {})
-          (doc.embedded? ? Embedded::Insert : Insert).new(doc, options)
-        end
-
-        # Get the appropriate update operation based on the document.
-        #
-        # @example Get the update operation.
-        #   Operations.update(doc, options)
-        #
-        # @param [ Document ] doc The document to persist.
-        # @param [ Hash ] options The persistence options.
-        #
-        # @return [ Operations ] The operation.
-        #
-        # @since 2.1.0
-        def update(doc, options = {})
-          Update.new(doc, options)
-        end
-
-        # Get the appropriate upsert operation based on the document.
-        #
-        # @example Get the upsert operation.
-        #   Operations.upsert(doc, options)
-        #
-        # @param [ Document ] doc The document to persist.
-        # @param [ Hash ] options The persistence options.
-        #
-        # @return [ Operations ] The operation.
-        #
-        # @since 3.0.0
-        def upsert(doc, options = {})
-          Upsert.new(doc, options)
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/persistence/upsertion.rb

@@ -1,31 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Persistence
-
-    # Contains common logic for upsert operations.
-    module Upsertion
-
-      # Wrap all the common upsert logic for root docments.
-      #
-      # @example Execute common upsert logic.
-      #   prepare do |doc|
-      #     collection.find({ :_id => 1 }).upsert({ name: "test" }, [ :upsert ])
-      #   end
-      #
-      # @param [ Proc ] block The block to call.
-      #
-      # @return [ true, false ] If the save passed or not.
-      #
-      # @since 3.0.0
-      def prepare(&block)
-        return false if validating? && document.invalid?(:upsert)
-        result = document.run_callbacks(:upsert) do
-          yield(document); true
-        end
-        document.post_persist unless result == false
-        document.new_record = false
-        result
-      end
-    end
-  end
-end