《验收测试驱动开发：ATDD实例详解》—第2章2.2节结对完成第一个测试

本节书摘来自异步社区《验收测试驱动开发：ATDD实例详解》一书中的第2章2.2节结对完成第一个测试，作者【德】Markus Gärtner，更多章节内容可以访问云栖社区“异步社区”公众号查看。

2.2　结对完成第一个测试
验收测试驱动开发：ATDD实例详解
Tony和Alex开始结对写实现代码并对第一个测试进行自动化。Alex已经为网站做好了第一个布局，他向Tony介绍了他的想法。

Alex：嘿，Tony，你有兴趣看看停车费计算器的进展吗？

Tony：其实我想跟你结对儿，对第一个测试进行自动化。

Alex：哦，太好了，你从哪个开始的？

Tony：代客泊车，我花了30分钟引入了第一个测试，过来之前我刚把第一个挂起的实例提交了。

Alex：很好，我先给你看看我这边的完成情况。

Alex给Tony展示了他对页面布局的初始设计（见图2-3）。

Tony：看起来不错。看看这个，现在这些步骤定义还是挂起的，我们需要解决它们。

Alex：好的，这些看起来并不复杂。我们从下拉菜单选择停车场开始吧。这里我用的id是ParkingLot，所以从下拉菜单选择合适的值一步就可以做到，就像这样。

Alex实现了lib/parkcalc.rb文件中的select方法，如程序清单2-11所示。

程序清单2-11　从下拉菜单中选择正确的停车场

1　 def select(parking_lot)
2　　 @page.select 'ParkingLot', parking_lot
3　 end

Tony：好的，看起来很直观。我从id为ParkingLot的元素上选择了传入参数代表的停车场。很好，那么输入停车时间呢？

Alex：这需要更多的思考，我们用Ruby里的hash（散列表）来实现吧。以后你就可以扩展这些停入和离开的日期和时间值，然后模拟你所需要的所有不同的时长。

Tony：那咱们应该怎么做呢？

Alex：基本上我们根据传入的时长字符串查找实际的停入日期、停入时间、上午还是下午、离开日期、离开时间以及离开是上午还是下午的值，并将它们填入页面。这6个值代表了我构造的表单中的6个项。不过我们先来定义这个散列表（hashmap）。

Alex在ParkCalcPage类的开头构造了一个时长的散列表（见程序清单2-12）。

程序清单2-12　记录时长和实际日期时间的散列表

1　 @@durationMap = {
2　　　'30 minutes' => ['05/04/2010', '12:00', 'AM', '05/04/2010'
　　　 , '12:30', 'AM']
3　 }

Tony：两个@说明durationMap是一个类变量，对吧？

Alex：对的，现在我们要从散列表中得到我们关心的那6个值，我演示给你看如何从散列表中取值。

Alex开始实现enter_parking_duartion函数（见程序清单2-13）。

程序清单2-13　从durationMap得到表单的6个参数

1　 def enter_parking_duration(duration)
2　　 startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　 leavingTime, leavingTimeAMPM = @@durationMap[duration]
3　 end

Alex：现在，让我们把这些值填入表单。我们从停入日期和时间开始。

如程序清单2-14所示，Alex继续扩充这个方法，填入停车的时长。

程序清单2-14　将停入日期和时间填入对应的表单项

1　 def enter_parking_duration(duration)
2　　 startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　 leavingTime, leavingTimeAMPM = @@durationMap[duration]
3　　 @page.type 'StartingDate', startingDate
4　　 @page.type 'StartingTime', startingTime
5　　 @page.click "//input[@name='StartingTimeAMPM' and @value
　　　='%s']" % startingTimeAMPM
6　 end

Tony：你能解释一下吗？我看不懂最后一行。

Alex：我解释一下这里的细节。首先我们以时长为键值从散列表中取出6个参数，然后我们填入相应的停入日期和时间。

Tony：对，这很直观。但是最后那行乱七八糟的东西是干什么的？

Alex：我用它来定位单选按钮。这是个xpath路径，表示单选按钮所在位置和它的值。它告诉驱动程序点击名为“StartingTimeAMPM”且值为输入参数的按钮。

