Rails 实践第四章 Rails 中的模型深入模型查询

深入模型查询

概要:

本课时讲解模型在数据查询时,如何避免 N+1问题,使用 scope 包装查询条件,编写模型 Rspec 测试。

知识点:

  1. N+1
  2. Scope
  3. 实用的查询
  4. Rspec 测试

正文

4.2.1 两个 Gem

ActiveRecord 这个 gem 中,包含了两个重要的 gem,打开它的 源代码,可以看到这两个 gem:activemodel 和 arel。

activemodel 为一个类增加了许多特性,比如属性校验,回调等,这在后面章节会介绍。

arel 是 Ruby 编写的 sql 工具,使用它,可以通过简单的 Ruby 语法,编写复杂 sql 查询,我们上面使用的例子,语法就来自 arel。arel 还可以面向多种关系型数据库。

ActiveRecord 在使用 arel 的时候,提供了一个方法:sanitize_sql。

在我们以上的讲解中,会经常传递这样的参数 ["name = ? and price=?", "foobar", 4],它会由 sanitize_sql 方法进行处理,这是一个 protected 方法,我们使用 send 来调用它:

Product.send(:sanitize_sql, ["name = ? and price=?", "Shoes", 4])
=> "name = 'Shoes' and price=4"

这是一种安全的手段,保护我们的 sql 不会被插入恶意代码。我们不必去直接使用这个方法,除非特殊情况,我们只需要按照它的格式要求来书写就可以了。

4.2.2 N+1

N+1 是查询中经常遇到的一个问题。在下一节里,我们经常使用关联关系的查询,比如,列出十个用户的同时,显示它地址中的电话:

users = User.limit(10)
users.each do |user|
  puts user.address.phone
end

这样就会造成,在 each 中又去查询数据,得到电话。这种情况会经常出现在我的列表中,所以在列表中会经常遇到 N+1 的问题。

为了避免这个问题,Rails 提供了预加载的功能,在查询的时候,使用 includes 来解决。上面的例子修改一下:

users = User.includes(:address).limit(10)
users.each do |user|
  puts user.address.phone
end

我们查看一下终端的输出:

SELECT * FROM users LIMIT 10
SELECT addresses.* FROM addresses
  WHERE (addresses.user_id IN (1,2,3,4,5,6,7,8,9,10))

这里只有两个 sql 查询,提高了查询效率。

4.2.3 查询中使用 Scope

当我们使用 where 查询的时候,会遇到多个条件组合查询。通常我们可以把它们都写到一个 where 的条件里,比如:

Product.where(name: "T-Shirt", hot: true, top: true)

我增加了两个条件,hot: truetop: true,但是,这种条件组合只能在这里使用,在其他地方,我们还要再写一遍,这不符合 Rails 的哲学:“不要重复自己”。

Rails 提供了 scope,让我们复用查询条件:

class Product < ActiveRecord::Base
  scope :hot, -> { where(hot: true) }
  scope :top, -> { where(top: true) }
end

使用的时候,我们可以将多个 scope 组合在一起:

Product.top.hot.where(name: "T-Shirt")

default_scope 可以为所有查询加上它定义的查询条件,比如:

class Product < ActiveRecord::Base
  default_scope { where("deleted_at IS NULL") }
end

default_scope 要慎用,慎用,慎用(重要的话说三遍),在我们程序变的复杂的时候,性能往往会消耗在数据库查询上,维护已有查询时,很容易忽视 default_scope 的作用。如果使用了 default_scope,而在其他地方不得不去掉它,可以使用 unscoped,然后再附上其他查询:

Product.unscoped.load.top.hot

如果一个地方使用了某个 scope,而要在另一个地方把它的条件改变,可以使用 merge:

class Product < ActiveRecord::Base
  scope :active, -> { where state: 'active' }
  scope :inactive, -> { where state: 'inactive' }
end

看一下它的执行结果:

Product.active.merge(User.inactive)
# SELECT "products".* FROM "products" WHERE "products"."state" = 'inactive'

4.2.4 实用的查询

4.2.4.1 sql 查询集合

我们使用where查询,得到的是 ActiveRecord::Relation 实例,它的源代码在这里。阅读这里的代码,会让你学习到更多优雅的查询方法。在查询时,我们还可以使用 sql 直接查询,如果你更熟悉 sql 语法,可以这样来查询:

Client.find_by_sql("SELECT * FROM clients
  INNER JOIN orders ON clients.id = orders.client_id
  ORDER BY clients.created_at desc")
# =>  [
  #,
  #,
  # ...
]

这个例子来自这里。

它返回的是实例的集合,这在我们 Rails 内使用很方便,但是提供 json 格式的 api时,需要转换一下,不过我们可以用 select_all 查询,得到包含 hash 的 array:

Client.connection.select_all("SELECT first_name, created_at FROM clients WHERE id = '1'")
# => [
  {"first_name"=>"Rafael", "created_at"=>"2012-11-10 23:23:45.281189"},
  {"first_name"=>"Eileen", "created_at"=>"2013-12-09 11:22:35.221282"}
]

4.2.4.2 pluck

pluck 可以直接在 Relation 实例的基础上,使用 sql 的 select 方法,得到字段值的集合(Array),而不用把返回结果包装成 ActiveRecord 实例,再得到属性值。在查询属性集合时,pluck 的性能更高。

