0 curl测试接口
curl GET http://localhost:3000/api/v1/stags?page=1
curl -X POST http://localhost:3000/api/v1/tags
添加请求头 -H ‘Content-Type: application/json'
添加消息体 -d ‘{“amount”: 99}’
1 安装RSpec
Category: Test Frameworks - The Ruby Toolbox (ruby-toolbox.com)
-
比较老牌的rails测试框架，应用的项目多
-
修复issue快，持续维护
-
pull request接受率高，接受大家的意见
-
单元测试内容
- 主要测controller，简单测M和V，不测Rails自带的功能
-
安装
rspec/rspec-rails at 6-0-maintenance (github.com)
- 将
gem 'rspec-rails', '~>5.0.0'复制到Gemfile中
1
2
3
4
|
group :development, :test do
gem "debug", platforms: %i[ mri mingw x64_mingw ]
gem 'rspec-rails', '~> 5.0.0'
end
|
-
运行bundle，安装依赖
-
初始化rspec：bin/rails g rspec:install
1
2
3
4
5
|
bin/rails g rspec:install
create .rspec
create spec
create spec/spec_helper.rb
create spec/rails_helper.rb
|
- 配置测试数据库
config/database.yml
1
2
3
4
5
6
7
8
|
...
test:
<<: *default
database: mangosteen_test
username: mangosteen
password: 123456
host: db-for-mangosteen
...
|
-
创建数据库：（也可以自己进入docker手动创建）RAILS_ENV=test bin/rails db:create
-
同步测试环境数据表：RAILS_ENV=test bin/rails db:migrate
-
创建user的model测试文件：bin/rails g rspec:model user
spec/models/user_spec.rb
1
2
3
4
5
6
7
8
9
10
11
|
# 一些辅助功能可以写在这里，例如登录功能
require 'rails_helper'
RSpec.describe User, type: :model do
it '有email' do
user = User.new email: 'gsq@zs.com'
# to be 相当于对比值是否相等
# to eq 相当于对比两个对象，当然也包括对象的地址
expect(user.email).to be 'gsq@zs.com'
end
end
|
- 运行单元测试：
bundle exe rspec
2 测试controller（items）
RSpec Rails 5.1 - RSpec Rails - RSpec - Relish (relishapp.com)
- 创建测试文件：
bin/rails g rspec:request items
spec/requests/items_spec.rb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
require 'rails_helper'
RSpec.describe "Items", type: :request do
# 每次测试用例运行完毕，都会自动清空数据表
describe "GET /items" do
it "能成功创建并分页返回数据" do
# 创建11条数据
11.times { Item.create amount: 99 }
# 此时期待数据库中有11条数据，表示创建成功
expect(Item.count).to eq 11
# 接下来构造请求
get '/api/v1/items'
# 期待状态码为200 即请求成功
expect(response).to have_http_status(200)
# 将返回数据反序列化
json = JSON.parse response.body
# 期待返回的数据条数为10(因为默认pageSize为10)，看是否成功返回
expect(json['resources'].size).to eq 10
# 同理测试分页接口
get '/api/v1/items?page=2'
expect(response).to have_http_status(200)
json = JSON.parse response.body
expect(json['resources'].size).to eq 1
end
end
describe 'POST /items' do
it '能够创建一条数据' do
# 测试是否在数据表中创建了一条数据 利用change
expect {
post '/api/v1/items', params: {amount: 99}
}.to change {Item.count}.by(+1)
expect(response).to have_http_status(201)
json = JSON.parse response.body
# 测试返回数据的值是否一致
expect(json['resource']['amount']).to eq(99)
# 是否有id（只能间接测试）
expect(json['resource']['id']).to be_an(Numeric)
end
end
end
|
3 BDD开发验证码的controller
（bin/rails console进入console模式进行测试）
1
2
3
4
|
# 方案一 直接rand方法，但是基于当前时间的随机数不够安全
rand.to_s[2..7]
# 方案二 SecureRandom方法生成十六进制的数字，再调用它的random_number方法转为随机十进制数字，最后截取
SecureRandom.random_number.to_s[2..7]
|
app/controllers/api/v1/validation_codes_controller.rb
1
2
3
4
5
6
7
8
9
10
11
12
|
class Api::V1::ValidationCodesController < ApplicationController
def create
validation_code = ValidationCode.new email: params[:email],
kind: 'log_in', code: SecureRandom.random_number.to_s[2..7]
if validation_code.save
head 200
else
render json: {errors: validation_code.errors}
end
# TODO:目前仅实现在数据库中创建了validation_code，真正的发送功能待实现
end
end
|
- 创建vallidation_codes的测试文件：
bin/rails g rspec:request validation_codes
spec/requests/validation_codes_spec.rb
1
2
3
4
5
6
7
8
9
10
11
12
|
require 'rails_helper'
RSpec.describe "ValidationCodes", type: :request do
describe "验证码" do
it "能够被发送" do
post '/api/v1/validation_codes', params: {
email: '845217811@qq.com'
}
expect(response).to have_http_status(200)
end
end
end
|