JUnit测试程序编写规范
一、 程序命名规范
1.测试类的命名
测试类的命名规则是:被测试类的类名+Test
比如有一个类叫IrgSrhDelegate,那么它的测试类的命名就是IrgSrhDelegateTest
2.测试用例的命名
测试用例的命名规则是:test+用例方法名称
比如要测试的方法叫updateData,那么测试用例的命名就是testUpdateData
(说明:“用例方法”就是指被测试的类中所包含的方法,而“测试用例”就是指测试类中所包含的方法)
比如IrgSrhDelegate中有一个方法叫做findByIrgFindParam,那么在IrgSrhDelegateTest中对应的测试用例名称就是testFindByIrgFindParam。
3.其它命名规范
本规范未说明的其它命名规范请参照《JAVA语言编码规范》(ENO-W063-JAVA Coding Rule.doc)。
二、 测试程序的包名定义规范
为了保持测试程序的独立和稳定性,请按照下面的方式组织测试程序:
假如被测试类的包名是com.wistrons.util,那么测试类的包名就是test.com.wistrons.util。也就是说在被测试类的包名前加上“test.”,这就是测试类的包名。
三、 测试数据的准备方案
准备测试数据时有三种方案可以选择。
1.在程序中直接写入测试数据
在要输入的数据项不多的情况下可以采用这种方式
2.使用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对象。
3.使用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方法没有必要做测试。
八、 附录:参考文档一览
Digester文档 http://jakarta.apache.org/commons/digester/
JAVA语言编码规范 ENO-W063-JAVA Coding Rule.doc
JUnit官方网站 http://www.junit.org