Class: Mongoid::Contextual::Memory

Inherits:
Object
  • Object
show all
Includes:
Enumerable, Association::EagerLoadable, Aggregable::Memory, Queryable, Positional
Defined in:
lib/mongoid/contextual/memory.rb

Instance Attribute Summary collapse

Attributes included from Queryable

#collection, #collection The collection to query against., #criteria, #criteria The criteria for the context., #klass, #klass The klass for the criteria.

Instance Method Summary collapse

Methods included from Positional

#positionally

Methods included from Queryable

#blank?

Methods included from Association::EagerLoadable

#eager_load, #eager_loadable?, #preload

Methods included from Aggregable::Memory

#aggregates, #avg, #max, #min, #sum

Constructor Details

#initialize(criteria) ⇒ Memory

Create the new in memory context.

Examples:

Create the new context.

Memory.new(criteria)

Parameters:



143
144
145
146
147
148
149
150
151
152
 
# File 'lib/mongoid/contextual/memory.rb', line 143

def initialize(criteria)
  @criteria, @klass = criteria, criteria.klass
  @documents = criteria.documents.select do |doc|
    @root ||= doc._root
    @collection ||= root.collection
    doc._matches?(criteria.selector)
  end
  apply_sorting
  apply_options
end

Instance Attribute Details

#documents ⇒ Object (readonly)

Returns the value of attribute documents.



19
20
21
 
# File 'lib/mongoid/contextual/memory.rb', line 19

def documents
  @documents
end

#matching The in memory documents that match the selector.(The) ⇒ Object (readonly) 



19
 
# File 'lib/mongoid/contextual/memory.rb', line 19

attr_reader :documents, :path, :root, :selector

#path ⇒ Object (readonly)

Returns the value of attribute path.



19
20
21
 
# File 'lib/mongoid/contextual/memory.rb', line 19

def path
  @path
end

#path The atomic path.(Theatomicpath.) ⇒ Object (readonly) 



19
 
# File 'lib/mongoid/contextual/memory.rb', line 19

attr_reader :documents, :path, :root, :selector

#root ⇒ Object (readonly)

Returns the value of attribute root.



19
20
21
 
# File 'lib/mongoid/contextual/memory.rb', line 19

def root
  @root
end

#root The root document.(Therootdocument.) ⇒ Object (readonly) 



19
 
# File 'lib/mongoid/contextual/memory.rb', line 19

attr_reader :documents, :path, :root, :selector

#selector ⇒ Object (readonly)

Returns the value of attribute selector.



19
20
21
 
# File 'lib/mongoid/contextual/memory.rb', line 19

def selector
  @selector
end

#selector The root document selector.(Therootdocumentselector.) ⇒ Object (readonly) 



19
 
# File 'lib/mongoid/contextual/memory.rb', line 19

attr_reader :documents, :path, :root, :selector

Instance Method Details

#==(other) ⇒ true, false

Check if the context is equal to the other object.

Examples:

Check equality.

context == []

Parameters:

  • other (Array) —

    The other array.

Returns:

  • (true, false) —

    If the objects are equal.



29
30
31
32
 
# File 'lib/mongoid/contextual/memory.rb', line 29

def ==(other)
  return false unless other.respond_to?(:entries)
  entries == other.entries
end

#delete ⇒ nil Also known as: delete_all

Delete all documents in the database that match the selector.

Examples:

Delete all the documents.

context.delete

Returns:

  • (nil) —

    Nil.



40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/mongoid/contextual/memory.rb', line 40

def delete
  deleted = count
  removed = map do |doc|
    prepare_remove(doc)
    doc.send(:as_attributes)
  end
  unless removed.empty?
    collection.find(selector).update_one(
      positionally(selector, "$pullAll" => { path => removed }),
      session: _session
    )
  end
  deleted
end

#destroy ⇒ nil Also known as: destroy_all

Destroy all documents in the database that match the selector.

Examples:

Destroy all the documents.

