IDC资讯中心
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方法没有必要做测试。
