JUnit测试程序
类别: JAVA教程 
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方法没有必要做测试。
一、 程序命名规范
１．测试类的命名
测试类的命名规则是：被测试类的类名+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方法没有必要做测试。
