класс ActiveRecord::QueryMethods::WhereChain

Родитель:: Объект

WhereChain объекты служат в качестве заглушки для запросов, в которых у where нет параметров. В этом случае, where необходимо объединить с not, чтобы вернуть новое отношение.

Методы класса

new(scope) Показать исходный код

# File activerecord/lib/active_record/relation/query_methods.rb, line 16
def initialize(scope)
  @scope = scope
end

Методы экземпляра

associated(*associations) Показать исходный код

# File activerecord/lib/active_record/relation/query_methods.rb, line 69
def associated(*associations)
  associations.each do |association|
    reflection = @scope.klass._reflect_on_association(association)
    @scope.joins!(association)
    self.not(reflection.table_name => { reflection.association_primary_key => nil })
  end

  @scope
end

Возвращает новое отношение с объединениями и условием where для определения связанных отношений.

Например, публикации, связанные с автором:

Post.where.associated(:author)
# SELECT "posts".* FROM "posts"
# INNER JOIN "authors" ON "authors"."id" = "posts"."author_id"
# WHERE "authors"."id" IS NOT NULL

Кроме того, можно объединить несколько отношений. Это вернёт публикации, связанные как с автором, так и с комментариями:

Post.where.associated(:author, :comments)
# SELECT "posts".* FROM "posts"
# INNER JOIN "authors" ON "authors"."id" = "posts"."author_id"
# INNER JOIN "comments" ON "comments"."post_id" = "posts"."id"
# WHERE "authors"."id" IS NOT NULL AND "comments"."id" IS NOT NULL

missing(*associations) Показать исходный код

# File activerecord/lib/active_record/relation/query_methods.rb, line 97
def missing(*associations)
  associations.each do |association|
    reflection = @scope.klass._reflect_on_association(association)
    unless reflection
      raise ArgumentError.new("An association named `:#{association}` does not exist on the model `#{@scope.name}`.")
    end
    @scope.left_outer_joins!(association)
    @scope.where!(reflection.table_name => { reflection.association_primary_key => nil })
  end

  @scope
end

Возвращает новое отношение с левыми внешними объединениями и условием where для определения отсутствующих отношений.

Например, публикации, у которых отсутствует связанный автор:

Post.where.missing(:author)
# SELECT "posts".* FROM "posts"
# LEFT OUTER JOIN "authors" ON "authors"."id" = "posts"."author_id"
# WHERE "authors"."id" IS NULL

Кроме того, можно объединить несколько отношений. Это вернёт публикации, у которых отсутствуют как автор, так и комментарии:

Post.where.missing(:author, :comments)
# SELECT "posts".* FROM "posts"
# LEFT OUTER JOIN "authors" ON "authors"."id" = "posts"."author_id"
# LEFT OUTER JOIN "comments" ON "comments"."post_id" = "posts"."id"
# WHERE "authors"."id" IS NULL AND "comments"."id" IS NULL

not(opts, *rest) Показать исходный код

# File activerecord/lib/active_record/relation/query_methods.rb, line 43
def not(opts, *rest)
  where_clause = @scope.send(:build_where_clause, opts, rest)

  @scope.where_clause += where_clause.invert

  @scope
end

Возвращает новое отношение, выражающее условие WHERE + NOT в соответствии с условиями в аргументах.

not принимает условия в виде строки, массива или хэша. Подробнее об каждом формате см. QueryMethods#where.

User.where.not("name = 'Jon'")
# SELECT * FROM users WHERE NOT (name = 'Jon')

User.where.not(["name = ?", "Jon"])
# SELECT * FROM users WHERE NOT (name = 'Jon')

User.where.not(name: "Jon")
# SELECT * FROM users WHERE name != 'Jon'

User.where.not(name: nil)
# SELECT * FROM users WHERE name IS NOT NULL

User.where.not(name: %w(Ko1 Nobu))
# SELECT * FROM users WHERE name NOT IN ('Ko1', 'Nobu')

User.where.not(name: "Jon", role: "admin")
# SELECT * FROM users WHERE NOT (name == 'Jon' AND role == 'admin')