Client.where(active: true).pluck(:id)
 SELECT id FROM clients WHERE active = 1
 => [1, 2, 3]
Client.distinct.pluck(:role)
 SELECT DISTINCT role FROM clients
 => ['admin', 'member', 'guest']
Client.pluck(:id, :name)
 SELECT clients.id, clients.name FROM clients
 => [[1, 'David'], [2, 'Jeremy'], [3, 'Jose']]

ActiveRecord 有一个类似的方法,select,比较下两者的区别:

Product.select(:id, :name)
  Product Load (8.5ms)  SELECT "products"."id", "products"."name" FROM "products"
 => #]>
Product.pluck(:id, :name)
   (0.3ms)  SELECT "products"."id", "products"."name" FROM "products"
 => [[1, "f"]]

前者显示返回 AR 实例,然后取其属性值,后者直接读取数据库记录,返回数组。

pluck 只能用在查询的最后,因为它直接返回了结果,而不是 ActiveRecord::Relation。

4.2.4.3 ids

ids 返回主键集合:

Person.ids
=> SELECT id FROM people

不要被 ids 字面迷惑,它返回的是主键的集合,我们可以在 model 里设定其他字段为主键。

class Person < ActiveRecord::Base
  self.primary_key = "person_id"
end
Person.ids
=> SELECT person_id FROM people

4.2.4.4 查询记录数量

这里有四个方法,方便我们判断一个模型中的记录数量。

Client.exists?(1)
Client.exists?(id: [1,2,3])
Client.exists?(name: ['John', 'Sergei'])

exists? 判断记录是否存在,和它类似的方法有两个:

Client.exists? [1]
Client.any? [2]
Client.many? [3]

[1] 是否有记录[2] 是否至少有一条记录[3] 是否有多于一条的记录

any? 和 many? 与 exists? 不同的是,他们可以使用在 Relation 实例上,比如:

Article.where(published: true).any?
Article.where(published: true).many?

还可以接收 block:

person.pets.any? do |pet|
  pet.group == 'cats'
end
=> false
person.pets.many? do |pet|
  pet.group == 'dogs'
end
=> true

4.2.4.5 查询记录数量

下面五个方法,完全可以按照字面意义理解,并且适用于 Relation 上:

Client.count
Client.average("orders_count")
Client.minimum("age")
Client.maximum("age")
Client.sum("orders_count")

以上的例子来自 这里,闲暇的时候应该多读读这个文档,翻看源码。

4.2.5 Rspec 测试

在深入 Rails 项目开发之后,测试环节是一个重要的环节。Ruby 为我们提供了非常方便的测试框架,Rails 也可以方便的执行这些测试框架。

在 Rails 3.x 及之前的版本里,默认使用 TestUnit 框架,4.x 之后改为 MiniTest 框架。我们可以查看 test_case.rb 文件,看到其中的变化。

除了这两个测试框架,Rspec 也是经常用到的 Ruby 测试框架。

我们在 Rails 里安装 rpesc,和其他的几个 gem:

group :development, :test do
  gem 'rspec-rails'
  gem "factory_girl_rails"
  gem "database_cleaner"
end

rspec-rails 是 rspec 的 Rails 集成,在 Rails 中初始化 rspec 的命令是:

rails generate rspec:install

它会创建两个文件,和 spec 文件件。运行 rpsec 测试的命令非常简单,rspec 就可以,他会自动运行 spec 文件夹下所有的 xxx_spec.rb 文件,也可以指定某个文件:

rspec spec/models/product_spec.rb

也可以只运行某一个测试用例,这需要指定该用例开始的行数:

rspec spec/models/product_spec.rb:10

也可以运行某一个目录:

rspec spec/models/

factory_girl_rails 是 factory_girl 的 Rails 包装。factory_girl 可以为我们的测试代码提供模拟的测试数据。

database_cleaner 可以在每一次运行测试的时候,清空测试数据库。我们在 config/database.yml 中,会设置三种运行环境,test 环境要单独设置数据库,也就是因为测试时会反复填入和删除数据。一般,test 使用的是 sqlite 数据库,而 production 使用 mysql、postgresql 等数据库。

我们需要配置下 spec 的运行环境:

RSpec.configure do |config|
  config.before(:each) do
    DatabaseCleaner.strategy = :truncation
    DatabaseCleaner.clean
  end
end

4.2.5.1 Model 测试

在使用 generator 创建 model 文件的时候,rspec 会自动创建它对应的 spec 文件。我们打开 product_spec.rb 文件:

require 'rails_helper'
RSpec.describe Product, type: :model do
  pending "add some examples to (or delete) #{__FILE__}"
end

我们为它增加一个测试:

RSpec.describe Product, type: :model do
  it "should create a product" do
    tshirt = Product.create(name: "T-Shirt", price: 9.99)
    expect(tshirt.name).to eq("T-Shirt")
    expect(tshirt.price).to eq(9.99)
  end
end

运行一下这个测试:

rspec spec/models/product_spec.rb
.
Finished in 0.081 seconds (files took 2.37 seconds to load)
1 example, 0 failures

这个测试的目的,是确保 create 方法可以为我们创建一个 product 实例。更多 rspec 语法可以查看 rspec 文档,或者 《使用 RSpec 测试 Rails 程序》一书。