Tony：我希望能把它放在别的地方。它包含太多技术细节，不适合放在这个相对抽象的函数里。

Alex：我想你是对的，Tony。我们把它记下来，先完成这个函数再说。离开日期和时间还没有呢。和停入时间类似。不过我们先看看现在能否正常运行。

Alex开始执行这个测试，Alex和Tony一起看着浏览器窗口被打开，进入停车场计算页面，填入停车场、停入日期和时间值。最后浏览器被关闭，运行结果显示出来。

Tony：看起来不错，我们继续处理时长吧。我们还需要填入离开日期和时间。

Alex：当然，代码和填入停入日期和时长类似。我们把代码复制、粘贴过来，然后改一下变量名。如果这能运行，我们再回过头来清理代码。

Alex继续向函数中添加代码，填入离开日期和时间（见程序清单2-15）。

程序清单2-15　在刚才的函数中加入离开日期和时间

1　 def enter_parking_duration(duration)
 2　　 startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　 leavingTime, leavingTimeAMPM = @@durationMap[duration]
 3　　 @page.type 'StartingDate', startingDate
 4　　 @page.type 'StartingTime', startingTime
 5　　 @page.click "//input[@name='StartingTimeAMPM' and @value
　　　 ='%s']" % startingTimeAMPM
 6
 7　　 @page.type 'LeavingDate', leavingDate
 8　　 @page.type 'LeavingTime', leavingTime
 9　　 @page.click "//input[@name='LeavingTimeAMPM' and @value='%
　　　 s']" % leavingTimeAMPM
10　 end

Tony和Alex运行这些步骤，检查是否正确填入了离开日期和时间。

Alex：很好，能运行。我们现在来清理吧。这两部分代码看起来真的很类似。咱们把它放入一个单独函数中吧。

Alex和Tony写了一个新函数用来填写停入或离开的日期、时间，并逐步替换了原函数的实现。每做一点小的改动他们都会验证第一个测试还能正常运行。他们完成后，代码如程序清单2-16所示。

程序清单2-16　将填入停车时长抽取为单独函数

1　 def enter_parking_duration(duration)
 2　　 startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　　leavingTime, leavingTimeAMPM = @@durationMap[duration]
 3　　 fill_in_date_and_time_for 'Starting', startingDate,
　　　　startingTime, startingTimeAMPM
 4　　 fill_in_date_and_time_for 'Leaving', leavingDate,
　　　　leavingTime, leavingTimeAMPM
 5　 end
 6
 7　 def fill_in_date_and_time_for(formPrefix, date, time, ampm)
 8　　 @page.type "%sDate" % formPrefix, date
 9　　 @page.type "%sTime" % formPrefix, time
10　　 @page.click "//input[@name='%sTimeAMPM' and @value='%s']"
　　　　% [ formPrefix, ampm ]
11　 end

Alex：现在，我们来看一下如何提取那些怪异的xpath路径。

Tony：把它声明为一个常量表达式如何？

Alex：我也是这么想的。同时我还想把其他固定的字符串也放入变量里，这样将来我们就可以很容易地修改它们了。我们一个一个来提取吧。我们先来消除掉xpath。我们需要给这个变量取个名字，你说叫什么好呢？

Tony：叫"amPMRadioButtonTemplate"如何？

Alex：我没意见。我们以后是不是可以把日期和时间字符串也放进timeTemplate和dateTemplate？

Tony：听起来不错。我们同样可以把前缀放入startingPrefix和leavingPrefix.

Alex：对的，我还想把停车场的ID也放入一个常量中去。

Tony：现在看起来就很好了。

程序清单2-17展示了ParkCalcPage类在Alex和Tony提取常量之后的最终版本。现在，初始化步骤就完成了。

程序清单2-17　ParkCalcPage初始化步骤的最终版本

1 class ParkCalcPage
 2
 3　 @@lotIdentifier = 'ParkingLot'
 4　 @@startingPrefix = 'Starting'
 5　 @@leavingPrefix = 'Leaving'
 6　 @@dateTemplate = "%sDate"
 7　 @@timeTemplate = "%sTime"
 8　 @@amPMRadioButtonTemplate = "//input[@name='%sTimeAMPM' and
