编程Java单元测试

单元测试-JUnit+Ant自动化执行单元测试并生成报告

作者：聂勇 欢迎转载，请保留作者信息并说明文章来源！
2012-外伶仃岛

JUnit是Java社区广泛使用的单元测试框架，使单元测试编写和执行变得非常容易，并且几乎所有的流行Java IDE（Eclipse, NetBeans）都集成了它。而JUnit结合Ant可以自动化执行一个项目所有的单元测试并输出单元测试报告。

下面通过一个完整的脚本样例来说明如何编写Ant脚本执行一个项目的单元测试用例和输出单元测试报告。

一、定义源代码目录和编译输出目录和classpath等变量定义 | Variable Definitions

目录和变量设置

1、业务源代码目录（src.java.dir） ，单元测试源代码目录（src.test.dir）。
2、业务源代码编译后输出目录（target.java.dir），单元测试源代码编译后输出目录（target.unit-test.dir）,Cobertura打点后的输出目录（target.cover-test.dir）。
3、第三方依赖库目录。
4、单元测试执行报告输出目录（target.unit-test.dir），单元测试覆盖率报告输出目录（target.cover-test-report.dir）。
5、业务源代码编译所需的classpath（app.classpath），单元测试源代码编译所需的classpath（app.test.classpath）。

二、编译业务源代码和单元测试源代码 | Compile Code

编译设置

1、编译业务源代码。
2、编译单元测试源代码。

三、执行单元测试用例并生成单元测试报告 | Unit Test And Generate Report

生成用例和报告设置

1、批量执行单元测试，并且以xml格式输出每一个用例的执行结果。
<junit>标签配置属性说明：

  • printsummary - 为每一个测试用例通过System.out输出一行统计信息，如果出错或测试失败则通过System.err输出信息。
  • haltonerror - 执行单元测试出错时停止执行的后续用例。
  • haltonfailure - 执行单元测试失败时停止执行的后续用例。
  • fork - 在独立的VM中执行单元测试用例。
    <formatter>标签的配置属性说明：
  • type - 单元测试用例执行结果输出格式。可选项有：plain, xml, brief 或 failure
  • usefile - 单元测试用例执行结果是否输出至文件
    <batchtest>标签的配置属性说明：
  • todir - 单元测试用例执行结果输出目录。

2、根据每个用例的执行结果文件Test-*.xml输出单元测试报告。
<junitreport>标签配置属性说明：

  • todir - 单元测试报告输出目录。

四、执行脚本并查看单元测试报告 | Execute Script And View Report

在命令行中输入: ant unit-test-report ，最终输出的单元测试报告类似如下：

单元测试报告

附录：完整的Ant脚本build.xml样例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<?xml version="1.0" encoding="UTF-8" ?>
<project name="busimonitor" basedir=".">
    <property name="src.java.dir" location="${basedir}/app" />
    <property name="src.test.dir" location="${basedir}/test" />
    <property name="target.dir" location="${basedir}/classes" />
    <property name="target.java.dir" location="${target.dir}/java" />
    <property name="target.unit-test.dir" location="${target.dir}/unit-test" />
    <property name="target.cover-test.dir" location="${target.dir}/cover-test" />
    <property name="src.extend.lib.dir" location="${basedir}/lib"/>
    <property name="play.lib.dir" location="/devdata/projects/game/play-1.2.5/framework" />
    <property name="target.report.dir" location="${basedir}/report" />
    <property name="target.unit-test-report.dir" location="${target.report.dir}/unit-test" />
    <property name="target.cover-test-report.dir" location="${target.report.dir}/cover-test" />
    <path id="app.classpath">
        <fileset dir="${play.lib.dir}">
            <include name="**/*.jar" />
        </fileset>
        <fileset dir="${src.extend.lib.dir}">
            <include name="*.jar" />
        </fileset>
        <path location="${target.java.dir}" />
        <path location="${basedir}/conf" />
    </path>
    <path id="app.test.classpath">
        <path location="${target.unit-test.dir}" />
    </path>
    <target name="compile.java">
        <mkdir dir="${target.java.dir}" />
        <javac srcdir="${src.java.dir}" destdir="${target.java.dir}" 
            debug="on" source="1.6" includeantruntime="on">
            <classpath refid="app.classpath"></classpath>
        </javac>
    </target>
    <target name="compile.test" depends="compile.java">
        <mkdir dir="${target.unit-test.dir}" />
        <javac srcdir="${src.test.dir}" destdir="${target.unit-test.dir}" 
            debug="on" source="1.6" includeantruntime="on">
            <classpath refid="app.classpath"></classpath>
            <classpath refid="app.test.classpath"></classpath>
        </javac>
        <copy todir="${target.unit-test.dir}">
            <fileset dir="${src.test.dir}">
                <include name="**/*.properties" />
                <include name="**/*.xml" />
            </fileset>
        </copy>
    </target>
    <target name="compile" depends="compile.java, compile.test"></target>
    <target name="unit-test" depends="compile">
        <mkdir dir="${target.unit-test-report.dir}" />
        <junit printsummary="on" haltonerror="off" 
            haltonfailure="off" fork="on">
            <formatter type="plain" usefile="off"/>
            <formatter type="xml" usefile="on" />
            <batchtest todir="${target.unit-test-report.dir}">
                <fileset dir="${target.unit-test.dir}">
                    <include name="**/*Test.class"/>
                </fileset>
            </batchtest>
            <classpath refid="app.classpath"></classpath>
            <classpath refid="app.test.classpath"></classpath>
        </junit>
    </target>
    <target name="unit-test-report" depends="unit-test">
        <mkdir dir="${target.unit-test-report.dir}/html" />
        <junitreport todir="${target.unit-test-report.dir}">
            <fileset dir="${target.unit-test-report.dir}">
                <include name="TEST-*.xml" />
            </fileset>
            <report todir="${target.unit-test-report.dir}/html" />
        </junitreport>
    </target>
</project>

参考资料 | References

分享到： QQ空间 微信 新浪微博 腾讯微博 人人网