fixtures

在前面我们介绍了,rails的测试系统默认使用fixtures来创建模拟数据,这些数据以yaml的格式书写,放在db/fixtures文件夹中,每个model都有一个对应的文件,test/fixtures/users.yml。

在测试启动的时候这些fixtures中的数据会加载到测试数据库,并且加载到变量中,供单元测试和功能测试使用。

使用fixtures有几个不利的因素,使得他们处于不利的位置。

最主要的一个因素是,这些fixtures描述的数据和测试他们的行为是分开的,在不同的文件中。使用这些模拟数据,我们需要依赖于fixtures文件,这些文件很难阅读,维护不便。

假设我们需要两个user对象,用来测试我们的User.authenticate是否工作正常,我们需要编写下面的内容。

 
  
  1. bob: 
  2.   username: bob 
  3.   email: bob@example.com 
  4.   password_digest: 3488f5f7efecab14b91eb96169e5e1ee518a569f 
  5.   password_salt: bef65e058905c379436d80d1a32e7374b139e7b0 
  6.  
  7. admin: 
  8.   username: admin 
  9.   email: admin@example.com 
  10.   password_digest: 3488f5f7efecab14b91eb96169e5e1ee518a569f 
  11.   password_salt: bef65e058905c379436d80d1a32e7374b139e7b0 
  12.    

因为这两个数据需要存储到数据库中,我们的password_digest和password_salt需要是上面的样子,我们无法知道这两个属性的值具体代表什么意义,它们的内容到底是什么呢?

 

http://guides.rubyonrails.org/testing.html的最后面的部分,推荐了一个fixtures的替代品,那就是factory girl,它还有一个rails版本factory girl rails,专门用于rails的测试。

 

如何在rails中使用factory girl rails

https://github.com/thoughtbot/factory_girl/wiki有关于factory-girl使用的详细教程,基本上也适用于factory-girl-rails。

下面我们介绍一下基本的使用方法。

 

首先在gemfile文件中加入

 

 

 
  
  1. gem 'factory_girl_rails' 
然后执行
 
 
  
  1. bundle install 
然后再test目录创建factories.rb文件。这个文件的作用有点像我们使用fixtures的时候的yml文件,里面用来创建模拟数据。但是不同的是fixtures中的数据会被自动加入数据库,所以创建的时候声明的属性要和数据库匹配,是一种从数据库出发的模拟数据。但是factory-girl创建的模拟数据不会被自动加入数据库,是一种从model出发的模拟数据,所以声明的属性是和model对应的,所以不会出现使用fixtures的时候的哪种看不懂的password_digest属性值。
 
 
  
  1. FactoryGirl.define do 
  2.   factory :user do 
  3.     nickname "nickname" 
  4.     email "ee@123.com" 
  5.     password "123" 
  6.     password_confirmation "123" 
  7.   end 
  8. end 

 

上面factory-girl创建了一个user对象,这个对象也同样可以在测试用使用。请注意factory :后满的内容,这样要对应于一个model的类名,第一个字母最好小写,当然大写也是可以的。

还需要在使用这些数据的地方引入一个module。假如我们想要在user的单元测试中使用factory-girl的模拟数据,可以向下面这样添加这个module。

 
  
  1. class UserTest < ActiveSupport::TestCase 
  2.   include FactoryGirl::Syntax::Methods 
  3. end 

这样的话,我们就可以在user的单元测试中像下面这样使用这些模拟数据。

 
  
  1. # 保存user数据到数据库
  2. user = create(:user
  3.  
  4. # 不保存user数据,只是把它保存到user变量 
  5. user = build(:user
  6.  
  7. # 获取factory-girl中定义的user属性的键值对hash 
  8. user_attributes = attributes_for(:user
  9.  
  10. # 创建一个user的stub对象 
  11. user_stub = build_stubbed(:user
  12.  
  13. # 覆盖factory-girl中user对象的部分属性
  14. user = create(:user, first_name: 'Joe'

 

但是,如果我们有很多的model,都需要模拟数据,都写在factories.rb文件中,好像不太好,越写越长,而且内容混杂,也不好维护,也不利于阅读。

我们可以在创建test/factories文件夹,然后再test/factories文件夹中创建users.rb,在users.rb中写user的模拟数据。同样可以在factories文件夹中创建模拟其他model用的文件。

 

但是上面的factory-girl只是创建了一个user对象,如果需要多个模拟的user对象呢?可以像下面这样写,用:class => :User,来指定当前这个对象使用user的model为模板。

 
  
  1. FactoryGirl.define do 
  2.   factory :user1:class => :User do 
  3.     nickname "nickname" 
  4.     email "ee@123.com" 
  5.     password "123" 
  6.     password_confirmation "123" 
  7.   end 
  8.   factory :user2:class => :User do 
  9.     nickname "nickname2" 
  10.     email "ee2@123.com" 
  11.     password "1232" 
  12.     password_confirmation "123" 
  13.   end 
  14. end 

上面创建了两个user对象。可以像下面这样使用它们。

 
  
  1. def test_use_valid_user_from_factory_girl 
  2.    user = build(:user1
  3.    assert user.valid? 
  4.  end 
  5.  
  6.  def test_use_invalid_user_from_factory_girl 
  7.    user = build(:user2
  8.    assert user.invalid? 
  9.  end 

我已经在https://github.com/woaigithub/blog中加入了大量的unit test,大家可以参考,也可以提出意见,欢迎大家提意见!

 

 

参考文献

1.Factory-Girl

2.Factory-Girl-Rails