JUnit测试程序

JUnit测试程序编写规范


一、 程序命名规范

１．测试类的命名

测试类的命名规则是：被测试类的类名+Test

比如有一个类叫IrgSrhDelegate，那么它的测试类的命名就是IrgSrhDelegateTest



２．测试用例的命名

测试用例的命名规则是：test+用例方法名称

比如要测试的方法叫updateData，那么测试用例的命名就是testUpdateData

(说明：“用例方法”就是指被测试的类中所包含的方法，而“测试用例”就是指测试类中所包含的方法)

比如IrgSrhDelegate中有一个方法叫做findByIrgFindParam，那么在IrgSrhDelegateTest中对应的测试用例名称就是testFindByIrgFindParam。



３．其它命名规范

本规范未说明的其它命名规范请参照《JAVA语言编码规范》（ENO-W063-JAVA Coding Rule.doc）。



二、 测试程序的包名定义规范

为了保持测试程序的独立和稳定性，请按照下面的方式组织测试程序：

假如被测试类的包名是com.wistrons.util，那么测试类的包名就是test.com.wistrons.util。也就是说在被测试类的包名前加上“test.”，这就是测试类的包名。



三、 测试数据的准备方案

准备测试数据时有三种方案可以选择。

１．在程序中直接写入测试数据

在要输入的数据项不多的情况下可以采用这种方式



２．使用junitpack包中的InputDataUtil工具类

（要使用这个工具，请在测试程序中加上import junitpack.InputDataUtil）

这种方法要求把测试数据写在一个XML文件中，XML的格式如下所示：

<?xml version="1.0" encoding="UTF-8"?>

<inputs>

<input>

<IrgCd>h0001</IrgCd>

<IrgName></IrgName>

<IrgKname></IrgKname>

</input>

<input>

…

</input>

…

</inputs>

在这个XML文件中的根节点为inputs，根节点下可以有多个input节点。每个input节点代表一个case中需要的所有数据。

使用这个工具类的操作步骤如下：

1） 获取XML的存放路径。

请把写好的XML存放在测试类所在的目录中，然后可以按如下方式取得XML的存放路径：

String xml = IrgSrhDelegateTest.class.getResource(".").toString() +"test.xml";



2） 创建InputDataUtil的实例。

InputDataUtil inputUtil = new InputDataUtil();



3） 在InputDataUtil实例中设置接受数据的类名，InputDataUtil将此类与XML进行数据绑定。

inputUtil.setClassName("jp.co.liondor.common.fz25IrgSrh. SeekIrgSrhOpt");



4） 调用InputDataUtil.parse()方法，从XML中采集数据

java.util.Vector vector = (java.util.Vector) inputUtil.parse(xml);



5） 从Vector中取出被绑定类的实例

for (int i = 0; i < vector.size(); i++) {

SeekIrgSrhOpt opt = (SeekIrgSrhOpt) vector.get(i);

…

}



现在对InputDataUtil的工作原理进行说明。InputDataUtil会根据input节点下的子节点名来设置被绑定的类中对应的set方法，然后把XML中的数据设置到被绑定类中。比如上例XML中，input节点下有三个子节点：IrgCd、IrgName、IrgKname。那么在调用InputDataUtil.parse()方法时，InputDataUtil就会分别调用SeekIrgSrhOpt类的setIrgCd()、setIrgName()、setIrgKname()方法，把数据设置到SeekIrgSrhOpt的实例类中，并返回包含这些实例类的Vector对象。



３．使用Digester

（要使用这个工具，请在测试程序中加上import org.apache.commons.digester.Digester）

Digester是Apache提供的一个工具类，上面的InputDataUtil也是从Digester类继承的。当使用InputDataUtil暂时无法解决的时候，可以直接使用Digester。

使用Digester的步骤如下：

1） 获取XML的存放路径。

获取方式与使用InputDataUtil相同。



2） 创建Digester的实例。

Digester dig = new Digester();



3） 设定与inputs节点绑定的类为Vector

dig.addObjectCreate("inputs", "java.util.Vector");



4） 设定与input节点绑定的类

dig.addObjectCreate("inputs/input",

" jp.co.liondor.common.fz25IrgSrh. SeekIrgSrhOpt ");

5） 根据input节点下的子节点，依次设定相应的set方法

dig.addCallMethod("inputs/input/ IrgCd ", "setIrgCd ", 1);

dig.addCallParam("inputs/input/ IrgCd ", 0);



6） 设定向Vector中加入数据的方法

dig.addSetNext("inputs/input", "add");



7） 调用Digester.parse()方法，从XML中采集数据

java.util.Vector vector = (java.util.Vector) dig.parse(xml);



8） 从Vector中取出被绑定类的实例

for (int i = 0; i < vector.size(); i++) {

SeekIrgSrhOpt opt = (SeekIrgSrhOpt) vector.get(i);

…

}



Digester的用法非常灵活，可以组织非常复杂的数据。

关于Digester的详细用法请参考http://jakarta.apache.org/commons/digester/。





四、 对UI测试的原则

对UI做单元测试必须做到不能牵涉到业务逻辑操作（比如数据库操作、与Server的交互）。否则就是UI的设计不合理。对UI的单元测试应该非常单纯，就只是测试界面的动作是否符合设计要求。



五、 测试数据的覆盖率

测试时所准备的测试数据要覆盖程序中所有可能出现的CASE。



六、 测试记录

记录测试的过程和结果，请使用Log4j工具。



七、 测试粒度

选择测试粒度的原则：

1） 被测试类中所有public、protected方法都要测到。

2） 对于简单的set和get方法没有必要做测试。