mongoid 2.4.10 → 3.0.0

data/lib/mongoid/relations/referenced/many_to_many.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
-module Mongoid # :nodoc:
-  module Relations #:nodoc:
-    module Referenced #:nodoc:
+module Mongoid
+  module Relations
+    module Referenced
 
       # This class defines the behaviour for all relations that are a
       # many-to-many between documents in different collections.
@@ -25,29 +25,52 @@ module Mongoid # :nodoc:
         #
         # @since 2.0.0.beta.1
         def <<(*args)
-          batched do
-            [].tap do |ids|
-              args.flatten.each do |doc|
-                next unless doc
-                append(doc)
-                if persistable? || _creating?
-                  ids.push(doc.id)
-                  doc.save
-                else
-                  base.send(metadata.foreign_key).push(doc.id)
-                  base.synced[metadata.foreign_key] = false
-                end
-              end
-              if persistable? || _creating?
-                base.push_all(metadata.foreign_key, ids)
-                base.synced[metadata.foreign_key] = false
-              end
+          docs = args.flatten
+          return concat(docs) if docs.size > 1
+          if doc = docs.first
+            append(doc)
+            base.add_to_set(foreign_key, doc.id)
+            if persistable? || _creating?
+              doc.save
             end
           end
+          unsynced(base, foreign_key) and self
         end
-        alias :concat :<<
         alias :push :<<
 
+        # Appends an array of documents to the relation. Performs a batch
+        # insert of the documents instead of persisting one at a time.
+        #
+        # @example Concat with other documents.
+        #   person.posts.concat([ post_one, post_two ])
+        #
+        # @param [ Array<Document> ] documents The docs to add.
+        #
+        # @return [ Array<Document> ] The documents.
+        #
+        # @since 2.4.0
+        def concat(documents)
+          ids, docs, inserts = {}, [], []
+          documents.each do |doc|
+            next unless doc
+            append(doc)
+            if persistable? || _creating?
+              ids[doc.id] = true
+              save_or_delay(doc, docs, inserts)
+            else
+              existing = base.send(foreign_key)
+              unless existing.include?(doc.id)
+                existing.push(doc.id) and unsynced(base, foreign_key)
+              end
+            end
+          end
+          if persistable? || _creating?
+            base.push_all(foreign_key, ids.keys)
+          end
+          persist_delayed(docs, inserts)
+          self
+        end
+
         # Build a new document from the attributes and append it to this
         # relation without saving.
         #
@@ -72,13 +95,13 @@ module Mongoid # :nodoc:
             options, type = {}, options
           end
 
-          Factory.build(type || klass, attributes, options).tap do |doc|
-            base.send(metadata.foreign_key).push(doc.id)
-            append(doc)
-            doc.apply_proc_defaults
-            doc.synced[metadata.inverse_foreign_key] = false
-            yield(doc) if block_given?
-          end
+          doc = Factory.build(type || klass, attributes, options)
+          base.send(foreign_key).push(doc.id)
+          append(doc)
+          doc.apply_post_processed_defaults
+          unsynced(doc, inverse_foreign_key)
+          yield(doc) if block_given?
+          doc
         end
         alias :new :build
 
@@ -95,12 +118,12 @@ module Mongoid # :nodoc:
         #
         # @since 2.1.0
         def delete(document)
-          super.tap do |doc|
-            if doc && persistable?
-              base.pull(metadata.foreign_key, doc.id)
-              base.synced[metadata.foreign_key] = false
-            end
+          doc = super
+          if doc && persistable?
+            base.pull(foreign_key, doc.id)
+            unsynced(base, foreign_key)
           end
+          doc
         end
 
         # Removes all associations between the base document and the target
@@ -113,12 +136,12 @@ module Mongoid # :nodoc:
         # @since 2.0.0.rc.1
         def nullify
           unless metadata.forced_nil_inverse?
-            criteria.pull(metadata.inverse_foreign_key, base.id)
+            criteria.pull(inverse_foreign_key, base.id)
           end
           if persistable?
             base.set(
-              metadata.foreign_key,
-              base.send(metadata.foreign_key).clear
+              foreign_key,
+              base.send(foreign_key).clear
             )
           end
           target.clear do |doc|
@@ -142,10 +165,9 @@ module Mongoid # :nodoc:
         #
         # @since 2.0.0.rc.1
         def substitute(replacement)
-          tap do |proxy|
-            proxy.purge
-            proxy.push(replacement.compact.uniq) unless replacement.blank?
-          end
+          purge
+          push(replacement.compact.uniq) unless replacement.blank?
+          self
         end
 
         # Get a criteria for the documents without the default scoping
@@ -158,7 +180,7 @@ module Mongoid # :nodoc:
         #
         # @since 2.4.0
         def unscoped