　　　 @value='%s']"
 9
10　 @@durationMap = {
11　　 '30 minutes' => ['05/04/2010', '12:00', 'AM', '05/04/2010'
　　　 , '12:30', 'AM']
12　 }
13
14　 attr :page
15
16　 def initialize(page_handle)
17　　 @page = page_handle
18　　 @page.open '/parkcalc'
19　 end
20
21　 def select(parking_lot)
22　　 @page.select @@lotIdentifier, parking_lot
23　 end
24
25　 def enter_parking_duration(duration)
26　　　startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　　 leavingTime, leavingTimeAMPM = @@durationMap[duration]
27　　　fill_in_date_and_time_for @@startingPrefix, startingDate,
　　　　startingTime, startingTimeAMPM
28　　　fill_in_date_and_time_for @@leavingPrefix, leavingDate,
　　　　leavingTime, leavingTimeAMPM
29　 end
30
31　 def fill_in_date_and_time_for(formPrefix, date, time, ampm)
32　　　@page.type @@dateTemplate % formPrefix, date
33　　　@page.type @@timeTemplate % formPrefix, time
34　　　@page.click @@amPMRadioButtonTemplate % [ formPrefix,
　　　　 ampm ]
35　 end
36
37 end

2.2.2　检查结果
Tony：现在我们来检查一下输出。我们还没有点击你在表单里放的Calculate按钮，并且我们需要从页面中获取费用的计算结果。

Alex：当然，我们先把pending语句从步骤定义中去掉，这样我们的定义的Then部分就可以运行了。

Tony： 噢！我差点就把这个忘了，要不然我得花半天时间才能搞清出了什么毛病。

Alex：这就是结对的好处，不是吗？

Tony：那么现在我们可以把pending语句从检查中去掉，然后我们来实现它。

Alex：好的。现在我们来看看怎么检查正确的价格。首先，我们需要点击计算按钮。我想把这作为第一步加入parking_costs函数，放在返回费用之前。之后我们需要等待页面载入新的值。然后我们获取记录费用的元素并返回它。

Alex实现了parking_costs函数，见程序清单2-18。

程序清单2-18　检测代码的初始版本

1 def parking_costs
2　 @page.click 'Submit'
3　 @page.wait_for_page_to_load 10000
4　 cost_element = @page.get_text "//tr[td/div[@class='SubHead']
　　　 = 'estimated Parking costs']/td/span/b"
5　 return cost_element
6 end

Tony： 那个常量10000是干什么的？

Alex：那是个超时值。驱动最多等待10秒钟，要么新页面成功载入，要么测试会失败。

Tony：现在我们来清理一下这些乱糟糟的代码。我建议同样把xpath提取到一个常量中。

Alex：首先，我们看一下是否能正确运行。我们来运行一下测试。

Alex和Tony启动了测试，看着它执行了停车场费用计算，最后在命令行中显示绿色，代表所有代码工作良好（见程序清单2-19）。

程序清单2-19　第一个代客泊车测试的命令行输出

1Feature: Valet Parking feature
2　 The parking lot calculator can calculate costs for Valet
　　　 Parking.
3
4　 Scenario: Calculate Valet Parking Cost
　　　　# Valet.feature:4
5　　 When I park my car in the Valet Parking Lot for 30 minutes
　　　　# step_definitions/Valet_steps.rb:1
6　　 Then I will have to pay $ 12.00
　　　　# step_definitions/Valet_steps.rb:6
7
8 1 scenario (1 passed)
9 2 steps (2 passed)
10 0m0.324s

Tony：很好，测试通过了。在我们做任何修改之前，首先提交一下代码，这样将来我们可以回滚我们所做的任何修改，以防万一嘛。

Alex：好主意。

Alex和Tony把他们的成果提交到版本控制系统。

Alex：现在我们回到你的建议。想法很好，但是我想先把这个函数分成两步。第一个函数用来点击“提交”按钮并等待页面载入。第二个函数会取到算好的费用并返回。我写给你看我是什么意思。

