модуль ActiveRecord::Scoping::Default::ClassMethods

Возвращает область видимости для модели без default_scope.

class Post < ActiveRecord::Base
  def self.default_scope
    where published: true
  end
end

Post.all          # Fires "SELECT * FROM posts WHERE published = true"
Post.unscoped.all # Fires "SELECT * FROM posts"

Этот метод также принимает блок. Все запросы внутри блока не будут использовать default_scope:

Post.unscoped {
  Post.limit(10) # Fires "SELECT * FROM posts LIMIT 10"
}

# File activerecord/lib/active_record/scoping/default.rb, line 31
def unscoped
  block_given? ? relation.scoping { yield } : relation
end

Используйте эту макрокоманду в вашей модели для установки области видимости по умолчанию для всех операций с моделью.

class Article < ActiveRecord::Base
  default_scope { where(published: true) }
end

Article.all # => SELECT * FROM articles WHERE published = true

Область видимости по умолчанию также применяется при создании/создании записи. Она не применяется при обновлении записи.

Article.new.published    # => true
Article.create.published # => true

(Вы также можете передать любой объект, который отвечает на call, в макрос default_scope, и он будет вызван при построении области видимости по умолчанию.)

Если вы используете несколько объявлений default_scope в вашей модели, они будут объединены вместе:

class Article < ActiveRecord::Base
  default_scope { where(published: true) }
  default_scope { where(rating: 'G') }
end

Article.all # => SELECT * FROM articles WHERE published = true AND rating = 'G'

Это также относится к наследованию и включению модулей, где родительский класс или модуль определяет default_scope, а дочерний или включающий класс определяет второе.

Если вам нужно выполнить более сложные действия с областью видимости по умолчанию, вы можете альтернативно определить её как метод класса:

class Article < ActiveRecord::Base
  def self.default_scope
    # Should return a scope, you can call 'super' here etc.
  end
end

# File activerecord/lib/active_record/scoping/default.rb, line 82
def default_scope(scope = nil)
  scope = Proc.new if block_given?

  if scope.is_a?(Relation) || !scope.respond_to?(:call)
    raise ArgumentError,
      "Support for calling #default_scope without a block is removed. For example instead "                "of `default_scope where(color: 'red')`, please use "                "`default_scope { where(color: 'red') }`. (Alternatively you can just redefine "                "self.default_scope.)"
  end

  self.default_scopes += [scope]
end