-          klass.unscoped.any_in(:_id => base.send(metadata.foreign_key))
+          klass.unscoped.any_in(_id: base.send(foreign_key))
         end
 
         private
@@ -198,7 +220,25 @@ module Mongoid # :nodoc:
         #
         # @return [ Criteria ] A new criteria.
         def criteria
-          ManyToMany.criteria(metadata, base.send(metadata.foreign_key))
+          ManyToMany.criteria(metadata, base.send(foreign_key))
+        end
+
+        # Flag the base as unsynced with respect to the foreign key.
+        #
+        # @api private
+        #
+        # @example Flag as unsynced.
+        #   relation.unsynced(doc, :preference_ids)
+        #
+        # @param [ Document ] doc The document to flag.
+        # @param [ Symbol ] key The key to flag on the document.
+        #
+        # @return [ true ] true.
+        #
+        # @since 3.0.0
+        def unsynced(doc, key)
+          doc.synced[key] = false
+          true
         end
 
         class << self
@@ -235,7 +275,7 @@ module Mongoid # :nodoc:
           #
           # @since 2.1.0
           def criteria(metadata, object, type = nil)
-            metadata.klass.any_in(:_id => object)
+            metadata.klass.all_of(_id: { "$in" => object })
           end
 
           # Get the criteria that is used to eager load a relation of this
@@ -245,13 +285,15 @@ module Mongoid # :nodoc:
           #   Proxy.eager_load(metadata, criteria)
           #
           # @param [ Metadata ] metadata The relation metadata.
-          # @param [ Criteria ] criteria The criteria being used.
+          # @param [ Array<Object> ] ids The ids of the documents to load.
           #
           # @return [ Criteria ] The criteria to eager load the relation.
           #
           # @since 2.2.0
-          def eager_load(metadata, criteria)
-            raise Errors::EagerLoad.new(metadata.name)
+          def eager_load(metadata, ids)
+            metadata.klass.any_in(_id: ids).each do |doc|
+              IdentityMap.set(doc)
+            end
           end
 
           # Returns true if the relation is an embedded one. In this case
@@ -267,6 +309,20 @@ module Mongoid # :nodoc:
             false
           end
 
+          # Get the foreign key for the provided name.
+          #
+          # @example Get the foreign key.
+          #   Referenced::ManyToMany.foreign_key(:person)
+          #
+          # @param [ Symbol ] name The name.
+          #
+          # @return [ String ] The foreign key.
+          #
+          # @since 3.0.0
+          def foreign_key(name)
+            "#{name.to_s.singularize}#{foreign_key_suffix}"
+          end
+
           # Get the default value for the foreign key.
           #
           # @example Get the default.
@@ -297,9 +353,9 @@ module Mongoid # :nodoc:
           # @example Get the macro.
           #   Referenced::ManyToMany.macro
           #
-          # @return [ Symbol ] :references_and_referenced_in_many
+          # @return [ Symbol ] :has_and_belongs_to_many
           def macro
-            :references_and_referenced_in_many
+            :has_and_belongs_to_many
           end
 
           # Return the nested builder that is responsible for generating the documents

data/lib/mongoid/relations/referenced/one.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
-module Mongoid # :nodoc:
-  module Relations #:nodoc:
-    module Referenced #:nodoc:
+module Mongoid
+  module Relations
+    module Referenced
 
       # This class defines the behaviour for all relations that are a
       # one-to-one between documents in different collections.
@@ -59,8 +59,7 @@ module Mongoid # :nodoc:
               save if persisted?
             end
           end
-          return nil unless replacement
-          One.new(base, replacement, metadata)
+          One.new(base, replacement, metadata) if replacement
         end
 
         private
@@ -122,7 +121,18 @@ module Mongoid # :nodoc:
           #
           # @since 2.1.0
           def criteria(metadata, object, type = nil)
-            metadata.klass.where(metadata.foreign_key => object)
+            crit = metadata.klass.where(metadata.foreign_key => object)
+
+            if metadata.polymorphic?
+              crit = crit.where(metadata.type => type.name)
+            end
+
+            inverse_metadata = metadata.inverse_metadata(metadata.klass)
+            if inverse_metadata.inverse_of_field
+              crit = crit.any_in(inverse_metadata.inverse_of_field => [metadata.name, nil])
+            end
+
+            crit
           end
 
           # Get the criteria that is used to eager load a relation of this
@@ -138,10 +148,7 @@ module Mongoid # :nodoc:
           #
           # @since 2.2.0
           def eager_load(metadata, ids)
