Module: Mongoid::Atomic

Extended by:
ActiveSupport::Concern
Included in:
Components, Contextual::Mongo, Persistence
Defined in:
lib/mongoid/atomic.rb,
lib/mongoid/atomic/modifiers.rb,
lib/mongoid/atomic/paths/root.rb,
lib/mongoid/atomic/positionable.rb,
lib/mongoid/atomic/paths/embedded.rb,
lib/mongoid/atomic/paths/embedded/one.rb,
lib/mongoid/atomic/paths/embedded/many.rb

Overview

This module contains the logic for supporting atomic operations against the database.

Defined Under Namespace

Modules: Paths, Positionable Classes: Modifiers

Constant Summary collapse

UPDATES =
[
  :atomic_array_pushes,
  :atomic_array_pulls,
  :atomic_array_add_to_sets,
  :atomic_pulls,
  :delayed_atomic_sets,
  :delayed_atomic_pulls,
  :delayed_atomic_unsets
]

Instance Method Summary collapse

Instance Method Details

#add_atomic_pull(document) ⇒ Object

Add the document as an atomic pull.

Examples:

Add the atomic pull.

person.add_atomic_pull(address)

Parameters:

  • The (Document)

    embedded document to pull.

Since:

  • 2.2.0



37
38
39
40
# File 'lib/mongoid/atomic.rb', line 37

def add_atomic_pull(document)
  document.flagged_for_destroy = true
  (delayed_atomic_pulls[document..to_s] ||= []).push(document)
end

#add_atomic_unset(document) ⇒ Array<Document>

Add an atomic unset for the document.

Examples:

Add an atomic unset.

document.add_atomic_unset(doc)

Parameters:

  • document (Document)

    The child document.

Returns:

Since:

  • 3.0.0



52
53
54
55
# File 'lib/mongoid/atomic.rb', line 52

def add_atomic_unset(document)
  document.flagged_for_destroy = true
  (delayed_atomic_unsets[document..to_s] ||= []).push(document)
end

#atomic_array_add_to_setsHash

For array fields these are the unique adds that need to happen.

Examples:

Get the array unique adds.

person.atomic_array_add_to_sets

Returns:

  • (Hash)

    The array add_to_sets.

Since:

  • 2.4.0



101
102
103
# File 'lib/mongoid/atomic.rb', line 101

def atomic_array_add_to_sets
  @atomic_array_add_to_sets ||= {}
end

#atomic_array_pullsHash

For array fields these are the pulls that need to happen.

Examples:

Get the array pulls.

person.atomic_array_pulls

Returns:

  • (Hash)

    The array pulls.

Since:

  • 2.4.0



89
90
91
# File 'lib/mongoid/atomic.rb', line 89

def atomic_array_pulls
  @atomic_array_pulls ||= {}
end

#atomic_array_pushesHash

For array fields these are the pushes that need to happen.

Examples:

Get the array pushes.

person.atomic_array_pushes

Returns:

  • (Hash)

    The array pushes.

Since:

  • 2.4.0



77
78
79
# File 'lib/mongoid/atomic.rb', line 77

def atomic_array_pushes
  @atomic_array_pushes ||= {}
end

#atomic_attribute_name(name) ⇒ String

Returns path of the attribute for modification

Examples:

Get path of the attribute

address.atomic_attribute_name(:city)

Returns:

  • (String)

    The path to the document attribute in the database

Since:

  • 3.0.0



65
66
67
# File 'lib/mongoid/atomic.rb', line 65

def atomic_attribute_name(name)
  embedded? ? "#{atomic_position}.#{name}" : name
end

#atomic_delete_modifierString

Get the removal modifier for the document. Will be nil on root documents, $unset on embeds_one, $set on embeds_many.

Examples:

Get the removal operator.

name.atomic_delete_modifier

Returns:

  • (String)

    The pull or unset operation.



