| 
   
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  
 
  |