跳至内容 跳至搜索
方法
E
F
I
L
M
S
T

常量

ONE_AS_ONE = "1 AS one"
 

实例公共方法

exists?(conditions = :none)

如果表中存在与给定的 id 或条件匹配的记录,则返回 true,否则返回 false。参数可以采用六种形式

  • Integer - 查找具有此主键的记录。

  • String - 查找具有对应于此字符串(例如 '5')的主键的记录。

  • Array - 查找与这些 where 样式条件匹配的记录(例如 ['name LIKE ?', "%#{query}%"])。

  • Hash - 查找与这些 where 样式条件匹配的记录(例如 {name: 'David'})。

  • false - 始终返回 false

  • 无参数 - 如果关系为空,则返回 false,否则返回 true

有关将条件指定为哈希或数组的更多信息,请参阅 ActiveRecord::Base 简介中的条件部分。

注意:您无法将条件作为字符串传入(例如 name = 'Jamie'),因为它将被清理,然后针对主键列进行查询,例如 id = 'name = \'Jamie\''

Person.exists?(5)
Person.exists?('5')
Person.exists?(['name LIKE ?', "%#{query}%"])
Person.exists?(id: [1, 4, 8])
Person.exists?(name: 'David')
Person.exists?(false)
Person.exists?
Person.where(name: 'Spartacus', rating: 4).exists?
# File activerecord/lib/active_record/relation/finder_methods.rb, line 349
    def exists?(conditions = :none)
      return false if @none

      if Base === conditions
        raise ArgumentError, <<-MSG.squish
          You are passing an instance of ActiveRecord::Base to `exists?`.
          Please pass the id of the object by calling `.id`.
        MSG
      end

      return false if !conditions || limit_value == 0

      if eager_loading?
        relation = apply_join_dependency(eager_loading: false)
        return relation.exists?(conditions)
      end

      relation = construct_relation_for_exists(conditions)
      return false if relation.where_clause.contradiction?

      skip_query_cache_if_necessary { connection.select_rows(relation.arel, "#{name} Exists?").size == 1 }
    end

fifth()

查找第五条记录。如果未定义顺序,它将按主键排序。

Person.fifth # returns the fifth object fetched by SELECT * FROM people
Person.offset(3).fifth # returns the fifth object from OFFSET 3 (which is OFFSET 7)
Person.where(["user_name = :u", { u: user_name }]).fifth
# File activerecord/lib/active_record/relation/finder_methods.rb, line 263
def fifth
  find_nth 4
end

fifth!()

fifth 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 269
def fifth!
  fifth || raise_record_not_found_exception!
end

find(*args)

按 ID 查找 - 这可以是特定 ID(ID)、ID 列表(ID、ID、ID)或 ID 数组([ID、ID、ID])。“ID”是指“标识符”。对于具有单列主键的模型,“ID”将是单个值,对于具有复合主键的模型,“ID”将是值数组。如果无法为请求的 ID 找到一个或多个记录,则将引发 ActiveRecord::RecordNotFound。如果主键是整数,则按 ID 查找会使用 to_i 来强制转换其参数。

Person.find(1)          # returns the object for ID = 1
Person.find("1")        # returns the object for ID = 1
Person.find("31-sarah") # returns the object for ID = 31
Person.find(1, 2, 6)    # returns an array for objects with IDs in (1, 2, 6)
Person.find([7, 17])    # returns an array for objects with IDs in (7, 17), or with composite primary key [7, 17]
Person.find([1])        # returns an array for the object with ID = 1
Person.where("administrator = 1").order("created_on DESC").find(1)

为复合主键模型查找记录

TravelRoute.primary_key = [:origin, :destination]

TravelRoute.find(["Ottawa", "London"])
=> #<TravelRoute origin: "Ottawa", destination: "London">

