Junit 教程(Kent Beck, Erich Gamma)--Fanto译
以下是一份简单的教程,向您展示如何使用Junit编写和组织测试程序。
一个简单的测试用例。
您是怎样编写测试代码的呢?
在调试器中使用表达式也许是最简单的办法。您可以不用重新编译,就能改变调试器中的表达式,您甚至可以在您看到运行的对象实例后再决定如何改变;您也可以写一些作为测试的表达式将结果打印到标准输出。以上风格的测试都有一些局限,因为它们都需要人为的判断来分析程序运行的结果;而且,呈现给您的也是一些不友好的输出。您每次只能运行一个调试表达式,如果一个程序有太多的输出语句将导致您很难找到您需要的结果。
JUnit Test不需要人的判断去解释,而且一次可以运行很多的测试。如果您需要测试某个东东的时候,您只要这么做即可:
- 从TestCase继承出一个子类。
- 重写runTest()方法。
- 当您想检查一个值时,调用assertTrue()方法,并传入一个布尔量真值来代表测试通过。
例如:为了测试同一货币单位的两个钱数的和,我们包含了一个真实的值表示了这两个钱数的和。如下:
public void testSimpleAdd()
{
Money m12CHF = new Money(12,"CHF");
Money m14CHF = new Money(14,"CHF");
Money expected= new Money(26,"CHF");
Money result = m12CHF.add(m14CHF)
assertTrue(expected.equals(result));
}
如果,您要写的测试与以前写过的有些类似,那就写一个模板。如果,您想运行多个测试,那就建立一个组。
模板:
当您有两个或多个测试需要操作对象的同一或相近部分,该怎么办?
测试需要运行在部分内容已经确定的对象上,这些已知的部分被称作测试模板。当您在写测试的时候,您通常会发现您构建测试环境(已知部分)的时间要比您真正比较测试结果的时间要长。
从某种程度上说,您如果仔细使用构造函数,您写模板的时候也许更容易些。不管怎么样,许多的保存内容来自共享的模板。通常,您能够将这个模板应用到一些不同的测试上。每个测试用例将传递相近的信息或参数给模板,然后检查不同的结果。
当您写一个通用的模板时,下面是您所要做的:
- 从TestCase生成子类。
- 给模板添加需要使用的实例变量。
- 覆写setUp()方法来实例化变量。
- 覆写tearDown()方法来释放您在setUp()方法中建立的永久资源。
例如:为了写一些使用到 12瑞士法郎,14瑞士法郎,28美元不同组合的测试用例,那就首先写一个模板:
public class MoneyTest extends TestCase
{
private Money f12CHF;
private Money f14CHF;
private Money f28USD;
protected void setUp()
{
f12CHF = new Money(12,"CHF");
f14CHF = new Money(14,"CHF");
f28USD = new Money(28,"USD");
}
}
一旦您写完了模板,那么,您就可以再写随意多的测试用例了。
测试用例
当您拥有了模板后,您是怎样来写和调用单独的测试用例呢?
当没有模板的时候,写测试用例是简单的--只需覆写TestCase的匿名子类中的runTest方法。有模板后,生成TestCase的子类来写设置的代码。然后,为单独的测试用例写匿名子类。然而,当写过一些测试以后,您将注意到,很多的代码行都浪费在语法上了。
JUnit提供了一个简练的方法来利用模板写测试,如下:
1,在包含模板的类中提供一个public void 方法,通常约定:方法名以test开头。
例如:为了测试Moeny 和MoneyBag的和,如下:
public void testMoneyMoneyBag()
{
//[12 CHF] +[14 CHF] +[28 USD] == {[26 CHF] [28 USD] }
Money bag[] = {f26CHF,f28USD};
MoneyBag expected = new MoneyBag(bag);
assertEquals(expected,f12CHF.add(f28USD.add(f14CHF)));
}
创建一个MoneyTest实例来运行这个用例的方法,如下:
new MoneyTest("testMoneyMoneyBag")
当这个测试运行时,这个参数名字被用来查找需要运行的方法。
当您有多个测试用例时,可以将他们组织成(套件)suite.
套件(suite)
您怎样才能一次运行多个测试?
只要您有了两个测试,您可能就希望一起运行他们。您当然可以每次只运行一个,但是很快您就会感到厌倦。JUnit提供了一个对象,TestSuite,以方便您一次完成任意多的测试一起运行。
例如:只运行一个测试用例,您可能会执行:
TestResult result = (new MoneyTest("testMoneyMoneyBag")).run();
运行两个测试用例,可以先产生一个套件(Suite),然后将这两个测试用例包含其中,如下:
TestSuite suite = new TestSuite();
suite.addTest(new MoneyTest("testMoneyMoneyBag"));
suite.addTest(new MoneyTest("testSimpleAdd"));
TestResult result = suite.run();
您可以采取另外的一种方式来一次运行多个测试用例,那就是让JUnit自己从用例类(TestCase)中提取套件(Suite)。您可以通过将用例类(TestCase)的类名传递给套件(Suite)的构造函数来做到这点。
TestSuite suite = new TestSuite(MoneyTest.class);
TestResult result = suite.run();
使用手工方法的多数情况是,我们希望套件中只包含测试用例的一个子集。其他情况,推荐使用自动提取测试套件方法,它能够避免当您在新添加了一个测试用例后,还需要更改TestSuite(套件)产生代码。
TestSuites(套件)不仅可以包含测试用例,它还可以包含实现Test接口的任意对象。例如,您可以在您的代码中产生一个套件,同时,我也产生一个,然后我们可以产生一个包含上述两个套件的套件来一起运行。
TestSuite suite = new TestSuite();
suite.addTest(Kent.suite());
suite.addTest(Erich.suite());
TestResult result = suite.run();
TestRunner(测试执行器)
您怎样运行测试,并收集执行后的结果?
当您有了一个测试套件的时候,您就想运行它。Juint提供了工具来定义这个套件运行并显示测试结果,您需使您的套件能被TestRunner(测试运行器)访问;您可以使用静态方法suite(),并且返回一个suite(套件)来完成这项工作。
public static Test suite()
{
TestSuite suite = new TestSuite();
suite.addTest(new MoneyTest("testMoneyEquals"));
suite.addTest(new MoneyTest("testSimpleAdd"));
return suite;
}
或则,采用自动提取的方式:
public static Test suite() {
return new TestSuite(MoneyTest.class);
}
如果,TestCase没有定义suite方法,测试执行器将自动尝试提取一个suite,并把以test开头的方法装入套件。
Juint提供了图形和文本两种方式的测试执行器,启动方式分别是:java junit.awtui.TestRunner 或则 java junit.swingui.TestRunner.
图形界面的执行方式提供了一个窗口,内容包括:
- 一个输入文本框,用来键入包含suite方法的类的名字。
- 一个启动测试的按钮。
- 一个进度条,如果测试失败,他将从绿色变为红色。
- 一个包含失败的测试的列表。
当测试不通过时,juint在底部提供一个失败测试的报表。juint区分失败和错误。失败是预期的,并且使用断言assertions来做检查的.错误是没有预计到的,象数组索引越界。下图包含了一个失败的测试。
当您改变代码后,您必须重新启动图形界面窗口,这是繁琐和耗时的。为了避免这种情况,JUnit 的AWT 和Swing UIs 可以利用junit.runner.LoadingTestCollector ,这个工具在测试的每次运行时都重新读入您的类。如果您想关闭这个功能,去掉“reload classes”属性选项即可。在帮助中您可以找到更详细的信息。
有一个批处理来启动Junit.您可以在命令行中键入java junit.textui.TestRunner ,后跟包含suite方法的类名。这个方式得到一些终端文本输出。另外一种启动的方式是在您的TestCase类中,包含如下定义的main方法。
例如:启动MoneyTest的测试执行器,
public static void main(String args[]) {
junit.textui.TestRunner.run(suite());
}
当您定义了这个main方法后,您就可以在命令行中键入:java MoneyTest 来运行您的测试了。
无论是图形方式还是文本方式,都要确认在您的classpath上是否包含了junit.jar.
在本文中,TestCase--测试用例,Suite--套件,TestRunner--测试执行器,————译者