Class: Mongoid::Relations::Referenced::Many
- Includes:
- Batch
- Defined in:
- lib/mongoid/relations/referenced/many.rb
Overview
This class defines the behaviour for all relations that are a one-to-many between documents in different collections.
Direct Known Subclasses
Instance Attribute Summary
Attributes inherited from Proxy
#base, #loaded, #metadata, #target
Class Method Summary collapse
-
.builder(meta, object, loading = false) ⇒ Builder
Return the builder that is responsible for generating the documents that will be used by this relation.
-
.criteria(metadata, object, type = nil) ⇒ Criteria
Get the standard criteria used for querying this relation.
-
.eager_load(metadata, criteria) ⇒ Criteria
Eager load the relation based on the criteria.
-
.embedded? ⇒ false
Returns true if the relation is an embedded one.
-
.foreign_key_default ⇒ nil
Get the default value for the foreign key.
-
.foreign_key_suffix ⇒ String
Returns the suffix of the foreign key field, either “_id” or “_ids”.
-
.macro ⇒ Symbol
Returns the macro for this relation.
-
.nested_builder(metadata, attributes, options) ⇒ NestedBuilder
Return the nested builder that is responsible for generating the documents that will be used by this relation.
-
.path(document) ⇒ Root
Get the path calculator for the supplied document.
-
.stores_foreign_key? ⇒ false
Tells the caller if this relation is one that stores the foreign key on its own objects.
-
.valid_options ⇒ Array<Symbol>
Get the valid options allowed with this relation.
-
.validation_default ⇒ true, false
Get the default validation setting for the relation.
Instance Method Summary collapse
-
#<<(*args) ⇒ Array<Document>
(also: #concat, #push)
Appends a document or array of documents to the relation.
-
#build(attributes = {}, type = nil) ⇒ Document
(also: #new)
Build a new document from the attributes and append it to this relation without saving.
-
#create(attributes = nil, type = nil, &block) ⇒ Document
Creates a new document on the references many relation.
-
#create!(attributes = nil, type = nil, &block) ⇒ Document
Creates a new document on the references many relation.
-
#delete(document) ⇒ Document
Delete the document from the relation.
-
#delete_all(conditions = nil) ⇒ Integer
Deletes all related documents from the database given the supplied conditions.
-
#destroy_all(conditions = nil) ⇒ Integer
Destroys all related documents from the database given the supplied conditions.
-
#each ⇒ Array<Document>
Iterate over each document in the relation and yield to the provided block.
-
#find(*args) ⇒ Document, Criteria
Find the matchind document on the association, either based on id or conditions.
-
#initialize(base, target, metadata) ⇒ Many
constructor
Instantiate a new references_many relation.
-
#nullify ⇒ Object
(also: #nullify_all)
Removes all associations between the base document and the target documents by deleting the foreign keys and the references, orphaning the target documents in the process.
-
#purge ⇒ Many
(also: #clear)
Clear the relation.
-
#substitute(replacement) ⇒ Many
Substitutes the supplied target documents for the existing documents in the relation.
Methods inherited from Many
#blank?, #exists?, #find_or_create_by, #find_or_initialize_by, #nil?, #respond_to?, #scoped, #serializable_hash
Methods inherited from Proxy
Constructor Details
#initialize(base, target, metadata) ⇒ Many
Instantiate a new references_many relation. Will set the foreign key and the base on the inverse object.
216 217 218 219 220 |
# File 'lib/mongoid/relations/referenced/many.rb', line 216 def initialize(base, target, ) init(base, Targets::Enumerable.new(target), ) do raise_mixed if klass. end end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(name, *args, &block) ⇒ Criteria, Object (private)
If the target array does not respond to the supplied method then try to find a named scope or criteria on the class and send the call there.
If the method exists on the array, use the default proxy behavior.
392 393 394 395 396 397 398 399 400 |
# File 'lib/mongoid/relations/referenced/many.rb', line 392 def method_missing(name, *args, &block) if target.respond_to?(name) target.send(name, *args, &block) else klass.send(:with_scope, criteria) do criteria.send(name, *args, &block) end end end |
Class Method Details
.builder(meta, object, loading = false) ⇒ Builder
Return the builder that is responsible for generating the documents that will be used by this relation.
455 456 457 |
# File 'lib/mongoid/relations/referenced/many.rb', line 455 def builder(, object, loading = false) Builders::Referenced::Many.new(, object || [], loading) end |
.criteria(metadata, object, type = nil) ⇒ Criteria
Get the standard criteria used for querying this relation.
471 472 473 |
# File 'lib/mongoid/relations/referenced/many.rb', line 471 def criteria(, object, type = nil) .klass.where(.foreign_key => object) end |
.eager_load(metadata, criteria) ⇒ Criteria
Eager load the relation based on the criteria.
486 487 488 489 490 491 |
# File 'lib/mongoid/relations/referenced/many.rb', line 486 def eager_load(, criteria) klass, foreign_key = .klass, .foreign_key klass.any_in(foreign_key => criteria.load_ids("_id").uniq).each do |doc| IdentityMap.set_many(doc, foreign_key => doc.send(foreign_key)) end end |
.embedded? ⇒ false
Returns true if the relation is an embedded one. In this case always false.
502 503 504 |
# File 'lib/mongoid/relations/referenced/many.rb', line 502 def false end |
.foreign_key_default ⇒ nil
Get the default value for the foreign key.
514 515 516 |
# File 'lib/mongoid/relations/referenced/many.rb', line 514 def foreign_key_default nil end |
.foreign_key_suffix ⇒ String
Returns the suffix of the foreign key field, either “_id” or “_ids”.
526 527 528 |
# File 'lib/mongoid/relations/referenced/many.rb', line 526 def foreign_key_suffix "_id" end |
.macro ⇒ Symbol
Returns the macro for this relation. Used mostly as a helper in reflection.
537 538 539 |
# File 'lib/mongoid/relations/referenced/many.rb', line 537 def macro :references_many end |
.nested_builder(metadata, attributes, options) ⇒ NestedBuilder
Return the nested builder that is responsible for generating the documents that will be used by this relation.
563 564 565 |
# File 'lib/mongoid/relations/referenced/many.rb', line 563 def nested_builder(, attributes, ) Builders::NestedAttributes::Many.new(, attributes, ) end |
.path(document) ⇒ Root
Get the path calculator for the supplied document.
577 578 579 |
# File 'lib/mongoid/relations/referenced/many.rb', line 577 def path(document) Mongoid::Atomic::Paths::Root.new(document) end |
.stores_foreign_key? ⇒ false
Tells the caller if this relation is one that stores the foreign key on its own objects.
590 591 592 |
# File 'lib/mongoid/relations/referenced/many.rb', line 590 def stores_foreign_key? false end |
.valid_options ⇒ Array<Symbol>
Get the valid options allowed with this relation.
602 603 604 |
# File 'lib/mongoid/relations/referenced/many.rb', line 602 def [ :as, :autosave, :dependent, :foreign_key, :order ] end |
.validation_default ⇒ true, false
Get the default validation setting for the relation. Determines if by default a validates associated will occur.
615 616 617 |
# File 'lib/mongoid/relations/referenced/many.rb', line 615 def validation_default true end |
Instance Method Details
#<<(*args) ⇒ Array<Document> Also known as: concat, push
Appends a document or array of documents to the relation. Will set the parent and update the index in the process.
31 32 33 34 35 36 37 38 39 |
# File 'lib/mongoid/relations/referenced/many.rb', line 31 def <<(*args) batched do args.flatten.each do |doc| next unless doc append(doc) doc.save if persistable? && !doc.validated? end end end |
#build(attributes = {}, type = nil) ⇒ Document Also known as: new
Build a new document from the attributes and append it to this relation without saving.
55 56 57 58 59 60 |
# File 'lib/mongoid/relations/referenced/many.rb', line 55 def build(attributes = {}, type = nil) Factory.build(type || klass, attributes).tap do |doc| append(doc) yield(doc) if block_given? end end |
#create(attributes = nil, type = nil, &block) ⇒ Document
Creates a new document on the references many relation. This will save the document if the parent has been persisted.
75 76 77 78 79 |
# File 'lib/mongoid/relations/referenced/many.rb', line 75 def create(attributes = nil, type = nil, &block) build(attributes, type, &block).tap do |doc| base.persisted? ? doc.save : raise_unsaved(doc) end end |
#create!(attributes = nil, type = nil, &block) ⇒ Document
Creates a new document on the references many relation. This will save the document if the parent has been persisted and will raise an error if validation fails.
96 97 98 99 100 |
# File 'lib/mongoid/relations/referenced/many.rb', line 96 def create!(attributes = nil, type = nil, &block) build(attributes, type, &block).tap do |doc| base.persisted? ? doc.save! : raise_unsaved(doc) end end |
#delete(document) ⇒ Document
Delete the document from the relation. This will set the foreign key on the document to nil. If the dependent options on the relation are :delete or :destroy the appropriate removal will occur.
114 115 116 117 118 119 120 121 |
# File 'lib/mongoid/relations/referenced/many.rb', line 114 def delete(document) target.delete(document) do |doc| if doc unbind_one(doc) cascade!(doc) end end end |
#delete_all(conditions = nil) ⇒ Integer
Deletes all related documents from the database given the supplied conditions.
137 138 139 |
# File 'lib/mongoid/relations/referenced/many.rb', line 137 def delete_all(conditions = nil) remove_all(conditions, :delete_all) end |
#destroy_all(conditions = nil) ⇒ Integer
Destroys all related documents from the database given the supplied conditions.
155 156 157 |
# File 'lib/mongoid/relations/referenced/many.rb', line 155 def destroy_all(conditions = nil) remove_all(conditions, :destroy_all) end |
#each ⇒ Array<Document>
This will load the entire relation into memory.
Iterate over each document in the relation and yield to the provided block.
172 173 174 |
# File 'lib/mongoid/relations/referenced/many.rb', line 172 def each target.each { |doc| yield(doc) if block_given? } end |
#find(*args) ⇒ Document, Criteria
Find the matchind document on the association, either based on id or conditions.
201 202 203 |
# File 'lib/mongoid/relations/referenced/many.rb', line 201 def find(*args) criteria.find(*args) end |
#nullify ⇒ Object Also known as: nullify_all
Removes all associations between the base document and the target documents by deleting the foreign keys and the references, orphaning the target documents in the process.
230 231 232 233 234 235 |
# File 'lib/mongoid/relations/referenced/many.rb', line 230 def nullify criteria.update(.foreign_key => nil) target.clear do |doc| unbind_one(doc) end end |
#purge ⇒ Many Also known as: clear
Clear the relation. Will delete the documents from the db if they are already persisted.
247 248 249 250 251 252 253 254 255 256 257 |
# File 'lib/mongoid/relations/referenced/many.rb', line 247 def purge unless .destructive? nullify else criteria.delete_all target.clear do |doc| unbind_one(doc) doc.destroyed = true end end end |
#substitute(replacement) ⇒ Many
Substitutes the supplied target documents for the existing documents in the relation. If the new target is nil, perform the necessary deletion.
272 273 274 275 276 277 278 279 |
# File 'lib/mongoid/relations/referenced/many.rb', line 272 def substitute(replacement) tap do |proxy| if replacement != proxy.in_memory proxy.purge proxy.push(replacement.compact) if replacement end end end |