跳至内容 跳至搜索

Active Record 结果 ↑

此类封装了调用任何数据库连接适配器上的 #exec_query 方法后返回的结果。例如：

result = ActiveRecord::Base.lease_connection.exec_query('SELECT id, title, body FROM posts')
result # => #<ActiveRecord::Result:0xdeadbeef>

# Get the column names of the result:
result.columns
# => ["id", "title", "body"]

# Get the record values of the result:
result.rows
# => [[1, "title_1", "body_1"],
      [2, "title_2", "body_2"],
      ...
     ]

# Get an array of hashes representing the result (column => value):
result.to_a
# => [{"id" => 1, "title" => "title_1", "body" => "body_1"},
      {"id" => 2, "title" => "title_2", "body" => "body_2"},
      ...
     ]

# Get the number of rows affected by the query:
result = ActiveRecord::Base.lease_connection.exec_query('INSERT INTO posts (title, body) VALUES ("title_3", "body_3"), ("title_4", "body_4")')
result.affected_rows
# => 2

# ActiveRecord::Result also includes Enumerable.
result.each do |row|
  puts row['title'] + " " + row['body']
end
命名空间
方法
#
C
E
I
L
N
T
包含的模块

Attributes

[R] affected_rows
[R] columns
[R] rows

类公共方法

new(columns, rows, column_types = nil, affected_rows: nil)

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 107
def initialize(columns, rows, column_types = nil, affected_rows: nil)
  # We freeze the strings to prevent them getting duped when
  # used as keys in ActiveRecord::Base's @attributes hash
  @columns      = columns.each(&:-@).freeze
  @rows         = rows
  @hash_rows    = nil
  @column_types = column_types.freeze
  @types_hash   = nil
  @column_indexes = nil
  @affected_rows = affected_rows
end

实例公共方法

[](idx)

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 155
def [](idx)
  hash_rows[idx]
end

column_types()

返回所有列的 ActiveRecord::Type 类型。请注意，并非所有数据库适配器都会返回结果类型，因此该哈希可能为空。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 167
def column_types
  if @column_types
    @types_hash ||= begin
      types = {}
      @columns.each_with_index do |name, index|
        type = @column_types[index] || Type.default_value
        types[name] = types[index] = type
      end
      types.freeze
    end
  else
    EMPTY_HASH
  end
end

each(&block)

对行集合中的每个元素调用一次给定块，并将行作为参数传递。每一行都是一个类哈希、只读对象。

要获取真实的哈希，请使用 .to_a.each。

如果未提供块，则返回一个 Enumerator。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 135
def each(&block)
  if block_given?
    hash_rows.each(&block)
  else
    hash_rows.to_enum { @rows.size }
  end
end

empty?()

如果没有记录，则返回 true，否则返回 false。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 144
def empty?
  rows.empty?
end

includes_column?(name)

如果此结果集包含名为 name 的列，则返回 true。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 120
def includes_column?(name)
  @columns.include? name
end

initialize_copy(other)

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 216
def initialize_copy(other)
  @rows = rows.dup
  @hash_rows    = nil
end

last(n = nil)

返回行集合中的最后一条记录。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 160
def last(n = nil)
  n ? hash_rows.last(n) : hash_rows.last
end

length()

返回行数组中的元素数量。

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 125
def length
  @rows.length
end

to_a()

别名： to_ary

to_ary()

返回一个表示每条记录的哈希数组。

也别名为： to_a

来源： 显示 | 在 GitHub 上

# File activerecord/lib/active_record/result.rb, line 149
def to_ary
  hash_rows
end