使用Ant进行Junit测试

  我们除了使用java来直接运行junit之外，我们还可以使用junit提供的junit task与ant结合来运行。涉及的几个主要的ant task如下：

l         <junit>，定义一个junit task

l         <batchtest>，位于<junit>中，运行多个TestCase

l         <test>，位于<junit>中，运行单个TestCase

l         <formatter>，位于<junit>中，定义一个测试结果输出格式

l         <junitreport>，定义一个junitreport task

l         <report>，位于<junitreport>中，输出一个junit report

       运行Junit需要jakarta-ant-1.4-optional.jar和Junit.jar包,因为这两个包用于支持ant task--<junit>的,所以不能在build.xml文件中加载,需要将他们放到ANT_HOME中去.使用eclipse可以按照一下步骤加入:

Windows-Preference-Ant-Runtime-Ant Home Entries

       下面看一个Junit测试的例子:

<?xml version="1.0"?> <project name="project" default="junit">          <property name="run.classpath" value="bin"></property>          <property name="run.srcpath" value="src"></property>          <property name="test.srcpath" value="test"></property>          <property name="lib.dir" value="lib"/>                       <path id="compile.path">                    <pathelement location="${lib.dir}/junit-3.8.1.jar"/>                    <pathelement location="${lib.dir}/log4j-1.2.8.jar"/>          </path>                   <target name="compile">                    <javac destdir="${run.classpath}" srcdir="${run.srcpath}"                             classpathref="compile.path"/>                    <javac destdir="${run.classpath}" srcdir="${test.srcpath}"                             classpathref="compile.path"/>          </target>                   <target name="junit" depends="compile">                    <junit printsummary="true">                             <classpath path="${run.classpath}"></classpath>                             <test name="org.ant.test.Test1"></test>                    </junit>          </target> </project>

    可以看出Junit的使用基本和java差不多, printsummary允许输出junit信息,当然Ant提供formatter属性支持多样化的junit信息输出.Ant包含三种形式的formatter:

brief:以文本格式提供测试失败的详细内容;

plain:以文本格式提供测试失败的详细内容以及每个测试的运行统计;

xml:以xml格式提供扩展的详细内容,包括正在测试时的Ant特性,系统输出,以及每个测试用      例的系统错误.

       使用formatter时建议将printsummary关闭,因为他可能对formatter的生成结果产生影响,并多生成一份同样的输出.当然我们可以使用formatter将输出结果显示在console中:

<formatter type="brief" usefile="false"/>

Junit支持多个formatter同时存在:

<formatter type="brief" usefile="false"/>

<formatter type="xml"/>

使用xml我们可以得到扩展性更强的信息输出,这时在<test>中要设定todir来指定xml的输出路径.

       在通常情况下我们不可能一个一个来处理junit,所以Ant提供了<batchtest>,可以在他里面嵌套文件集(fileset)以包含全部的测试用例.

       对于大量的用例,使用控制台输出,或者使用文件或xml文件来作为测试结果都是不合适的,Ant提供了<junitreport>任务使用XSLT将xml文件转换为HTML报告.该任务首先将生成的XML文件整合成单一的XML文件,然后再对他进行转换,这个整合的文件默认情况下被命名为:TESTS-TestSuites.xml.

<junitreport todir="${test.xml}">                <fileset dir="${test.xml}">                  <include name="TEST-*.xml"/>                </fileset>                <report format="frames" todir="${test.report}"/>              </junitreport>

<report>元素指示转换过程中生成有框架(frames)或者无框架的类似与javadoc格式的文件,并保存到todir所在的目录下面.(由于xalan对于JDK1.4以上的版本存在问题,所以要生成HTML文件需要以下步骤:现在最新的xalan,在%JAVA_HOME%/jre/lib中建立文件夹endorsed.将xalan中的jar文件copy到里面).

下面看一个完整的例子:

<?xml version="1.0"?> <projectname="project"default="junit">     <propertyname="run.classpath"value="bin"></property>     <propertyname="run.srcpath"value="src"></property>     <propertyname="test.srcpath"value="test"></property>     <propertyname="test.xml"value="xml"></property>     <propertyname="test.report"value="report"></property>     <propertyname="lib.dir"value="lib"/>         <pathid="compile.path">        <pathelementlocation="${lib.dir}/junit-3.8.1.jar"/>        <pathelementlocation="${lib.dir}/log4j-1.2.8.jar"/>     </path>         <targetname="init">        <deletedir="${test.report}"/>        <mkdirdir="${test.report}"/>        <deletedir="${test.xml}"/>        <mkdirdir="${test.xml}"/>     </target>         <targetname="compile"depends="init">        <javacdestdir="${run.classpath}"srcdir="${run.srcpath}"            classpathref="compile.path"/>        <javacdestdir="${run.classpath}"srcdir="${test.srcpath}"            classpathref="compile.path"/>     </target>         <targetname="junit"depends="compile">        <junitprintsummary="false">            <classpathpath="${run.classpath}"></classpath>            <formattertype="xml"/>            <batchtesttodir="${test.xml}">               <filesetdir="${run.classpath}">                   <includename="**/Test*.class"/>               </fileset>            </batchtest>        </junit>                <junitreporttodir="${test.xml}">           <filesetdir="${test.xml}">             <includename="TEST-*.xml"/>           </fileset>           <reportformat="frames"todir="${test.report}"/>         </junitreport>     </target> </project> <?xml version="1.0"?> <projectname="project"default="junit">     <propertyname="run.classpath"value="bin"></property>     <propertyname="run.srcpath"value="src"></property>     <propertyname="test.srcpath"value="test"></property>     <propertyname="test.xml"value="xml"></property>     <propertyname="test.report"value="report"></property>     <propertyname="lib.dir"value="lib"/>         <pathid="compile.path">        <pathelementlocation="${lib.dir}/junit-3.8.1.jar"/>        <pathelementlocation="${lib.dir}/log4j-1.2.8.jar"/>     </path>         <targetname="init">        <deletedir="${test.report}"/>        <mkdirdir="${test.report}"/>        <deletedir="${test.xml}"/>        <mkdirdir="${test.xml}"/>     </target>         <targetname="compile"depends="init">        <javacdestdir="${run.classpath}"srcdir="${run.srcpath}"            classpathref="compile.path"/>        <javacdestdir="${run.classpath}"srcdir="${test.srcpath}"            classpathref="compile.path"/>     </target>         <targetname="junit"depends="compile">        <junitprintsummary="false">            <classpathpath="${run.classpath}"></classpath>            <formattertype="xml"/>            <batchtesttodir="${test.xml}">               <filesetdir="${run.classpath}">                   <includename="**/Test*.class"/>               </fileset>            </batchtest>        </junit>                <junitreporttodir="${test.xml}">           <filesetdir="${test.xml}">             <includename="TEST-*.xml"/>           </fileset>           <reportformat="frames"todir="${test.report}"/>         </junitreport>     </target> </project>

生成的文档:

点击Properties超链接会弹出一个窗口显示在测试运行时全部的Ant特性,这对于跟踪由环境和配置造成的失败是非常便利的!