context.destroy

Returns:

  • (nil) —

    Nil.



62
63
64
65
66
67
68
69
 
# File 'lib/mongoid/contextual/memory.rb', line 62

def destroy
  deleted = count
  each do |doc|
    documents.delete_one(doc)
    doc.destroy
  end
  deleted
end

#distinct(field) ⇒ Array<Object>

Get the distinct values in the db for the provided field.

Examples:

Get the distinct values.

context.distinct(:name)

Parameters:

  • field (String, Symbol) —

    The name of the field.

Returns:

  • (Array<Object>) —

    The distinct values for the field.



80
81
82
83
84
85
86
 
# File 'lib/mongoid/contextual/memory.rb', line 80

def distinct(field)
  if Mongoid.legacy_pluck_distinct
    documents.map{ |doc| doc.send(field) }.uniq
  else
    pluck(field).uniq
  end
end

#each ⇒ Enumerator

Iterate over the context. If provided a block, yield to a Mongoid document for each, otherwise return an enum.

Examples:

Iterate over the context.

context.each do |doc|
  puts doc.name
end

Returns:

  • (Enumerator) —

    The enumerator.



97
98
99
100
101
102
103
104
105
106
 
# File 'lib/mongoid/contextual/memory.rb', line 97

def each
  if block_given?
    documents_for_iteration.each do |doc|
      yield(doc)
    end
    self
  else
    to_enum
  end
end

#exists? ⇒ true, false

Do any documents exist for the context.

Examples:

Do any documents exist for the context.

context.exists?

Returns:

  • (true, false) —

    If the count is more than zero.



114
115
116
 
# File 'lib/mongoid/contextual/memory.rb', line 114

def exists?
  count > 0
end

#first(limit_or_opts = nil) ⇒ Document Also known as: one, find_first

Get the first document in the database for the criteria’s selector.

Examples:

Get the first document.

context.first

Parameters:

  • limit_or_opts (Integer | Hash) (defaults to: nil) —

    The number of documents to return, or a hash of options.

Returns:



127
128
129
130
131
132
133
 
# File 'lib/mongoid/contextual/memory.rb', line 127

def first(limit_or_opts = nil)
  if limit_or_opts.nil? || limit_or_opts.is_a?(Hash)
    eager_load([documents.first]).first
  else
    eager_load(documents.first(limit_or_opts))
  end
end

#inc(incs) ⇒ Enumerator

Increment a value on all documents.

Examples:

Perform the increment.

context.inc(likes: 10)

Parameters:

  • incs (Hash) —

    The operations.

Returns:

  • (Enumerator) —

    The enumerator.



162
163
164
165
166
 
# File 'lib/mongoid/contextual/memory.rb', line 162

def inc(incs)
  each do |document|
    document.inc(incs)
  end
end

#last(limit_or_opts = nil) ⇒ Document

Get the last document in the database for the criteria’s selector.

Examples:

Get the last document.

context.last

Parameters:

  • limit_or_opts (Integer | Hash) (defaults to: nil) —

    The number of documents to return, or a hash of options.

Options Hash (limit_or_opts):

  • :id_sort (:none) —

    This option is deprecated. Don’t apply a sort on _id if no other sort is defined on the criteria.

Returns:



180
181
182
183
184
185
186
 
# File 'lib/mongoid/contextual/memory.rb', line 180

def last(limit_or_opts = nil)
  if limit_or_opts.nil? || limit_or_opts.is_a?(Hash)
    eager_load([documents.last]).first
  else
    eager_load(documents.last(limit_or_opts))
  end
end

#length ⇒ Integer Also known as: size

Get the length of matching documents in the context.

Examples:

Get the length of matching documents.

context.length

Returns:

  • (Integer) —

    The matching length.



227
228
229
 
# File 'lib/mongoid/contextual/memory.rb', line 227

def length
  documents.length
end

#limit(value) ⇒ Mongo

Limits the number of documents that are returned.