-            klass, foreign_key = metadata.klass, metadata.foreign_key
-            klass.any_in(foreign_key => ids).each do |doc|
-              IdentityMap.set_one(doc, foreign_key => doc.send(foreign_key))
-            end
+            eager_load_ids(metadata, ids) { |doc, key| IdentityMap.set_one(doc, key) }
           end
 
           # Returns true if the relation is an embedded one. In this case
@@ -157,6 +164,20 @@ module Mongoid # :nodoc:
             false
           end
 
+          # Get the foreign key for the provided name.
+          #
+          # @example Get the foreign key.
+          #   Referenced::One.foreign_key(:person)
+          #
+          # @param [ Symbol ] name The name.
+          #
+          # @return [ String ] The foreign key.
+          #
+          # @since 3.0.0
+          def foreign_key(name)
+            "#{name}#{foreign_key_suffix}"
+          end
+
           # Get the default value for the foreign key.
           #
           # @example Get the default.
@@ -187,9 +208,9 @@ module Mongoid # :nodoc:
           # @example Get the macro.
           #   Referenced::One.macro
           #
-          # @return [ Symbol ] :references_one.
+          # @return [ Symbol ] :has_one.
           def macro
-            :references_one
+            :has_one
           end
 
           # Return the nested builder that is responsible for generating the documents
@@ -254,7 +275,7 @@ module Mongoid # :nodoc:
           #
           # @since 2.1.0
           def valid_options
-            [ :as, :autosave, :dependent, :foreign_key ]
+            [ :as, :autobuild, :autosave, :dependent, :foreign_key ]
           end
 
           # Get the default validation setting for the relation. Determines if

data/lib/mongoid/relations/reflections.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
-module Mongoid # :nodoc:
-  module Relations #:nodoc:
+module Mongoid
+  module Relations
 
     # The reflections module provides convenience methods that can retrieve
     # useful information about associations.
@@ -31,7 +31,7 @@ module Mongoid # :nodoc:
         self.class.reflect_on_all_associations(*macros)
       end
 
-      module ClassMethods #:nodoc
+      module ClassMethods
 
         # Returns the relation metadata for the supplied name.
         #

data/lib/mongoid/relations/synchronization.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
-module Mongoid # :nodoc:
-  module Relations #:nodoc:
+module Mongoid
+  module Relations
 
     # This module handles the behaviour for synchronizing foreign keys between
     # both sides of a many to many relations.
@@ -36,8 +36,6 @@ module Mongoid # :nodoc:
 
       # Has the document been synced for the foreign key?
       #
-      # @todo Change the sync to be key based.
-      #
       # @example Has the document been synced?
       #   document.synced?
       #
@@ -61,7 +59,7 @@ module Mongoid # :nodoc:
       #
       # @since 2.2.1
       def remove_inverse_keys(meta)
-        meta.criteria(send(meta.foreign_key)).pull(meta.inverse_foreign_key, id)
+        meta.criteria(send(meta.foreign_key), self.class).pull(meta.inverse_foreign_key, id)
       end
 
       # Update the inverse keys for the relation.
@@ -91,15 +89,15 @@ module Mongoid # :nodoc:
           end
 
           unless adds.empty?
-            meta.criteria(adds).add_to_set(meta.inverse_foreign_key, id)
+            meta.criteria(adds, self.class).add_to_set(meta.inverse_foreign_key, id)
           end
           unless subs.empty?
-            meta.criteria(subs).pull(meta.inverse_foreign_key, id)
+            meta.criteria(subs, self.class).pull(meta.inverse_foreign_key, id)
           end
         end
       end
 
-      module ClassMethods #:nodoc:
+      module ClassMethods
 
         # Set up the syncing of many to many foreign keys.
         #
@@ -133,15 +131,14 @@ module Mongoid # :nodoc:
         #
         # @since 2.1.0
         def synced_save(metadata)
-          tap do
-            set_callback(
-              :save,
-              :after,
-              :if => lambda { |doc| doc.syncable?(metadata) }
-            ) do |doc|
-              doc.update_inverse_keys(metadata)
-            end
+          set_callback(
+            :save,
+            :after,
+            if: ->(doc){ doc.syncable?(metadata) }
+          ) do |doc|
+            doc.update_inverse_keys(metadata)
           end
+          self
         end
 
         # Set up the sync of inverse keys that needs to happen on a destroy.
@@ -155,14 +152,13 @@ module Mongoid # :nodoc:
         #
         # @since 2.2.1
         def synced_destroy(metadata)
-          tap do
-            set_callback(
-              :destroy,
-              :after
-            ) do |doc|
-              doc.remove_inverse_keys(metadata)
-            end
+          set_callback(
+            :destroy,
+            :after
+          ) do |doc|
+            doc.remove_inverse_keys(metadata)
           end
+          self
         end
       end
     end