Alex从最初的parking_costs函数提出两个函数（见程序清单2-20）。

程序清单2-20　将两个步骤重构到各自函数后的检查代码

1　　def parking_costs
2　　　calculate_parking_costs
3　　　get_parking_costs_from_page
4　　end
5
6　　def calculate_parking_costs
7　　　@page.click 'Submit'
8　　　@page.wait_for_page_to_load 10000
9　　end
10
11　　def get_parking_costs_from_page
12　　　@page.get_text "//tr[td/div[@class='SubHead'] = 'estimated
　　　　Parking costs']/td/span/b"
13　　end

Tony：现在我们来把定位费用元素的xpath路径移到常量中去。

Alex：既然要做这个，不如把“计算”按钮的名字也用一个有意义的变量名表示好了。

Tony： 现在，最后再跑一遍测试，然后我们就可以把代码提交到源代码库里了。

Tony和Alex看着测试运行通过了。他们将文件提交到了代码库。程序清单2-21展示了step_definitions/Valet_steps.rb的最终内容，程序清单2-22是lib/parkcalc.rb的最终内容。

程序清单2-21　代客泊车第一个测试步骤定义的最终版本

1 When /^I park my car in the Valet Parking Lot for (.*)$/ do
　　　 |duration|
2　 $parkcalc.select('Valet Parking')
3　 $parkcalc.enter_parking_duration(duration)
4 end
5
6 Then /^I will have to pay (.*)$/ do |price|
7　 $parkcalc.parking_costs.should == price
8 end

程序清单2-22　第一个测试ParkCalcPage类的最终代码

1 class ParkCalcPage
 2
 3　 @@lotIdentifier = 'ParkingLot'
 4　 @@startingPrefix = 'Starting'
 5　 @@leavingPrefix = 'Leaving'
 6　 @@dateTemplate = "%sDate"
 7　 @@timeTemplate = "%sTime"
 8　 @@amPMRadioButtonTemplate = "//input[@name='%sTimeAMPM' and
　　　 @value='%s']"
 9
10　 @@calculateButtonIdentifier = 'Submit'
11　 @@costElementLocation = "//tr[td/div[@class='SubHead']
　　　 = 'estimated Parking costs']/td/span/b"
12
13　 @@durationMap = {
14　　 '30 minutes' => ['05/04/2010', '12:00', 'AM', '05/04/2010'
　　　 , '12:30', 'AM']
15　 }
16
17　 attr :page
18
19　 def initialize(page_handle)
20　　 @page = page_handle
21　　 @page.open '/parkcalc'
22　 end
23
24　 def select(parking_lot)
25　　 @page.select @@lotIdentifier, parking_lot
26　 end
27
28　 def enter_parking_duration(duration)
29　　 startingDate, startingTime, startingTimeAMPM, leavingDate,
　　　　leavingTime, leavingTimeAMPM = @@durationMap[duration]
30　　 fill_in_date_and_time_for @@startingPrefix, startingDate,
　　　　startingTime, startingTimeAMPM
31　　 fill_in_date_and_time_for @@leavingPrefix, leavingDate,
　　　　leavingTime, leavingTimeAMPM
32　 end
33
34　 def fill_in_date_and_time_for(formPrefix, date, time, ampm)
35　　 @page.type @@dateTemplate % formPrefix, date
36　　 @page.type @@timeTemplate % formPrefix, time
37　　 @page.click @@amPMRadioButtonTemplate % [ formPrefix,
　　　　ampm ]
38　 end
39
40　 def parking_costs
41　　 calculate_parking_costs
42　　 get_parking_costs_from_page
43　 end
44
45　 def calculate_parking_costs
46　　 @page.click @@calculateButtonIdentifier
47　　 @page.wait_for_page_to_load 10000
48　 end
49
50　 def get_parking_costs_from_page
51　　 @page.get_text @@costElementLocation
52　 end
53 end

本文仅用于学习和交流目的，不代表异步社区观点。非商业转载请注明作译者、出处，并保留本文的原始链接。