public class PlaceOrderServiceTests extends MockObjectTestCase{
Mockery context = new Mockery();
public void testUpdateRestaurant_good() throws Exception{
//setup
PlaceOrderService service = new PlaceOrderService();
final RestaurantRepository restaurantRepository = context.mock(RestaurantRepository.class);
final String restaurantId = "1";
final String pendingOrderId = "1";
//expectations
context.checking(new Expectations(){{
allowing(restaurantRepository).findRestaurant(restaurantId,pendingOrderId);
}});
//execute
service.updateRestaurant(restaurantId,pendingOrderId);
//verify
context.assertIsSatisfied();
}
}
然后分别建立相应的类和接口:
public interface RestaurantRepository {
Restaurant findRestaurant(String restaurantId, String pendingOrderId);
}
public class Restaurant {
}
public class PlaceOrderService {
public void updateRestaurant(String restaurantId, String pendingOrderId) {
// TODO Auto-generated method stub
}
}
在过dq中QY件开发h员对试的热情日渐低q同一时期出现的动态语aq没有提供编译程序来捕捉最基本的错误,q得测试变得更加重要。随着试C的成长,开发h员开始注意到Q除了捕?bug {最基本的优点外Q测试还h以下优势Q?/p>
有关试的优Ҏ(gu)需赘述Q我向(zhn)介l一个简单的使用 RSpec 的测试驱动开发示例。RSpec 工具是一?Ruby 软g包,可以用它构徏有关(zhn)的软g的规范。该规范实际上是一个描q系l行为的试。?RSpec 的开发流E如下:
实质上,RSpec 开发h员所做的工作是失败的试用例调试为成功的试用例。这是一个主动的q程。本文中Q我介l?RSpec 的基本用法?
首先Q假设?zhn)已安装?Ruby ?gems。?zhn)q需要安?RSpec。输入下面的内容Q?
gem install rspec
![]() ![]() |
接下来,我将逐步构徏一个状态机。我遵?TDD 规则。首先编写自q试用例Qƈ且直到测试用例需要时才编写代码。Rake 的创?Jim Weirich 认ؓq有助于角色扮演。在~写实际的生产代码时Q?zhn)希望充当一?jerk 开发h员的角色Q只完成最量的工作来使测试通过。在~写试Ӟ(zhn)则扮演试人员的角Ԍ试图为开发h员提供一些有益的帮助?/p>
以下的示例展CZ如何构徏一个状态机。如果?zhn)以前从未接触q状态机Q请查阅 参考资?/a>。状态机h多种状态。每U状态支持可以{换状态机状态的事g。测试驱动开发入门的关键是从零入手Q尽量少C用假设条件。针Ҏ(gu)试进行程序设计?/p>
使用清单 1 的内容创建名?machine_spec.rb 的文件。该文g是(zhn)的规范。?zhn)q不了解 machine.rb 文g的作用,目前先创Z个空文g?/p>
清单 1. 最初的 machine_spec.rb 文g
require 'machine' |
接下来,需要运行测试。始l通过输入 spec machine_spec.rb
q行试。清?2 展示了预料之中的试p|Q?/p>
清单 2. q行I的规范
~/rspec batate$ spec machine_spec.rb /opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:27:in `gem_original_require': no such file to load -- machine (LoadError) from /opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:27:in `require' from ./state_machine_spec.rb:1 from ... |
在测试驱动开发中Q?zhn)需要进行增量开发,因此在进行下一ơ开发前Q需要先解决此次试出现的问题。现在,我将扮演 jerk 开发h员的角色Q即只完成满_用程序运行所需的最工作量。我创Z个名?machine.rb 的空文gQɋ试通过。我现在可以以逸待劻I试通过而我几乎没做M事情?/p>
l箋角色扮演。我现在扮演一个烦w的试人员Q促?jerk 开发h员做些实际的工作。我编码以下规范,需要?Machine
c,如清?3 所C:
require 'machine' describe Machine do before :each do @machine = Machine end end |
该规范描qC目前不存在?Machine
cR?code>describe Ҏ(gu)提供?RSpec 描述Q?zhn)传入测试类的名U和包含实际规范的代码块。通常Q测试用例需要执行一定数量的讄工作。在 RSpec 中,由 before
Ҏ(gu)完成q些讄工作。?zhn)?before
Ҏ(gu)传递一个可选的标志和一个代码块。代码块中包含设|工作。标志确?RSpec 执行代码块的频率。默认的标志?:each
Q表C?RSpec 在每次试之前调用 set up 代码块。?zhn)也可以指?:all
Q表C?RSpec 在执行所有测试之前只调用一?before
代码块。?zhn)应该始终使?:each
Q各个试彼此独立?
输入 spec
q行试Q如清单 4 所C:
~/rspec batate$ spec machine_spec.rb ./machine_spec.rb:3: uninitialized constant Machine (NameError) |
现在Q烦w的试人员要促?jerk 开发h员做点什么了 ?jerk 开发h员现在需要创建某个类。对我来_是修复试出现的错误。在 machine.rb
中,我输入最量的代码,如清?5 所C:
class Machine end |
保存文gQ然后运行测试。毫无疑问,清单 6 昄的测试报告没有出现错误:
~/rspec batate$ spec machine_spec.rb Finished in 5.0e-06 seconds 0 examples, 0 failures |
![]() ![]() |
现在Q我可以开始实现更多的行ؓ。我知道Q所有状态机必须在某些初始状态下启动。目前我q不是很清楚如何设计q个行ؓQ因此我先编写一个非常简单的试Q首先假?state
Ҏ(gu)会返?:initial
标志。我?machine_spec.rb
q行修改q运行测试,如清?7 所C:
require 'machine' describe Machine do before :each do @machine = Machine.new end it "should initially have a state of :initial" do @machine.state.should == :initial end end ~/rspec batate$ spec machine_spec.rb F 1) NoMethodError in 'Machine should initially have a state of :initial' undefined method `state' for #<Machine:0x10c7f8c> ./machine_spec.rb:9: Finished in 0.005577 seconds 1 example, 1 failure |
注意q条规则Q?code> it "should initially have a state of :initial" do @machine.state.should == :initial end。首先注意到q条规则读v来像是一个英文句子。删除标点,得?it should initially have a state of initial
。然后会注意到这条规则ƈ不像是典型的面向对象代码。它实不是。?zhn)现在有一个方法,UCؓ it
。该Ҏ(gu)h一个用引hh的字W串参数和一个代码块。字W串应该描述试需求。最后,do
?end
之间的代码块包含试用例的代码?
可以看到Q测试进度划分得很细。这些微的步骤产生的收益却很大。它们我能够改q测试密度,提供旉供我思考期望的行ؓ以及实现行ؓ所需?API。这些步骤还能我在开发期间跟t代码覆盖情况,从而构建更加丰富的规范?/p>
q种风格的测试具有双重作用:试实现q在试的同时构建需求设计文档。稍后,我将通过试用例构徏一个需求列表?/p>
我用最单的方式修复了测试,q回 :initial
Q如清单 8 所C:
class Machine def state :initial end end |
当查看实现时Q?zhn)可能会放声大W或感觉受到了愚弄。对于测试驱动开发,(zhn)必ȝ微改变一下思考方式。?zhn)的目标ƈ不是~写最l的生代码Q至现在不是。?zhn)的目标是使测试通过。当掌握以这U方式工作时Q?zhn)可能会发现新的实玎ͼq且~写的代码要q远于采用 TDD 时编写的代码?/p>
下一步是q行代码Q查看它是否通过试Q?/p>
清单 9. q行初始状态测?/strong>
~/rspec batate$ spec machine_spec.rb . Finished in 0.005364 seconds 1 example, 0 failures |
׃旉思考一下这个通过试的P代。如果查看代码的话,(zhn)可能会觉得气馁。因为ƈ没有取得什么进展。如果查看整个P代,看到更多内容:(zhn)捕获了一个重要需求ƈ~写试用例实现需求。作Z名程序员Q我的第一个行为测试帮助我明确了开发过E。因为实现细节随着试的进行越来越清晰?/p>
现在Q我可以实现一个更健壮的状态实现。具体来Ԍ我需要处理状态机的多个状态。我需要创Z个新的规则获取有效状态列表。像以前一P我将q行试q查看是否通过?/p>
清单 10. 实现有效状态规?/strong>
it "should remember a list of valid states" do @machine.states = [:shopping, :checking_out] @machine.states.should = [:shopping, :checking_out] end run test(note: failing first verifies test) ~/rspec batate$ spec machine_spec.rb .F 1) NoMethodError in 'Machine should remember a list of valid states' undefined method `states=' for #<Machine:0x10c7154> ./machine_spec.rb:13: Finished in 0.005923 seconds 2 examples, 1 failure |
在清?10 中,出现了一?RSpec 形式的断a。该断言?should
Ҏ(gu)开始,然后d了一些比较关pR?code>should Ҏ(gu)对应用程序进行某U观察。工作中的应用程序应该以某种方式q行?code>should Ҏ(gu)很好地捕获了q种需求。在本例中,我的状态机应该记忆两种不同的状态?/p>
现在Q应该添加一个实例变量来实际记忆状态。像以往一P我在修改代码后运行测试用例,q观察测试是否成功?/p>
清单 11. 创徏一个属性以记忆状?/strong>
class Machine attr_accessor :states def state :initial end end ~/rspec batate$ spec machine_spec.rb .. Finished in 0.00606 seconds 2 examples, 0 failures |
![]() ![]() |
此时Q我q不惛_定将 :initial
状态称为状态机的第一个状态。相反,我更希望W一个状态是状态数l中的第一个元素。我对状态机的理解在不断演变。这U现象ƈ不少见。测试驱动开发经常迫使我重新考虑之前的假设。由于我已经通过试用例捕获了早期需求,我可以轻村֜对代码进行重构。在本例中,重构是对代码进行调_使其更好地工作?/p>
修改W一个测试,使其如清?12 所C,q运行测试:
it "should initially have a state of the first state" do @machine.states = [:shopping, :checking_out] @machine.state.should == :shopping end ~/rspec batate$ spec machine_spec.rb F. 1) 'Machine should initially have a state of the first state' FAILED expected :shopping, got :initial (using ==) ./machine_spec.rb:10: Finished in 0.005846 seconds 2 examples, 1 failure |
可以q样_试用例起到作用了,因ؓ它运行失败,因此我现在需要修改代码以使其工作。显而易见,我的d是使测试通过。我喜欢q种试目的Q因为我的测试用例正在驱动我q行设计。我把初始状态传递给 new
Ҏ(gu)。我对实现E作修改Q以W合修改后的规范Q如清单 13 所C?/p>
清单 13. 指定初始状?/strong>
start to fix it class Machine attr_accessor :states attr_reader :state def initialize(states) @states = states @state = @states[0] end end ~/rspec batate$ spec machine_spec.rb 1) ArgumentError in 'Machine should initially have a state of the first state' wrong number of arguments (0 for 1) ./machine_spec.rb:5:in `initialize' ./machine_spec.rb:5:in `new' ./machine_spec.rb:5: 2) ArgumentError in 'Machine should remember a list of valid states' wrong number of arguments (0 for 1) ./machine_spec.rb:5:in `initialize' ./machine_spec.rb:5:in `new' ./machine_spec.rb:5: Finished in 0.006391 seconds 2 examples, 2 failures |
现在Q测试出C一些错误。我扑ֈ了实C的一?bug。测试用例不再用正的接口Q因为我没有把初始状态传递给状态机。可以看刎ͼ试用例已经起到了保护作用。我q行了较大的更改Q测试就发现?bug。我们需要对试q行重构以匹配新的接口,初始状态列表传递给 new
Ҏ(gu)。在q里我ƈ没有重复初始化代码,而是其攄?before
Ҏ(gu)中,如清?14 所C:
require 'machine' describe Machine do before :each do @machine = Machine.new([:shopping, :checking_out]) end it "should initially have a state of the first state" do @machine.state.should == :shopping end it "should remember a list of valid states" do @machine.states.should == [:shopping, :checking_out] end end ~/rspec batate$ spec machine_spec.rb .. Finished in 0.005542 seconds 2 examples, 0 failures |
状态机开始逐渐成型。代码仍然有一些问题,但是正在向良好的方向演化。我开始对状态机q行一些{换。这些{换将促代码实际记忆当前状态?/p>
试用例促我全面地思?API 的设计。我需要知道如何表CZ件和转换。首先,我将使用一个散列表表示转换Q而没有用成熟的面向对象实现。随后,试需求可能会要求我修改假设条Ӟ但是目前Q我仍然保持q种单性。清?15 昄了修改后的代码:
remember events... change before conditions require 'machine' describe Machine do before :each do @machine = Machine.new([:shopping, :checking_out]) @machine.events = {:checkout => {:from => :shopping, :to => :checking_out}} end it "should initially have a state of the first state" do @machine.state.should == :shopping end it "should remember a list of valid states" do @machine.states.should == [:shopping, :checking_out] end it "should remember a list of events with transitions" do @machine.events.should == {:checkout => {:from => :shopping, :to => :checking_out}} end end ~/rspec batate$ spec machine_spec.rb FFF 1) NoMethodError in 'Machine should initially have a state of the first state' undefined method `events=' for #<Machine:0x10c6f38> ./machine_spec.rb:6: 2) NoMethodError in 'Machine should remember a list of valid states' undefined method `events=' for #z7lt;Machine:0x10c5afc> ./machine_spec.rb:6: 3) NoMethodError in 'Machine should remember a list of events with transitions' undefined method `events=' for #<Machine:0x10c4a58> ./machine_spec.rb:6: Finished in 0.006597 seconds 3 examples, 3 failures |
׃新的试代码位于 before
中,我的三个测试分解开来。尽如此,清单 16 中展C的试非常Ҏ(gu)修复。我添加另一个访问程序:
class Machine attr_accessor :states, :events attr_reader :state def initialize(states) @states = states @state = @states[0] end end ~/rspec batate$ spec machine_spec.rb ... Finished in 0.00652 seconds 3 examples, 0 failures test |
试全部通过。我得到了一个能正常q行的状态机。接下来的几个测试将使它更加完善?/p>
![]() ![]() |
目前为止Q我所做的不过是触发了一ơ状态{换,但是我已l做好了所有基工作。我得到了一l需求。我q构Z一l测试。我的代码可以ؓ状态机提供使用的数据。此Ӟ理单个状态机转换仅表CZơ简单的转换Q因此我添加如清单 17 所C的试Q?/p>
清单 17. 构徏状态机的状态{?/strong>
it "should transition to :checking_out upon #trigger(:checkout) event " do @machine.trigger(:checkout) @machine.state.should == :checking_out end ~/rspec batate$ spec machine_spec.rb ...F 1) NoMethodError in 'Machine should transition to :checking_out upon #trigger(:checkout) event ' undefined method `trigger' for #<Machine:0x10c4d00> ./machine_spec.rb:24: Finished in 0.006153 seconds 4 examples, 1 failure |
我需要抵制快速构建大量功能的诱惑。我应该只编写少量代码,只要使测试通过卛_。清?18 展示的P代将表示 API 和需求。这p够了Q?/p>
清单 18. 定义 trigger Ҏ(gu)
def trigger(event) @state = :checking_out end ~/rspec batate$ spec machine_spec.rb .... Finished in 0.005959 seconds 4 examples, 0 failures |
q里出现了一个有的Ҏ(gu)。在~写代码Ӟ我两ơ都弄错了这个简单的Ҏ(gu)。第一ơ我q回?:checkout
Q第二次我将状态设|ؓ :checkout
而不?:checking_out
。在试中用较?yu)的步骤可以为我节省大量旉Q因为测试用例ؓ我捕Lq些错误在将来的开发中很难捕获到。本文的最后一个步骤是实际执行一ơ状态机转换。在W一个示例中Q我q不兛_实际的机器状态是什么样子的。我仅仅是根据事件进行盲目{换,而不考虑状态?/p>
两节点的状态机无法执行q个操作Q我需要在W三个节点中构徏。我没有使用已有?before
Ҏ(gu)Q只是在新状态中d另外的状态。我在试用例中进行两ơ{换,以确保状态机能够正确地执行{换,如清?19 所C:
it "should transition to :success upon #trigger(:accept_card)" do @machine.events = { :checkout => {:from => :shopping, :to => :checking_out}, :accept_card => {:from => :checking_out, :to => :success} } @machine.trigger(:checkout) @machine.state.should == :checking_out @machine.trigger(:accept_card) @machine.state.should == :success end ~/rspec batate$ spec machine_spec.rb ....F 1) 'Machine should transition to :success upon #trigger(:accept_card)' FAILED expected :success, got :checking_out (using ==) ./machine_spec.rb:37: Finished in 0.007564 seconds 5 examples, 1 failure |
q个试?:checkout
?:accept_card
事g建立新的状态机。在处理{ևӞ我选择使用两个事g而不是一个,q样可以防止发生双命令。签Z码可以确保状态机在签Z前处?shopping
状态。第一ơ签出首先将状态机?shopping
转换?checking_out
。测试用例通过触发 checkout
?accept_card
事g实现两个转换Qƈ在调用事件之后检验事件状态是否正。与预期一P试用例p| ?我ƈ没有~写处理多个转换的触发器Ҏ(gu)。代码修正包含一行非帔R要的代码。清?20 展示了状态机的核心:
def trigger(event) @state = events[event][:to] end ~/rspec batate$ spec machine_spec.rb ..... Finished in 0.006511 seconds 5 examples, 0 failures |
试可以q行。这些粗p的代码W一ơ演变ؓ真正可以UC为状态机的东ѝ但是这q远q不够。目前,状态机~Z严密性。不状态如何,状态机都会触发事g。例如,当处?shopping
状态时Q触?:accept_card
q不会{换ؓ :success
状态。?zhn)只能够?:checking_out
状态触?:accept_card
。在~程术语中,trigger
Ҏ(gu)的范围应针对事g。我编写一个测试来解决问题Q然后修?bug。我编写一个负试Qnegative testQ,xa一个不应该出现的行为,如清?21 所C:
it "should not transition from :shopping to :success upon :accept_card" do @machine.events = { :checkout => {:from => :shopping, :to => :checking_out}, :accept_card => {:from => :checking_out, :to => :success} } @machine.trigger(:accept_card) @machine.state.should_not == :success end rspec batate$ spec machine_spec.rb .....F 1) 'Machine should not transition from :shopping to :success upon :accept_card' FAILED expected not == :success, got :success ./machine_spec.rb:47: Finished in 0.006582 seconds 6 examples, 1 failure |
现在可以再次q行试Q其中一个测试如预期一栯行失败。修复代码同样只有一行,如清?22 所C:
def trigger(event) @state = events[event][:to] if state == events[event][:from] end rspec batate$ spec machine_spec.rb ...... Finished in 0.006873 seconds 6 examples, 0 failures |
![]() ![]() |
现在Q我h一个可单运行的状态机。无Z哪方面来_它都不是一个完的E序。它q具有下面这些问题:
submit
?cancel
事g可能需要处于多个状态?
但是Q?zhn)q可以看刎ͼq个状态机已经能够满一些需求了。我q具备一个描q系l行为的文档Q这是进行一pd试的好L。每个测试用例都支持pȝ的一个基本需求。事实上Q通过q行 spec machine_spec.rb --format specdoc
Q?zhn)可以查看ql规范组成的基本报告Q如清单 23 所C:
spec machine_spec.rb --format specdoc Machine - should initially have a state of the first state - should remember a list of valid states - should remember a list of events with transitions - should transition to :checking_out upon #trigger(:checkout) event - should transition to :success upon #trigger(:accept_card) - should not transition from :shopping to :success upon :accept_card Finished in 0.006868 seconds |
试驱动Ҏ(gu)q不适合所有hQ但是越来越多的人开始用这U技术,使用它构建具有灵zL和适应性的高质量代码,q且Ҏ(gu)试从头构徏代码。当Ӟ(zhn)也可以通过其他框架Q如 test_unitQ获得相同的优点。RSpec q提供了优秀的实现方法。这U新试框架的一大亮点就是代码的表示。新手尤其可以从q种行ؓ驱动的测试方法中受益。请试使用该框架ƈ告诉我?zhn)的感受?/p>