147
148
149
# File 'lib/mongoid/atomic.rb', line 147

def atomic_delete_modifier
  atomic_paths.delete_modifier
end

#atomic_insert_modifierString

Get the insertion modifier for the document. Will be nil on root documents, $set on embeds_one, $push on embeds_many.

Examples:

Get the insert operation.

name.atomic_insert_modifier

Returns:

  • (String)

    The pull or set operator.



158
159
160
# File 'lib/mongoid/atomic.rb', line 158

def atomic_insert_modifier
  atomic_paths.insert_modifier
end

#atomic_pathString

Return the path to this Document in JSON notation, used for atomic updates via $set in MongoDB.

Examples:

Get the path to this document.

address.atomic_path

Returns:

  • (String)

    The path to the document in the database.



169
170
171
# File 'lib/mongoid/atomic.rb', line 169

def atomic_path
  atomic_paths.path
end

#atomic_pathsObject

Get the atomic paths utility for this document.

Examples:

Get the atomic paths.

document.atomic_paths

Returns:

  • (Object)

    The associated path.

Since:

  • 2.1.0



191
192
193
# File 'lib/mongoid/atomic.rb', line 191

def atomic_paths
  @atomic_paths ||=  ? .path(self) : Atomic::Paths::Root.new(self)
end

#atomic_positionString

Returns the positional operator of this document for modification.

Examples:

Get the positional operator.

address.atomic_position

Returns:

  • (String)

    The positional operator with indexes.



179
180
181
# File 'lib/mongoid/atomic.rb', line 179

def atomic_position
  atomic_paths.position
end

#atomic_pullsArray<Hash>

Get all the attributes that need to be pulled.

Examples:

Get the pulls.

person.atomic_pulls

Returns:

  • (Array<Hash>)

    The $pullAll operations.

Since:

  • 2.2.0



203
204
205
206
207
208
209
210
211
212
213
214
# File 'lib/mongoid/atomic.rb', line 203

def atomic_pulls
  pulls = {}
  delayed_atomic_pulls.each_pair do |_, docs|
    path = nil
    ids = docs.map do |doc|
      path ||= doc.flag_as_destroyed
      doc.id
    end
    pulls[path] = { "_id" => { "$in" => ids }} and path = nil
  end
  pulls
end

#atomic_pushesHash

Get all the push attributes that need to occur.

Examples:

Get the pushes.

person.atomic_pushes

Returns:

  • (Hash)

    The $pushAll operations.

Since:

  • 2.1.0



224
225
226
# File 'lib/mongoid/atomic.rb', line 224

def atomic_pushes
  pushable? ? { atomic_position => as_document } : {}
end

#atomic_selectorString

Return the selector for this document to be matched exactly for use with MongoDB’s $ operator.

Examples:

Get the selector.

address.atomic_selector

Returns:

  • (String)

    The exact selector for this document.



235
236
237
# File 'lib/mongoid/atomic.rb', line 235

def atomic_selector
  atomic_paths.selector
end

#atomic_setsHash

Get all the attributes that need to be set.

Examples:

Get the sets.

person.atomic_sets

Returns:

  • (Hash)

    The $set operations.

Since:

  • 2.1.0



247
248
249
# File 'lib/mongoid/atomic.rb', line 247

def atomic_sets
  updateable? ? setters : settable? ? { atomic_path => as_document } : {}
end

#atomic_unsetsArray<Hash>

Get all the attributes that need to be unset.

Examples:

Get the unsets.

person.atomic_unsets

Returns:

  • (Array<Hash>)

    The $unset operations.

Since:

  • 2.2.0



259
260
261
262
263
264
265
266
267
268
269
# File 'lib/mongoid/atomic.rb', line 259

def atomic_unsets
  unsets = []
  delayed_atomic_unsets.each_pair do |name, docs|
    path = nil
    docs.each do |doc|
      path ||= doc.flag_as_destroyed
    end
    unsets.push(path || name)
  end
  unsets