TravelRoute.find([["Paris", "Montreal"]])
=> [#<TravelRoute origin: "Paris", destination: "Montreal">]

TravelRoute.find(["New York", "Las Vegas"], ["New York", "Portland"])
=> [
     #<TravelRoute origin: "New York", destination: "Las Vegas">,
     #<TravelRoute origin: "New York", destination: "Portland">
   ]

TravelRoute.find([["Berlin", "London"], ["Barcelona", "Lisbon"]])
=> [
     #<TravelRoute origin: "Berlin", destination: "London">,
     #<TravelRoute origin: "Barcelona", destination: "Lisbon">
   ]

注意:返回的记录与您提供的 ID 顺序相同。如果您希望按数据库对结果进行排序,可以使用 ActiveRecord::QueryMethods#where 方法并提供一个显式的 ActiveRecord::QueryMethods#order 选项。但 ActiveRecord::QueryMethods#where 方法不会引发 ActiveRecord::RecordNotFound

使用锁查找

使用锁查找的示例:想象两个并发事务:每个事务都将读取 person.visits == 2,向其中添加 1,然后保存,从而将 person.visits = 3 保存两次。通过锁定行,第二个事务必须等到第一个事务完成;我们得到预期的 person.visits == 4

Person.transaction do
  person = Person.lock(true).find(1)
  person.visits += 1
  person.save!
end

find 的变体

Person.where(name: 'Spartacus', rating: 4)
# returns a chainable list (which can be empty).

Person.find_by(name: 'Spartacus', rating: 4)
# returns the first item or nil.

Person.find_or_initialize_by(name: 'Spartacus', rating: 4)
# returns the first item or returns a new instance (requires you call .save to persist against the database).

Person.find_or_create_by(name: 'Spartacus', rating: 4)
# returns the first item or creates it and returns it.

find 的替代方法

Person.where(name: 'Spartacus', rating: 4).exists?(conditions = :none)
# returns a boolean indicating if any record with the given conditions exist.

Person.where(name: 'Spartacus', rating: 4).select("field1, field2, field3")
# returns a chainable list of instances with only the mentioned fields.

Person.where(name: 'Spartacus', rating: 4).ids
# returns an Array of ids.

Person.where(name: 'Spartacus', rating: 4).pluck(:field1, :field2)
# returns an Array of the required fields.
# File activerecord/lib/active_record/relation/finder_methods.rb, line 90
def find(*args)
  return super if block_given?
  find_with_ids(*args)
end

find_by(arg, *args)

查找与指定条件匹配的第一条记录。没有隐含的排序,因此如果顺序很重要,您应该自己指定。

如果没有找到记录,则返回 nil

Post.find_by name: 'Spartacus', rating: 4
Post.find_by "published_at < ?", 2.weeks.ago
# File activerecord/lib/active_record/relation/finder_methods.rb, line 103
def find_by(arg, *args)
  where(arg, *args).take
end

find_by!(arg, *args)

find_by 类似,但如果没有找到记录,则会引发 ActiveRecord::RecordNotFound 错误。

# File activerecord/lib/active_record/relation/finder_methods.rb, line 109
def find_by!(arg, *args)
  where(arg, *args).take!
end

find_sole_by(arg, *args)

查找唯一的匹配记录。如果没有找到记录,则引发 ActiveRecord::RecordNotFound。如果找到多条记录,则引发 ActiveRecord::SoleRecordExceeded

Product.find_sole_by(["price = %?", price])
# File activerecord/lib/active_record/relation/finder_methods.rb, line 152
def find_sole_by(arg, *args)
  where(arg, *args).sole
end

first(limit = nil)

查找第一条记录(如果提供了参数,则查找前 N 条记录)。如果没有定义顺序,它将按主键排序。

Person.first # returns the first object fetched by SELECT * FROM people ORDER BY people.id LIMIT 1
Person.where(["user_name = ?", user_name]).first
Person.where(["user_name = :u", { u: user_name }]).first
Person.order("created_on DESC").offset(5).first
Person.first(3) # returns the first three objects fetched by SELECT * FROM people ORDER BY people.id LIMIT 3
# File activerecord/lib/active_record/relation/finder_methods.rb, line 165
def first(limit = nil)
  if limit
    find_nth_with_limit(0, limit)
  else
    find_nth 0
  end
end

first!()

first 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound。请注意,first! 不接受任何参数。

# File activerecord/lib/active_record/relation/finder_methods.rb, line 175
def first!
  first || raise_record_not_found_exception!
end

forty_two()

查找第 42 条记录。也称为访问“reddit”。如果没有定义顺序,它将按主键排序。

Person.forty_two # returns the forty-second object fetched by SELECT * FROM people
Person.offset(3).forty_two # returns the forty-second object from OFFSET 3 (which is OFFSET 44)
Person.where(["user_name = :u", { u: user_name }]).forty_two
# File activerecord/lib/active_record/relation/finder_methods.rb, line 279
def forty_two
  find_nth 41
end

forty_two!()

forty_two 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 285
def forty_two!
  forty_two || raise_record_not_found_exception!
end

fourth()

查找第四条记录。如果没有定义顺序,它将按主键排序。

Person.fourth # returns the fourth object fetched by SELECT * FROM people
Person.offset(3).fourth # returns the fourth object from OFFSET 3 (which is OFFSET 6)
Person.where(["user_name = :u", { u: user_name }]).fourth
# File activerecord/lib/active_record/relation/finder_methods.rb, line 247
def fourth
  find_nth 3
end

fourth!()

fourth 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 253
def fourth!
  fourth || raise_record_not_found_exception!
end

include?(record)

如果关系包含给定的记录,则返回 true,否则返回 false。

如果关系已加载,则不执行任何查询;将给定的记录与内存中的记录进行比较。如果关系已卸载,则执行高效的存在查询,如 exists?

别名:member?
# File activerecord/lib/active_record/relation/finder_methods.rb, line 377
def include?(record)
  # The existing implementation relies on receiving an Active Record instance as the input parameter named record.
  # Any non-Active Record object passed to this implementation is guaranteed to return `false`.
  return false unless record.is_a?(klass)

  if loaded? || offset_value || limit_value || having_clause.any?
    records.include?(record)
  else
    id = if record.class.composite_primary_key?
      record.class.primary_key.zip(record.id).to_h
    else
      record.id
    end

    exists?(id)
  end
end

last(limit = nil)

查找最后一条记录(如果提供了参数,则查找最后 N 条记录)。如果没有定义顺序,它将按主键排序。

Person.last # returns the last object fetched by SELECT * FROM people
Person.where(["user_name = ?", user_name]).last
Person.order("created_on DESC").offset(5).last
Person.last(3) # returns the last three objects fetched by SELECT * FROM people.

请注意,在后一种情况下,结果按升序排序

[#<Person id:2>, #<Person id:3>, #<Person id:4>]

而不是

[#<Person id:4>, #<Person id:3>, #<Person id:2>]
# File activerecord/lib/active_record/relation/finder_methods.rb, line 194
def last(limit = nil)
  return find_last(limit) if loaded? || has_limit_or_offset?

  result = ordered_relation.limit(limit)
  result = result.reverse_order!

  limit ? result.reverse : result.first
end

last!()

last 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound。请注意,last! 不接受任何参数。

# File activerecord/lib/active_record/relation/finder_methods.rb, line 205
def last!
  last || raise_record_not_found_exception!
end

member?(record)

别名:include?

second()

查找第二条记录。如果没有定义顺序,它将按主键排序。

Person.second # returns the second object fetched by SELECT * FROM people
Person.offset(3).second # returns the second object from OFFSET 3 (which is OFFSET 4)
Person.where(["user_name = :u", { u: user_name }]).second
# File activerecord/lib/active_record/relation/finder_methods.rb, line 215
def second
  find_nth 1
end

second!()

second 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 221
def second!
  second || raise_record_not_found_exception!
end

second_to_last()

查找倒数第二条记录。如果没有定义顺序,它将按主键排序。

Person.second_to_last # returns the second-to-last object fetched by SELECT * FROM people
Person.offset(3).second_to_last # returns the second-to-last object from OFFSET 3
Person.where(["user_name = :u", { u: user_name }]).second_to_last
# File activerecord/lib/active_record/relation/finder_methods.rb, line 311
def second_to_last
  find_nth_from_last 2
end

second_to_last!()

second_to_last 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 317
def second_to_last!
  second_to_last || raise_record_not_found_exception!
end

sole()

查找唯一的匹配记录。如果没有找到记录,则引发 ActiveRecord::RecordNotFound。如果找到多条记录,则引发 ActiveRecord::SoleRecordExceeded

Product.where(["price = %?", price]).sole
# File activerecord/lib/active_record/relation/finder_methods.rb, line 135
def sole
  found, undesired = first(2)

  if found.nil?
    raise_record_not_found_exception!
  elsif undesired.present?
    raise ActiveRecord::SoleRecordExceeded.new(self)
  else
    found
  end
end

take(limit = nil)

提供一条记录(如果提供了参数,则提供 N 条记录),没有任何隐式顺序。顺序取决于数据库实现。如果提供了顺序,则会遵循该顺序。

Person.take # returns an object fetched by SELECT * FROM people LIMIT 1
Person.take(5) # returns 5 objects fetched by SELECT * FROM people LIMIT 5
Person.where(["name LIKE '%?'", name]).take
# File activerecord/lib/active_record/relation/finder_methods.rb, line 120
def take(limit = nil)
  limit ? find_take_with_limit(limit) : find_take
end

take!()

take 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound。请注意,take! 不接受任何参数。

# File activerecord/lib/active_record/relation/finder_methods.rb, line 126
def take!
  take || raise_record_not_found_exception!
end

third()

查找第三条记录。如果没有定义顺序,则按主键排序。

Person.third # returns the third object fetched by SELECT * FROM people
Person.offset(3).third # returns the third object from OFFSET 3 (which is OFFSET 5)
Person.where(["user_name = :u", { u: user_name }]).third
# File activerecord/lib/active_record/relation/finder_methods.rb, line 231
def third
  find_nth 2
end

third!()

third 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 237
def third!
  third || raise_record_not_found_exception!
end

third_to_last()

查找倒数第三条记录。如果没有定义顺序,则按主键排序。

Person.third_to_last # returns the third-to-last object fetched by SELECT * FROM people
Person.offset(3).third_to_last # returns the third-to-last object from OFFSET 3
Person.where(["user_name = :u", { u: user_name }]).third_to_last
# File activerecord/lib/active_record/relation/finder_methods.rb, line 295
def third_to_last
  find_nth_from_last 3
end

third_to_last!()

third_to_last 相同,但如果没有找到记录,则引发 ActiveRecord::RecordNotFound

# File activerecord/lib/active_record/relation/finder_methods.rb, line 301
def third_to_last!
  third_to_last || raise_record_not_found_exception!
end