本节书摘来自异步社区《验收测试驱动开发: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)。
2.2.1 初始化
Alex:我设计由下拉菜单展现不同的停车场。日期可以直接由输入框填入字符串,或者用日历控件选择日期。停入和离开的时间由文本输入,有一个单选按钮决定上午还是下午。当计算按钮按下之后就会显示估算的停车费。
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
本文仅用于学习和交流目的,不代表异步社区观点。非商业转载请注明作译者、出处,并保留本文的原始链接。