Module: Mongoid::Scopable::ClassMethods

Defined in:
lib/mongoid/scopable.rb

Overview

Since:

  • 4.0.0

Instance Method Summary collapse

Instance Method Details

#default_scopable? ⇒ true, false

Is the class able to have the default scope applied?

Examples:

Can the default scope be applied?

Band.default_scopable?

Returns:

  • (true, false) —

    If the default scope can be applied.

Since:

  • 3.0.0



103
104
105
 
# File 'lib/mongoid/scopable.rb', line 103

def default_scopable?
  default_scoping? && !Threaded.executing?(:without_default_scope)
end

#default_scope(value) ⇒ Proc

Add a default scope to the model. This scope will be applied to all criteria unless #unscoped is specified.

Examples:

Define a default scope with a criteria.

class Band
  include Mongoid::Document
  field :active, type: Boolean
  default_scope where(active: true)
end

Define a default scope with a proc.

class Band
  include Mongoid::Document
  field :active, type: Boolean
  default_scope ->{ where(active: true) }
end

Parameters:

  • scope (Proc, Criteria) —

    The default scope.

Returns:

  • (Proc) —

    The default scope.

Raises:

Since:

  • 1.0.0



90
91
92
93
 
# File 'lib/mongoid/scopable.rb', line 90

def default_scope(value)
  check_scope_validity(value)
  self.default_scoping = process_default_scope(value)
end

#queryable ⇒ Criteria

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Get a queryable, either the last one on the scope stack or a fresh one.

Examples:

Get a queryable.

Model.queryable

Returns:

Since:

  • 3.0.0



117
118
119
 
# File 'lib/mongoid/scopable.rb', line 117

def queryable
  scope_stack.last || Criteria.new(self)
end

#scope(name, value, &block) ⇒ Object

Create a scope that can be accessed from the class level or chained to criteria by the provided name.

Examples:

Create named scopes.


class Person
  include Mongoid::Document
  field :active, type: Boolean
  field :count, type: Integer

  scope :active, -> { where(active: true) }
  scope :at_least, ->(count){ where(:count.gt => count) }
end

Parameters:

  • name (Symbol) —

    The name of the scope.

  • conditions (Proc) —

    The conditions of the scope.

Raises:

Since:

  • 1.0.0



142
143
144
145
146
147
148
149
150
151
 
# File 'lib/mongoid/scopable.rb', line 142

def scope(name, value, &block)
  normalized = name.to_sym
  check_scope_validity(value)
  check_scope_name(normalized)
  _declared_scopes[normalized] = {
    scope: value,
    extension: Module.new(&block)
  }
  define_scope_method(normalized)
end

#scope_stack ⇒ Array<Criteria>

Initializes and returns the current scope stack.

Examples:

Get the scope stack.

Person.scope_stack

Returns:

  • (Array<Criteria>) —

    The scope stack.

Since:

  • 1.0.0



161
162
163
 
# File 'lib/mongoid/scopable.rb', line 161

def scope_stack
  Threaded.scope_stack[object_id] ||= []
end

#scoped(options = nil) ⇒ Criteria

Note:

This will force the default scope to be applied.

Get a criteria for the document with normal scoping.

Examples:

Get the criteria.

Band.scoped(skip: 10)

Parameters:

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

    Query options for the criteria.

Options Hash (options):

  • :skip (Integer) —

    Optional number of documents to skip.

  • :limit (Integer) —

    Optional number of documents to limit.

  • :sort (Array) —

    Optional sorting options.

Returns:

Since:

  • 3.0.0



182
183
184
 
# File 'lib/mongoid/scopable.rb', line 182

def scoped(options = nil)
  queryable.scoped(options)
end

#scopes ⇒ Hash

Returns a hash of all the scopes defined for this class, including scopes defined on ancestor classes.

Examples:

Get the defined scopes for a class

class Band
  include Mongoid::Document
  field :active, type: Boolean

  scope :active, -> { where(active: true) }
end
Band.scopes

Returns:

  • (Hash) —

    The scopes defined for this class

Since:

  • 3.1.4



56
57
58
59
60
61
62
63
64
 
# File 'lib/mongoid/scopable.rb', line 56

def scopes
  defined_scopes = {}
  ancestors.reverse.each do |klass|
    if klass.respond_to?(:_declared_scopes)
      defined_scopes.merge!(klass._declared_scopes)
    end
  end
  defined_scopes.freeze
end

#unscoped ⇒ Criteria, Object

Note:

This will force the default scope to be removed.

Get the criteria without the default scoping applied.

Examples:

Get the unscoped criteria.

Band.unscoped

Yield to block with no default scoping.

Band.unscoped do
  Band.where(name: "Depeche Mode")
end

Returns:

  • (Criteria, Object) —

    The unscoped criteria or result of the block.

Since:

  • 3.0.0



202
203
204
205
206
207
208
209
210
 
# File 'lib/mongoid/scopable.rb', line 202

def unscoped
  if block_given?
    without_default_scope do
      yield(self)
    end
  else
    queryable.unscoped
  end
end

#with_default_scope ⇒ Criteria Also known as: criteria

Get a criteria with the default scope applied, if possible.

Examples:

Get a criteria with the default scope.

Model.with_default_scope

Returns:

Since:

  • 3.0.0



220
221
222
 
# File 'lib/mongoid/scopable.rb', line 220

def with_default_scope
  queryable.with_default_scope
end

#with_scope(criteria) ⇒ Criteria

Pushes the provided criteria onto the scope stack, and removes it after the provided block is yielded.

Examples:

Yield to the criteria.

Person.with_scope(criteria)

Parameters:

  • criteria (Criteria) —

    The criteria to apply.

Returns:

Since:

  • 1.0.0



236
237
238
239
240
241
242
243
 
# File 'lib/mongoid/scopable.rb', line 236

def with_scope(criteria)
  scope_stack.push(criteria)
  begin
    yield criteria
  ensure
    scope_stack.pop
  end
end

#without_default_scope ⇒ Object

Execute the block without applying the default scope.

Examples:

Execute without the default scope.

Band.without_default_scope do
  Band.where(name: "Depeche Mode")
end

Returns:

  • (Object) —

    The result of the block.

Since:

  • 3.0.0



255
256
257
258
259
260
 
# File 'lib/mongoid/scopable.rb', line 255

def without_default_scope
  Threaded.begin_execution("without_default_scope")
  yield
ensure
  Threaded.exit_execution("without_default_scope")
end