Class: Mongoid::Relations::Embedded::Many
- Includes:
- Atomic
- Defined in:
- lib/mongoid/relations/embedded/many.rb
Overview
This class handles the behaviour for a document that embeds many other documents within in it as an array.
Constant Summary
Constants included from Atomic
Instance Attribute Summary
Attributes inherited from Proxy
#base, #loaded, #metadata, #target
Class Method Summary collapse
-
.builder(base, meta, object) ⇒ Builder
Return the builder that is responsible for generating the documents that will be used by this relation.
-
.embedded? ⇒ true
Returns true if the relation is an embedded one.
-
.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) ⇒ Mongoid::Atomic::Paths::Embedded::Many
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) ⇒ Object
(also: #push)
Appends a document or array of documents to the relation.
-
#as_document ⇒ Array<Hash>
Get this relation as as its representation in the database.
-
#build(attributes = {}, options = {}, type = nil) ⇒ Document
(also: #new)
Builds a new document in the relation and appends it to the target.
-
#clear ⇒ Many
Clear the relation.
-
#concat(documents) ⇒ Array<Document>
Appends an array of documents to the relation.
-
#count ⇒ Integer
Returns a count of the number of documents in the association that have actually been persisted to the database.
-
#create(attributes = {}, options = {}, type = nil, &block) ⇒ Document
Create a new document in the relation.
-
#create!(attributes = {}, options = {}, type = nil, &block) ⇒ Document
Create a new document in the relation.
-
#delete(document) ⇒ Document?
Delete the supplied document from the target.
-
#delete_all(conditions = {}) ⇒ Integer
Delete all the documents in the association without running callbacks.
-
#destroy_all(conditions = {}) ⇒ Integer
Destroy all the documents in the association whilst running callbacks.
-
#find(*args) ⇒ Array<Document>, Document
Finds a document in this association through several different methods.
-
#in_memory ⇒ Array<Document>
Get all the documents in the relation that are loaded into memory.
-
#initialize(base, target, metadata) ⇒ Many
constructor
Instantiate a new embeds_many relation.
-
#substitute(replacement) ⇒ Many
Substitutes the supplied target documents for the existing documents in the relation.
-
#unscoped ⇒ Criteria
Return the relation with all previous scoping removed.
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 embeds_many relation.
247 248 249 250 251 252 253 254 255 256 |
# File 'lib/mongoid/relations/embedded/many.rb', line 247 def initialize(base, target, ) init(base, target, ) do target.each_with_index do |doc, index| integrate(doc) doc._index = index end @_unscoped = target.dup @target = scope(target) 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.
410 411 412 413 414 415 |
# File 'lib/mongoid/relations/embedded/many.rb', line 410 def method_missing(name, *args, &block) return super if target.respond_to?(name) klass.send(:with_scope, criteria) do criteria.send(name, *args, &block) end end |
Class Method Details
.builder(base, meta, object) ⇒ Builder
Return the builder that is responsible for generating the documents that will be used by this relation.
526 527 528 |
# File 'lib/mongoid/relations/embedded/many.rb', line 526 def builder(base, , object) Builders::Embedded::Many.new(base, , object) end |
.embedded? ⇒ true
Returns true if the relation is an embedded one. In this case always true.
539 540 541 |
# File 'lib/mongoid/relations/embedded/many.rb', line 539 def true end |
.macro ⇒ Symbol
Returns the macro for this relation. Used mostly as a helper in reflection.
552 553 554 |
# File 'lib/mongoid/relations/embedded/many.rb', line 552 def macro :embeds_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.
578 579 580 |
# File 'lib/mongoid/relations/embedded/many.rb', line 578 def nested_builder(, attributes, ) Builders::NestedAttributes::Many.new(, attributes, ) end |
.path(document) ⇒ Mongoid::Atomic::Paths::Embedded::Many
Get the path calculator for the supplied document.
593 594 595 |
# File 'lib/mongoid/relations/embedded/many.rb', line 593 def path(document) Mongoid::Atomic::Paths::Embedded::Many.new(document) end |
.stores_foreign_key? ⇒ false
Tells the caller if this relation is one that stores the foreign key on its own objects.
606 607 608 |
# File 'lib/mongoid/relations/embedded/many.rb', line 606 def stores_foreign_key? false end |
.valid_options ⇒ Array<Symbol>
Get the valid options allowed with this relation.
618 619 620 |
# File 'lib/mongoid/relations/embedded/many.rb', line 618 def [ :as, :cascade_callbacks, :cyclic, :order, :versioned ] end |
.validation_default ⇒ true, false
Get the default validation setting for the relation. Determines if by default a validates associated will occur.
631 632 633 |
# File 'lib/mongoid/relations/embedded/many.rb', line 631 def validation_default true end |
Instance Method Details
#<<(*args) ⇒ Object Also known as: push
Appends a document or array of documents to the relation. Will set the parent and update the index in the process.
21 22 23 24 25 26 27 28 |
# File 'lib/mongoid/relations/embedded/many.rb', line 21 def <<(*args) docs = args.flatten return concat(docs) if docs.size > 1 if doc = docs.first append(doc) doc.save if persistable? && !_assigning? end end |
#as_document ⇒ Array<Hash>
Get this relation as as its representation in the database.
318 319 320 321 322 323 324 |
# File 'lib/mongoid/relations/embedded/many.rb', line 318 def as_document [].tap do |attributes| _unscoped.each do |doc| attributes.push(doc.as_document) end end end |
#build(attributes = {}, options = {}, type = nil) ⇒ Document #build(attributes = {}, type = nil) ⇒ Document Also known as: new
Builds a new document in the relation and appends it to the target. Takes an optional type if you want to specify a subclass.
73 74 75 76 77 78 79 80 81 82 83 84 |
# File 'lib/mongoid/relations/embedded/many.rb', line 73 def build(attributes = {}, = {}, type = nil) if .is_a? Class , type = {}, end Factory.build(type || .klass, attributes, ).tap do |doc| doc.identify append(doc) yield(doc) if block_given? doc.run_callbacks(:build) { doc } end end |
#clear ⇒ Many
Clear the relation. Will delete the documents from the db if they are already persisted.
94 95 96 97 98 99 100 101 |
# File 'lib/mongoid/relations/embedded/many.rb', line 94 def clear tap do |proxy| atomically(:$unset) do proxy.delete_all _unscoped.clear end end end |
#concat(documents) ⇒ Array<Document>
When performing batch inserts the after callbacks will get executed before the documents have actually been persisted to the database due to an issue with Active Support’s callback system - we cannot explicitly fire the after callbacks by themselves.
Appends an array of documents to the relation. Performs a batch insert of the documents instead of persisting one at a time.
47 48 49 50 51 52 53 54 55 |
# File 'lib/mongoid/relations/embedded/many.rb', line 47 def concat(documents) atomically(:$pushAll) do documents.each do |doc| next unless doc append(doc) doc.save if persistable? end end end |
#count ⇒ Integer
Returns a count of the number of documents in the association that have actually been persisted to the database.
Use #size if you want the total number of documents.
113 114 115 |
# File 'lib/mongoid/relations/embedded/many.rb', line 113 def count target.select { |doc| doc.persisted? }.size end |
#create(attributes = {}, options = {}, type = nil) ⇒ Document #create(attributes = {}, type = nil) ⇒ Document
Create a new document in the relation. This is essentially the same as doing a #build then #save on the new document.
133 134 135 |
# File 'lib/mongoid/relations/embedded/many.rb', line 133 def create(attributes = {}, = {}, type = nil, &block) build(attributes, , type, &block).tap { |doc| doc.save } end |
#create!(attributes = {}, options = {}, type = nil) ⇒ Document #create!(attributes = {}, type = nil) ⇒ Document
Create a new document in the relation. This is essentially the same as doing a #build then #save on the new document. If validation failed on the document an error will get raised.
156 157 158 |
# File 'lib/mongoid/relations/embedded/many.rb', line 156 def create!(attributes = {}, = {}, type = nil, &block) build(attributes, , type, &block).tap { |doc| doc.save! } end |
#delete(document) ⇒ Document?
Delete the supplied document from the target. This method is proxied in order to reindex the array after the operation occurs.
171 172 173 174 175 176 177 178 179 180 181 182 183 184 |
# File 'lib/mongoid/relations/embedded/many.rb', line 171 def delete(document) target.delete_one(document).tap do |doc| _unscoped.delete_one(doc) if doc && !_binding? if _assigning? && !doc.paranoid? base.add_atomic_pull(doc) else doc.delete(:suppress => true) end unbind_one(doc) end reindex end end |
#delete_all(conditions = {}) ⇒ Integer
Delete all the documents in the association without running callbacks.
197 198 199 |
# File 'lib/mongoid/relations/embedded/many.rb', line 197 def delete_all(conditions = {}) atomically(:$pull) { remove_all(conditions, :delete) } end |
#destroy_all(conditions = {}) ⇒ Integer
Destroy all the documents in the association whilst running callbacks.
212 213 214 |
# File 'lib/mongoid/relations/embedded/many.rb', line 212 def destroy_all(conditions = {}) atomically(:$pull) { remove_all(conditions, :destroy) } end |
#find(*args) ⇒ Array<Document>, Document
Finds a document in this association through several different methods.
233 234 235 |
# File 'lib/mongoid/relations/embedded/many.rb', line 233 def find(*args) criteria.find(*args) end |
#in_memory ⇒ Array<Document>
Get all the documents in the relation that are loaded into memory.
266 267 268 |
# File 'lib/mongoid/relations/embedded/many.rb', line 266 def in_memory target end |
#substitute(replacement) ⇒ Many
Substitutes the supplied target documents for the existing documents in the relation.
282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 |
# File 'lib/mongoid/relations/embedded/many.rb', line 282 def substitute(replacement) tap do |proxy| if replacement.blank? if _assigning? && !proxy.empty? base.atomic_unsets.push(proxy.first.atomic_path) end proxy.clear else atomically(:$set) do if replacement.first.is_a?(Hash) replacement = Many.builder(base, , replacement).build end docs = replacement.compact proxy.target = docs self._unscoped = docs.dup if _assigning? base.delayed_atomic_sets[.name.to_s] = proxy.as_document end proxy.target.each_with_index do |doc, index| integrate(doc) doc._index = index doc.save if base.persisted? && !_assigning? end end end end end |
#unscoped ⇒ Criteria
Return the relation with all previous scoping removed. This is the exact representation of the docs in the database.
335 336 337 338 339 |
# File 'lib/mongoid/relations/embedded/many.rb', line 335 def unscoped klass.criteria(true, false).tap do |criterion| criterion.documents = _unscoped end end |