如果你是那种极不情愿写文档的程序员,那么,你并不孤单。然而当你的上司在检查你的工作时,他才不想看你那一堆一堆的代码,他需要看文档,这时的你需要的是Concordion——一个符合Specification By Example的自动化测试框架,通过自然语言来描述软件功能,即项目中所有成员都能看懂的而又具备测试功能的html文档。
(一)Concordion的工作原理
简单的说,Concordion测试只是对JUnit的扩展,但是它可以从你写好的测试文档(html)中读取测试数据,通过传统的JUnit来跑测试,并将测试结果输出为具有红绿标记(表示失败或成功)的html文档(基于原测试文档)。
在上图中,Specification即为我们写的html测试文档,与普通的html文档不同的是,我们需要在其中加入一些名为concordion的标签,浏览器将忽略这些标签,但Concordion用这些标签来执行测试指令,比如调用Fixture中的测试函数等。Fixture为继承自ConcordionTestCase(最终继承自JUnit测试类)的测试用例,这些测试用例将调用我们自己所开发的功能代码。
(二)Concordion的Hello World
下面就通过一个简单的Hello World例子来演示Concordion。
首先写一个html测试用例HelloWorld.html:
<html xmlns:concordion=http://www.concordion.org/2007/concordion> <body> <p>Should print:</p> <p concordion:assertEquals="sayHello()">HelloWorld</p> </body> </html> |
此html文档可以通过浏览器正常打开,由于浏览器并不知道concordion标签,故将其忽略:
可以看到,以上加入的concordion标签的html测试文档和普通的html文档并无区别,同时我们也看到在concordion标签后有一个sayHello()函数调用,此函数从什么地方来呢——这就是Concordion的约定,要求在该html文档的同目录下有一个名为HelloWorldTest.java的测试用例类存在,并且该类有一个测试函数名为sayHello()。约定规则为:如果html文档名为Foo.html,那么测试用例类应该为FooTest.java。此时Concordion便通过名字匹配去找名为HelloWorldTest类的sayHello()函数并调用之。
我们还注意到,在concordion标签后有assertEquals,此时Concordion将把helloWorld()函数的输出与之后的“HelloWorld”字符串相比,如果相等,测试成功,否则失败。
接下来实现HelloWorldTest类,在HelloWorld.html同目下创建HelloWorldTest.java文件:
package com.thoughtworks.davenkin.concordion; import org.concordion.integration.junit3.ConcordionTestCase; public class HelloWorldTest extends ConcordionTestCase { public String sayHello() |