Examples:

Limit the documents.

context.limit(20)

Parameters:

  • value (Integer) —

    The number of documents to return.

Returns:

  • (Mongo) —

    The context.



240
241
242
243
 
# File 'lib/mongoid/contextual/memory.rb', line 240

def limit(value)
  self.limiting = value
  self
end

#pluck(*fields) ⇒ Object 



245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
 
# File 'lib/mongoid/contextual/memory.rb', line 245

def pluck(*fields)
  if Mongoid.legacy_pluck_distinct
    documents.pluck(*fields)
  else
    documents.map do |d|
      if fields.length == 1
        retrieve_value_at_path(d, fields.first)
      else
        fields.map do |field|
          retrieve_value_at_path(d, field)
        end
      end
    end
  end
end

#skip(value) ⇒ Mongo

Skips the provided number of documents.

Examples:

Skip the documents.

context.skip(20)

Parameters:

  • value (Integer) —

    The number of documents to skip.

Returns:

  • (Mongo) —

    The context.



285
286
287
288
 
# File 'lib/mongoid/contextual/memory.rb', line 285

def skip(value)
  self.skipping = value
  self
end

#sort(values) ⇒ Mongo

Sorts the documents by the provided spec.

Examples:

Sort the documents.

context.sort(name: -1, title: 1)

Parameters:

  • values (Hash) —

    The sorting values as field/direction(1/-1) pairs.

Returns:

  • (Mongo) —

    The context.



299
300
301
 
# File 'lib/mongoid/contextual/memory.rb', line 299

def sort(values)
  in_place_sort(values) and self
end

#take(limit = nil) ⇒ Document

Take the given number of documents from the database.

Examples:

Take a document.

context.take

Parameters:

  • limit (Integer | nil) (defaults to: nil) —

    The number of documents to take or nil.

Returns:



196
197
198
199
200
201
202
 
# File 'lib/mongoid/contextual/memory.rb', line 196

def take(limit = nil)
  if limit
    eager_load(documents.take(limit))
  else
    eager_load([documents.first]).first
  end
end

#take! ⇒ Document

Take the given number of documents from the database.

Examples:

Take a document.

context.take

Returns:



213
214
215
216
217
218
219
 
# File 'lib/mongoid/contextual/memory.rb', line 213

def take!
  if documents.empty?
    raise Errors::DocumentNotFound.new(klass, nil, nil)
  else
    eager_load([documents.first]).first
  end
end

#tally(field) ⇒ Hash

Tally the field values in memory.

Examples:

Get the counts of values in memory.

context.tally(:name)

Parameters:

  • field (String | Symbol) —

    Field to tally.

Returns:

  • (Hash) —

    The hash of counts.



269
270
271
272
273
274
275
 
# File 'lib/mongoid/contextual/memory.rb', line 269

def tally(field)
  return documents.each_with_object({}) do |d, acc|
    v = retrieve_value_at_path(d, field)
    acc[v] ||= 0
    acc[v] += 1
  end
end

#update(attributes = nil) ⇒ nil, false

Update the first matching document atomically.

Examples:

Update the matching document.

context.update(name: "Smiths")

Parameters:

  • attributes (Hash) (defaults to: nil) —

    The new attributes for the document.

Returns:

  • (nil, false) —

    False if no attributes were provided.



311
312
313
 
# File 'lib/mongoid/contextual/memory.rb', line 311

def update(attributes = nil)
  update_documents(attributes, [ first ])
end

#update_all(attributes = nil) ⇒ nil, false

Update all the matching documents atomically.

Examples:

Update all the matching documents.

context.update_all(name: "Smiths")

Parameters:

  • attributes (Hash) (defaults to: nil) —

    The new attributes for each document.

Returns:

  • (nil, false) —

    False if no attributes were provided.



323
324
325
 
# File 'lib/mongoid/contextual/memory.rb', line 323

def update_all(attributes = nil)
  update_documents(attributes, entries)
end