end

#atomic_updates(use_indexes = false) ⇒ Hash Also known as: _updates

Note:

MongoDB does not allow “conflicting modifications” to be performed in a single operation. Conflicting modifications are detected by the ‘haveConflictingMod’ function in MongoDB. Examination of the code suggests that two modifications (a $set and a $pushAll, for example) conflict if:

(1) the key paths being modified are equal.
(2) one key path is a prefix of the other.

So a $set of ‘addresses.0.street’ will conflict with a $pushAll to ‘addresses’, and we will need to split our update into two pieces. We do not, however, attempt to match MongoDB’s logic exactly. Instead, we assume that two updates conflict if the first component of the two key paths matches.

Get all the atomic updates that need to happen for the current Document. This includes all changes that need to happen in the entire hierarchy that exists below where the save call was made.

Examples:

Get the updates that need to occur.

person.atomic_updates(children)

Returns:

  • (Hash)

    The updates and their modifiers.

Since:

  • 2.1.0



128
129
130
131
132
133
134
135
136
137
# File 'lib/mongoid/atomic.rb', line 128

def atomic_updates(use_indexes = false)
  process_flagged_destroys
  mods = Modifiers.new
  generate_atomic_updates(mods, self)
  _children.each do |child|
    child.process_flagged_destroys
    generate_atomic_updates(mods, child)
  end
  mods
end

#delayed_atomic_pullsHash

Get a hash of atomic pulls that are pending.

Examples:

Get the atomic pulls.

document.delayed_atomic_pulls

Returns:

  • (Hash)

    name/document pairs.

Since:

  • 2.3.2



291
292
293
# File 'lib/mongoid/atomic.rb', line 291

def delayed_atomic_pulls
  @delayed_atomic_pulls ||= {}
end

#delayed_atomic_setsHash

Get all the atomic sets that have had their saves delayed.

Examples:

Get the delayed atomic sets.

person.delayed_atomic_sets

Returns:

  • (Hash)

    The delayed $sets.

Since:

  • 2.3.0



279
280
281
# File 'lib/mongoid/atomic.rb', line 279

def delayed_atomic_sets
  @delayed_atomic_sets ||= {}
end

#delayed_atomic_unsetsHash

Get the delayed atomic unsets.

Examples:

Get the delayed atomic unsets.

document.delayed_atomic_unsets

Returns:

  • (Hash)

    The atomic unsets

Since:

  • 3.0.0



303
304
305
# File 'lib/mongoid/atomic.rb', line 303

def delayed_atomic_unsets
  @delayed_atomic_unsets ||= {}
end

#flag_as_destroyedString

Flag the document as destroyed and return the atomic path.

Examples:

Flag destroyed and return path.

document.flag_as_destroyed

Returns:

  • (String)

    The atomic path.

Since:

  • 3.0.0



315
316
317
318
319
# File 'lib/mongoid/atomic.rb', line 315

def flag_as_destroyed
  self.destroyed = true
  self.flagged_for_destroy = false
  atomic_path
end

#flagged_destroysArray<Proc>

Get the flagged destroys.

Examples:

Get the flagged destroy.

document.flagged_destroys

Returns:

  • (Array<Proc>)

    The flagged destroys.

Since:

  • 3.0.10



329
330
331
# File 'lib/mongoid/atomic.rb', line 329

def flagged_destroys
  @flagged_destroys ||= []
end

#process_flagged_destroysArray

Process all the pending flagged destroys from nested attributes.

Examples:

Process all the pending flagged destroys.

document.process_flagged_destroys

Returns:

  • (Array)

    The cleared array.

Since:

  • 3.0.10



341
342
343
344
345
346
347
348
# File 'lib/mongoid/atomic.rb', line 341

def process_flagged_destroys
  _assigning do
    flagged_destroys.each do |block|
      block.call
    end
  end
  flagged_destroys.clear
end