测试即文档：自动化测试框架Concordion

如果你是那种极不情愿写文档的程序员，那么，你并不孤单。然而当你的上司在检查你的工作时，他才不想看你那一堆一堆的代码，他需要看文档，这时的你需要的是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。

　　下载Concordion和其所依赖的包。

　　首先写一个html测试用例HelloWorld.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()
      {
           return new HelloWorld().sayHelloWorld();
      }
}

　　在HelloWorldTest.java文件中实例化了一个HelloWorld对象，并调用其sayHelloWorld()方法，于是写一个需要测试的HelloWorld类如下：

　　最终生成的工程目录结构如下：

　　（三）编译并运行测试

　　打开终端，将目录切换到 concordion（这是笔者为此helloworld创建的工程根目录，请不要与上文提到的concordion混淆）下，编译：

　　用JUnit运行测试：

　　运行结果如下：

　　运行成功，并且显示测试输出的html文件的全路径名称（此时应该去掉最前面的那个点"."）：

　　打开该文件：

　　测试运行成功。

本文出自seven的测试人生公众号最新内容请见作者的GitHub页：http://qaseven.github.io/