Ant+Junit4实现自动单元测试
一、Junit概述
Junit测试是程序员测试,即所谓白盒测试,因为程序员知道被测试的软件如何(How)完成功能和完成什么样(What)的功能。
Junit本质上是一套框架,即开发者制定了一套条条框框,遵循这此条条框框要求编写测试代码,如继承某个类,实现某个接口,就可以用Junit进行自动测试了。
由于Junit相对独立于所编写的代码,可以测试代码的编写可以先于实现代码的编写,XP 中推崇的 test first design的实现有了现成的手段:用Junit写测试代码,写实现代码,运行测试,测试失败,修改实现代码,再运行测试,直到测试成功。以后对代码的修改和优化,运行测试成功,则修改成功。
Java 下的 team 开发,采用 svn(版本控制) + ant(项目管理) + junit(集成测试) 的模式时,通过对ant的配置,可以很简单地实现测试自动化。
对不同性质的被测对象,如Class,Jsp,Servlet,Ejb等,Junit有不同的使用技巧,以后慢慢地分别讲叙。以下以Class测试为例讲解,除非特殊说明。
二、环境准备
1、下载Apache Ant version 1.8.0,并配置环境ANT_HOME(如何配置ant环境请查阅相关资料)
2、下载junit4的jar包,本文使用的junit版本是junit-4.4.jar,将junit-4.4.jar放入ANT_HOME/lib/下面
三、创建测试工程、测试代码
1、创建测试工程,工程结构
2、创建java源代码(下面以Money这个类为例进行说明)
package com.easyluck.helloword;
public class Money {
private int fAmount;// 余额
private String fCurrency;// 货币类型
public Money(int amount, String currency) {
this.fAmount = amount;
this.fCurrency = currency;
}
public int amount() {
return this.fAmount;
}
public String currency() {
return this.fCurrency;
}
public Money add(Money m) {// 加钱
return new Money(amount() + m.amount(), currency());
}
@Override
public boolean equals(Object anObject) {// 判断钱数是否相等
if (anObject instanceof Money) {
Money aMoney = (Money) anObject;
return aMoney.currency().equals(currency())&& (amount() == aMoney.amount());
}
return false;
}
}
3、创建测试代码
Junit本身是围绕着两个设计模式来设计的:命令模式和集成模式。命令模式与集成模式的本质区别是,前者一次只运行一个测试。
1)命令模式
利用TestCase定义一个子类,在这个子类中生成一个被测试的对象,编写代码检测某个方法被调用后对象的状态与预期的状态是否一致,进而断言程序代码有没有bug。
当这个子类要测试不只一个方法的实现代码时,可以先建立测试基础,让这些测试在同一个基础上运行,一方面可以减少每个测试的初始化,而且可以测试这些不同方法之间的联系。
例如,我们要测试Money的Add方法,可以如下:
public class MoneyTest extends TestCase { //TestCase的子类
@Test
public void testAdd()
{ //把测试代码放在testAdd中 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)); //判断运行结果是否与预期的相同 }
}
如果测试一下equals方法,用类似的代码,如下:
public class MoneyTest extends TestCase { //TestCase的子类
@Test
public void testEquals()
{ //把测试代码放在testEquals中 Money m12CHF= new Money(12, "CHF"); //本行和下一行进行一些初始化 Money m14CHF= new Money(14, "CHF"); assertTrue(\!m12CHF.equals(null));//进行不同情况的测试 assertEquals(m12CHF, m12CHF); assertEquals(m12CHF, new Money(12, "CHF")); // (1) assertTrue(\!m12CHF.equals(m14CHF)); }
}
当要同时进行测试Add和equals方法时,可以将它们的各自的初始化工作,合并到一起进行,形成测试基础,用setUp初始化,用tearDown清除。如下:
public class MoneyTest extends TestCase {//TestCase的子类
private Money f12CHF;//提取公用的对象
private Money f14CHF;
protected void setUp()
{//初始化公用对象 f12CHF= new Money(12, "CHF"); f14CHF= new Money(14, "CHF"); }
@Test
public void testEquals()
{//测试equals方法的正确性 assertTrue(\!f12CHF.equals(null)); assertEquals(f12CHF, f12CHF); assertEquals(f12CHF, new Money(12, "CHF")); assertTrue(\!f12CHF.equals(f14CHF)); }
@Test
public void testSimpleAdd()
{//测试add方法的正确性 Money expected= new Money(26, "CHF"); Money result= f12CHF.add(f14CHF); assertTrue(expected.equals(result)); }
}
将以上三个中的任一个TestCase子类代码保存到名为MoneyTest.java的文件里,并在文件首行增加 import junit.framework.*;
,都是可以运行的。关于Junit运行的问题很有意思,下面单独说明。
上面为解释概念“测试基础(fixture)”,引入了两个对两个方法的测试。命令模式与集成模式的本质区别是,前者一次只运行一个测试
2)集成模式
利用TestSuite可以将一个TestCase子类中所有test**()方法包含进来一起运行,还可将TestSuite子类也包含进来,从而行成了一种等级关系。可以把TestSuite视为一个容器,可以盛放TestCase中的test**()方法,它自己也可以嵌套。这种体系架构,非常类似于现实中程序一步步开发一步步集成的现况。
对上面的例子,有代码如下:
public class MoneyTest extends TestCase {//TestCase的子类
....
public static Test suite() {//静态Test
TestSuite suite= new TestSuite();//生成一个TestSuite
suite.addTest(new MoneyTest("testEquals")); //加入测试方法
suite.addTest(new MoneyTest("testSimpleAdd"));
return suite;
}
}
从Junit2.0开始,有列简捷的方法:
public class MoneyTest extends TestCase {//TestCase的子类
....
public static Test suite() {静态Test
return new TestSuite(MoneyTest.class); //以类为参数
}
}
4、测试代码的运行
1)用Junit提供的运行器运行
2)使用ant命令运行
(a)编写ant运行时需要的build.xml文件
<?xml version="1.0"?>
<!-- =============================================
auto unittest task
========================================== -->
<project name="auto unittest task" default="junit and report" basedir=".">
<property name="output folder" value="build"/>
<property name="src folder" value="src"/>
<property name="test folder" value="test"/>
<property name="report folder" value="report" />
<property name="build.src.dir" value="${output folder}/classes" />
<property name="build.testcase.dir" value="${output folder}/testcases" />
<!-- - - - - - - - - - - - - - - - - -
set the depends jar files
- - - - - - - - - - - - - - - - - -->
<path id="test.lib.classpath">
<fileset dir="../public/test">
<include name="*.jar"/>
</fileset>
</path>
<path id="compile.lib.classpath">
<fileset dir="../public/test">
<include name="**/*.jar"/>
</fileset>
</path>
<!-- - - - - - - - - - - - - - - - - -
target: test report folder init
- - - - - - - - - - - - - - - - - -->
<target name="test init">
<mkdir dir="${report folder}"/>
<mkdir dir="${build.src.dir}"/>
<mkdir dir="${build.testcase.dir}"/>
</target>
<!-- - - - - - - - - - - - - - - - - -
target: compile
- - - - - - - - - - - - - - - - - -->
<target name="compile" depends="test init">
<javac srcdir="${src folder}" destdir="${build.src.dir}"
encoding="utf-8" debug="on" deprecation="on"
optimize="on" failοnerrοr="true"
source="1.6" target="1.6"/>
<echo>compilation complete!</echo>
</target>
<!-- - - - - - - - - - - - - - - - - -
target: compile test cases
- - - - - - - - - - - - - - - - - -->
<target name="test compile" depends="compile">
<javac srcdir="${test folder}" destdir="${build.testcase.dir}"
encoding="utf-8" debug="on" deprecation="on"
optimize="on" failοnerrοr="true"
source="1.6" target="1.6">
<classpath>
<pathelement path="${test.lib.classpath}"/>
<pathelement location="${build.src.dir}" />
<pathelement path="" />
</classpath>
<include name="**/*.java"/>
</javac>
<echo>test compilation complete!</echo>
</target>
<target name="all compile" depends="compile, test compile">
</target>
<!-- ========================================
target: auto test all test case and output report file
===================================== -->
<target name="junit and report" depends="all compile">
<junit printsummary="on" fork="true" showoutput="true">
<classpath>
<pathelement path="${test.lib.classpath}"/>
<pathelement path="${build.src.dir}"/>
<pathelement path="${build.testcase.dir}"/>
</classpath>
<formatter type="xml" />
<batchtest todir="${report folder}">
<fileset dir="${build.testcase.dir}">
<include name="**/*Test*.*" />
</fileset>
</batchtest>
</junit>
<junitreport todir="${report folder}">
<fileset dir="${report folder}">
<include name="TEST-*.xml" />
</fileset>
<report format="frames" todir="${report folder}" />
</junitreport>
</target>
<target name="clean" description="Deletes compiled and generated code">
<delete dir="${output folder}"/>
<delete dir="${report folder}"/>
</target>
</project>
(b)执行ant命令,执行结果
E:\workspaces_new\HelloWord>ant
Buildfile: E:\workspaces_new\HelloWord\build.xml
test init:
[mkdir] Created dir: E:\workspaces_new\HelloWord\report
[mkdir] Created dir: E:\workspaces_new\HelloWord\build\classes
[mkdir] Created dir: E:\workspaces_new\HelloWord\build\testcases
compile:
[javac] E:\workspaces_new\HelloWord\build.xml:45: warning: 'includeantruntim
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab
le builds
[javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\classe
s
[echo] compilation complete!
test compile:
[javac] E:\workspaces_new\HelloWord\build.xml:56: warning: 'includeantruntim
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab
le builds
[javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\testca
ses
[echo] test compilation complete!
all compile:
junit and report:
[junit] Running com.easyluck.helloword.HelloWorldTest
[junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec
[junit] Running com.easyluck.helloword.MoneyTest
[junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec
[junitreport] Processing E:\workspaces_new\HelloWord\report\TESTS-TestSuites.xml
to C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164
[junitreport] Loading stylesheet jar:file:/D:/apache-ant/lib/ant-junit.jar!/org/
apache/tools/ant/taskdefs/optional/junit/xsl/junit-frames.xsl
[junitreport] Transform time: 344ms
[junitreport] Deleting: C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164
BUILD SUCCESSFUL
Total time: 4 seconds
5、一些问题
有人在实践基础上总结出一些非常有价值的使用技巧,我没有经过一一“测试”,暂列在此。
不要用TestCase的构造函数初始化Fixture,而要用setUp()和tearDown()方法。
不要依赖或假定测试运行的顺序,因为JUnit利用Vector保存测试方法。所以不同的平台会按不同的顺序从Vector中取出测试方法。
避免编写有副作用的TestCase。例如:如果随后的测试依赖于某些特定的交易数据,就不要提交交易数据。简单的回滚就可以了。
当继承一个测试类时,记得调用父类的setUp()和tearDown()方法。
将测试代码和工作代码放在一起,一边同步编译和更新。(使用Ant中有支持junit的task.)
测试类和测试方法应该有一致的命名方案。如在工作类名前加上test从而形成测试类名。
确保测试与时间无关,不要依赖使用过期的数据进行测试。导致在随后的维护过程中很难重现测试。
如果你编写的软件面向国际市场,编写测试时要考虑国际化的因素。不要仅用母语的Locale进行测试。
尽可能地利用JUnit提供地assert/fail方法以及异常处理的方法,可以使代码更为简洁。
测试要尽可能地小,执行速度快。
把测试程序建立在与被测对象相同的包中
在你的原始代码目录中避免测试码出现,可在一个源码镜像目录中放测试码
在自己的应用程序包中包含一个TestSuite测试类
一、Junit概述
Junit测试是程序员测试,即所谓白盒测试,因为程序员知道被测试的软件如何(How)完成功能和完成什么样(What)的功能。
Junit本质上是一套框架,即开发者制定了一套条条框框,遵循这此条条框框要求编写测试代码,如继承某个类,实现某个接口,就可以用Junit进行自动测试了。
由于Junit相对独立于所编写的代码,可以测试代码的编写可以先于实现代码的编写,XP 中推崇的 test first design的实现有了现成的手段:用Junit写测试代码,写实现代码,运行测试,测试失败,修改实现代码,再运行测试,直到测试成功。以后对代码的修改和优化,运行测试成功,则修改成功。
Java 下的 team 开发,采用 svn(版本控制) + ant(项目管理) + junit(集成测试) 的模式时,通过对ant的配置,可以很简单地实现测试自动化。
对不同性质的被测对象,如Class,Jsp,Servlet,Ejb等,Junit有不同的使用技巧,以后慢慢地分别讲叙。以下以Class测试为例讲解,除非特殊说明。
二、环境准备
1、下载Apache Ant version 1.8.0,并配置环境ANT_HOME(如何配置ant环境请查阅相关资料)
2、下载junit4的jar包,本文使用的junit版本是junit-4.4.jar,将junit-4.4.jar放入ANT_HOME/lib/下面
三、创建测试工程、测试代码
1、创建测试工程,工程结构
2、创建java源代码(下面以Money这个类为例进行说明)
package com.easyluck.helloword;
public class Money {
private int fAmount;// 余额
private String fCurrency;// 货币类型
public Money(int amount, String currency) {
this.fAmount = amount;
this.fCurrency = currency;
}
public int amount() {
return this.fAmount;
}
public String currency() {
return this.fCurrency;
}
public Money add(Money m) {// 加钱
return new Money(amount() + m.amount(), currency());
}
@Override
public boolean equals(Object anObject) {// 判断钱数是否相等
if (anObject instanceof Money) {
Money aMoney = (Money) anObject;
return aMoney.currency().equals(currency())&& (amount() == aMoney.amount());
}
return false;
}
}
3、创建测试代码
Junit本身是围绕着两个设计模式来设计的:命令模式和集成模式。命令模式与集成模式的本质区别是,前者一次只运行一个测试。
1)命令模式
利用TestCase定义一个子类,在这个子类中生成一个被测试的对象,编写代码检测某个方法被调用后对象的状态与预期的状态是否一致,进而断言程序代码有没有bug。
当这个子类要测试不只一个方法的实现代码时,可以先建立测试基础,让这些测试在同一个基础上运行,一方面可以减少每个测试的初始化,而且可以测试这些不同方法之间的联系。
例如,我们要测试Money的Add方法,可以如下:
public class MoneyTest extends TestCase { //TestCase的子类
@Test
public void testAdd()
{ //把测试代码放在testAdd中 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)); //判断运行结果是否与预期的相同 }
}
如果测试一下equals方法,用类似的代码,如下:
public class MoneyTest extends TestCase { //TestCase的子类
@Test
public void testEquals()
{ //把测试代码放在testEquals中 Money m12CHF= new Money(12, "CHF"); //本行和下一行进行一些初始化 Money m14CHF= new Money(14, "CHF"); assertTrue(\!m12CHF.equals(null));//进行不同情况的测试 assertEquals(m12CHF, m12CHF); assertEquals(m12CHF, new Money(12, "CHF")); // (1) assertTrue(\!m12CHF.equals(m14CHF)); }
}
当要同时进行测试Add和equals方法时,可以将它们的各自的初始化工作,合并到一起进行,形成测试基础,用setUp初始化,用tearDown清除。如下:
public class MoneyTest extends TestCase {//TestCase的子类
private Money f12CHF;//提取公用的对象
private Money f14CHF;
protected void setUp()
{//初始化公用对象 f12CHF= new Money(12, "CHF"); f14CHF= new Money(14, "CHF"); }
@Test
public void testEquals()
{//测试equals方法的正确性 assertTrue(\!f12CHF.equals(null)); assertEquals(f12CHF, f12CHF); assertEquals(f12CHF, new Money(12, "CHF")); assertTrue(\!f12CHF.equals(f14CHF)); }
@Test
public void testSimpleAdd()
{//测试add方法的正确性 Money expected= new Money(26, "CHF"); Money result= f12CHF.add(f14CHF); assertTrue(expected.equals(result)); }
}
将以上三个中的任一个TestCase子类代码保存到名为MoneyTest.java的文件里,并在文件首行增加 import junit.framework.*;
,都是可以运行的。关于Junit运行的问题很有意思,下面单独说明。
上面为解释概念“测试基础(fixture)”,引入了两个对两个方法的测试。命令模式与集成模式的本质区别是,前者一次只运行一个测试
2)集成模式
利用TestSuite可以将一个TestCase子类中所有test**()方法包含进来一起运行,还可将TestSuite子类也包含进来,从而行成了一种等级关系。可以把TestSuite视为一个容器,可以盛放TestCase中的test**()方法,它自己也可以嵌套。这种体系架构,非常类似于现实中程序一步步开发一步步集成的现况。
对上面的例子,有代码如下:
public class MoneyTest extends TestCase {//TestCase的子类
....
public static Test suite() {//静态Test
TestSuite suite= new TestSuite();//生成一个TestSuite
suite.addTest(new MoneyTest("testEquals")); //加入测试方法
suite.addTest(new MoneyTest("testSimpleAdd"));
return suite;
}
}
从Junit2.0开始,有列简捷的方法:
public class MoneyTest extends TestCase {//TestCase的子类
....
public static Test suite() {静态Test
return new TestSuite(MoneyTest.class); //以类为参数
}
}
4、测试代码的运行
1)用Junit提供的运行器运行
2)使用ant命令运行
(a)编写ant运行时需要的build.xml文件
<?xml version="1.0"?>
<!-- =============================================
auto unittest task
========================================== -->
<project name="auto unittest task" default="junit and report" basedir=".">
<property name="output folder" value="build"/>
<property name="src folder" value="src"/>
<property name="test folder" value="test"/>
<property name="report folder" value="report" />
<property name="build.src.dir" value="${output folder}/classes" />
<property name="build.testcase.dir" value="${output folder}/testcases" />
<!-- - - - - - - - - - - - - - - - - -
set the depends jar files
- - - - - - - - - - - - - - - - - -->
<path id="test.lib.classpath">
<fileset dir="../public/test">
<include name="*.jar"/>
</fileset>
</path>
<path id="compile.lib.classpath">
<fileset dir="../public/test">
<include name="**/*.jar"/>
</fileset>
</path>
<!-- - - - - - - - - - - - - - - - - -
target: test report folder init
- - - - - - - - - - - - - - - - - -->
<target name="test init">
<mkdir dir="${report folder}"/>
<mkdir dir="${build.src.dir}"/>
<mkdir dir="${build.testcase.dir}"/>
</target>
<!-- - - - - - - - - - - - - - - - - -
target: compile
- - - - - - - - - - - - - - - - - -->
<target name="compile" depends="test init">
<javac srcdir="${src folder}" destdir="${build.src.dir}"
encoding="utf-8" debug="on" deprecation="on"
optimize="on" failοnerrοr="true"
source="1.6" target="1.6"/>
<echo>compilation complete!</echo>
</target>
<!-- - - - - - - - - - - - - - - - - -
target: compile test cases
- - - - - - - - - - - - - - - - - -->
<target name="test compile" depends="compile">
<javac srcdir="${test folder}" destdir="${build.testcase.dir}"
encoding="utf-8" debug="on" deprecation="on"
optimize="on" failοnerrοr="true"
source="1.6" target="1.6">
<classpath>
<pathelement path="${test.lib.classpath}"/>
<pathelement location="${build.src.dir}" />
<pathelement path="" />
</classpath>
<include name="**/*.java"/>
</javac>
<echo>test compilation complete!</echo>
</target>
<target name="all compile" depends="compile, test compile">
</target>
<!-- ========================================
target: auto test all test case and output report file
===================================== -->
<target name="junit and report" depends="all compile">
<junit printsummary="on" fork="true" showoutput="true">
<classpath>
<pathelement path="${test.lib.classpath}"/>
<pathelement path="${build.src.dir}"/>
<pathelement path="${build.testcase.dir}"/>
</classpath>
<formatter type="xml" />
<batchtest todir="${report folder}">
<fileset dir="${build.testcase.dir}">
<include name="**/*Test*.*" />
</fileset>
</batchtest>
</junit>
<junitreport todir="${report folder}">
<fileset dir="${report folder}">
<include name="TEST-*.xml" />
</fileset>
<report format="frames" todir="${report folder}" />
</junitreport>
</target>
<target name="clean" description="Deletes compiled and generated code">
<delete dir="${output folder}"/>
<delete dir="${report folder}"/>
</target>
</project>
(b)执行ant命令,执行结果
E:\workspaces_new\HelloWord>ant
Buildfile: E:\workspaces_new\HelloWord\build.xml
test init:
[mkdir] Created dir: E:\workspaces_new\HelloWord\report
[mkdir] Created dir: E:\workspaces_new\HelloWord\build\classes
[mkdir] Created dir: E:\workspaces_new\HelloWord\build\testcases
compile:
[javac] E:\workspaces_new\HelloWord\build.xml:45: warning: 'includeantruntim
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab
le builds
[javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\classe
s
[echo] compilation complete!
test compile:
[javac] E:\workspaces_new\HelloWord\build.xml:56: warning: 'includeantruntim
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab
le builds
[javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\testca
ses
[echo] test compilation complete!
all compile:
junit and report:
[junit] Running com.easyluck.helloword.HelloWorldTest
[junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec
[junit] Running com.easyluck.helloword.MoneyTest
[junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec
[junitreport] Processing E:\workspaces_new\HelloWord\report\TESTS-TestSuites.xml
to C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164
[junitreport] Loading stylesheet jar:file:/D:/apache-ant/lib/ant-junit.jar!/org/
apache/tools/ant/taskdefs/optional/junit/xsl/junit-frames.xsl
[junitreport] Transform time: 344ms
[junitreport] Deleting: C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164
BUILD SUCCESSFUL
Total time: 4 seconds
5、一些问题
有人在实践基础上总结出一些非常有价值的使用技巧,我没有经过一一“测试”,暂列在此。
不要用TestCase的构造函数初始化Fixture,而要用setUp()和tearDown()方法。
不要依赖或假定测试运行的顺序,因为JUnit利用Vector保存测试方法。所以不同的平台会按不同的顺序从Vector中取出测试方法。
避免编写有副作用的TestCase。例如:如果随后的测试依赖于某些特定的交易数据,就不要提交交易数据。简单的回滚就可以了。
当继承一个测试类时,记得调用父类的setUp()和tearDown()方法。
将测试代码和工作代码放在一起,一边同步编译和更新。(使用Ant中有支持junit的task.)
测试类和测试方法应该有一致的命名方案。如在工作类名前加上test从而形成测试类名。
确保测试与时间无关,不要依赖使用过期的数据进行测试。导致在随后的维护过程中很难重现测试。
如果你编写的软件面向国际市场,编写测试时要考虑国际化的因素。不要仅用母语的Locale进行测试。
尽可能地利用JUnit提供地assert/fail方法以及异常处理的方法,可以使代码更为简洁。
测试要尽可能地小,执行速度快。
把测试程序建立在与被测对象相同的包中
在你的原始代码目录中避免测试码出现,可在一个源码镜像目录中放测试码
在自己的应用程序包中包含一个TestSuite测试类