这是我以前任项目经理时,编写的关于单元测试方面的作业指导书,针对多种开发环境叙述怎么进行单元测试以及环境配置,现在整理了一下。应该对大家有所帮助。
这是第二部分。
3.3 JAVA标准
3.3.1测试环境使用JSDK1.3
3.3.1.1前题:
使用JUnit3.7版,解压后,路径为x:\\junit3.7;
使用Ant1.3版,解压后,路径为x:\\ant1.3;
配置测试框架使用环境:
测试框架使用环境可以在build.xml文件中配置,此文件是ant的输入文件,ant根据其来生成和执行应用程序;(这相当于C/C++的Makefile文件,但比之功能要强大、且配置更为简单);
1.x:\\ant1.3\bin目录下含有ant执行程序的批处理文件,所以要将此目录加入到系统环境变量path中;
2.建立项目文件目录结构;我建议在进行项目开发能有一个完整的目录结构,如下所示:
“AntCons”为项目目录名称,可以替换为所需要的项目名称;在项目目录下有两个子目录分别为build和src,这两个子目录分别为源文件目录和发布文件目录;而src(源文件目录)又分为main(源文件)和test(测试文件)目录。而com.myjava则是包名,对应于源java文件中的package;
3.在项目目录中建立build.xml文件(未涉及测试的),文件大致结构如下所示:
定义项目名称及位置
<project default="dist" name="MyTest" basedir="." >
首先声明一些变量,便于使用
<property name="builddir" value="build/classes" />
<property name="projectname" value="MyTest" />
<property name="extclasslib" value="D:\Work_Java\AntCons\build\classes" />
定义目标:编译;
在此目标中将建立发布目录、编译目标java源文件并且指定class路径;
<target name="compile">
<mkdir dir="${builddir}" />
<javac destdir="${builddir}" srcdir="src/main/"
classpath="${java.class.path};${extclasslib}">
<include name="**/*.java" />
</javac>
</target>
定义目标:运行;
此目标依赖于编译目标;
<target name="runtest" depends="compile">
<java classname="com.myjava.UseHello" fork="yes" taskname="usehello">
<classpath path="${java.class.path};${extclasslib}">
</classpath>
</java>
</target>
</project>
(build.xml相关标记的说明可以在ant下载包的说明文档中找到,ant定义了很多方便操作的指令)
4.编写代码文件,我们假设代码文件位于com.myjava包中,则代码文件将放置于src/main/com/myjava目录下;
5.编写单元测试文件,依照上面的项目目录设置,则单元测试文件放置于src/test下;
3.3.1.2建立测试用例:
1、以类名加前辍“Test”命名测试单元文件名,比如“Sample”类的类文件名为Sample.java,则测试单元文件命名为TestSample.java;
2、编写测试用例类,在测试用例类中引入测试框架包以及要测试的包声明,以TestSample为例:
测试文件TestSample.java:
package test.Sample; //测试包声明
import junit.framework.*; //引入测试框架包
import xxxx; //引入被测试单元包
//派生测试框架的测试用例类
public class TestSimple extends TestCase {
protected int fValue1;
protected int fValue2;
public TestSimple(String name) {
super(name);
}
//用例初始化,可作为桩函数
protected void setUp() {
fValue1= 2;
fValue2= 3;
}
//用例析构
protected void tearDown(){
}
//组装测试用例
public static Test suite() {
/*
* the type safe way
*
//增加测试用例到“箱子”
TestSuite suite= new TestSuite();
suite.addTest(
new TestSimple("add") {
protected void runTest() { testAdd(); }
}
);
suite.addTest(
new TestSimple("testDivideByZero") {
protected void runTest() { testDivideByZero(); }
}
);
return suite;
*/
/*
* the dynamic way
*/
return new TestSuite(TestSimple.class);
}
//用例1:
public void testAdd() {
//normal test, 功能测试,属黑盒测试
double result= fValue1 + fValue2;
assertTrue(result == 6);
//extra test, 条件及错误路径测试,属白盒测试
//except test, 异常测试,属白盒测试
//other test, see the functions "...",
//其它测试,比如被测试类的基类方法,在此需要做出说明
}
//用例2:
public void testDivideByZero() {
//................
}
//用例3:
public void testEquals() {
//.................
}
}
3. 编写驱动测试用例类,将各个测试用例组装到一起进行测试:
package test.Sample; //测试包声明
import junit.framework.*; //引入测试框架包
import xxxx; //引入被测试单元包
/**
* TestSuite that runs all the sample tests
*
*/
public class AllTests {
public static void main (String[] args) {
junit.textui.TestRunner.run (suite());
}
public static Test suite ( ) {
//建立测试用例的“箱子”
TestSuite suite= new TestSuite("All Tests");
suite.addTest(TestSimple.suite());
//此处增加一些其它单元测试类
//......
suite.addTest(junit.tests.AllTests.suite());
return suite;
}
}
4. 将测试单元的编译及运行加入到build.xml中;
在build.xml的project标记加入两个目标,现在的build.xml如下所示:
定义项目名称及位置
<project default="dist" name="MyTest" basedir="." >
首先声明一些变量,便于使用
<property name="appname" value="sample" />
<property name="builddir" value="build/classes" />
<property name="projectname" value="MyTest" />
<property name="extclasslib" value="D:\Work_Java\AntCons\build\classes" />
定义目标:依赖库检测;
<target name="JUNIT">
<available property="junit.present" classname="junit.framework.TestCase" />
</target>
定义目标:编译;
在此目标中将建立发布目录、编译目标java源文件并且指定class路径;
<target name="compile" depends="JUNIT">
<mkdir dir="${builddir}" />
<javac destdir="${builddir}" srcdir="src/main/"
classpath="${java.class.path};${extclasslib}">
<include name="**/*.java" />
</javac>
</target>
定义目标:打包;
在此目标中将建立分发包目录、将编译完成的.class文件打包为jar文件;
<target name="jar" depends="compile">
<mkdir dir="build/lib"/>
<jar jarfile="build/lib/${appname}.jar"
basedir="${builddir}" includes="com/**"/>
</target>
定义目标:编译测试用例;
<target name="compiletests" depends="jar">
<mkdir dir="build/testcases"/>
<javac srcdir="src/test" destdir="build/testcases">
<classpath>
<pathelement location="build/lib/${appname}.jar" />
<pathelement path="" />
</classpath>
<include name="**/*.java"/>
</javac>
</target>
定义目标:运行应用程序;
此目标依赖于编译目标;
<target name="runtest" depends="compile">
<java classname="com.myjava.UseHello" fork="yes" taskname="usehello">
<classpath path="${java.class.path};${extclasslib}">
</classpath>
</java>
</target>
定义目标:运行测试用例;
在此目标中将运行测试用例,运行在窗口中进行还是在控制台进行取决于所用classname,"junit.textui.TestRunner"表示在控制台进行,如果改为"junit.ui.TestRunner"则可以在窗口中运行
<target name="runtests" depends="compiletests" if="junit.present">
<java fork="yes" classname="junit.textui.TestRunner"
taskname="junit" failonerror="true">
<arg value="test.Sample.AllTests"/>
<classpath>
<pathelement location="build/lib/${appname}.jar" />
<pathelement location="build/testcases" />
<pathelement path="" />
<pathelement path="${java.class.path}" />
</classpath>
</java>
</target>
</project>
5. 最后,在项目所在目录执行Ant target_name,比如:运行测试用例可以使用Ant runtests;