ANT task之Junit、JunitReport

一、ANT任務之Junit:

　　學習ANT其實主要是學習ANT的task，ANT眾多task中有一個Testing Tasks,它下面有兩個任務：Junit和JunitReport，主要用來進行單元測試及生成單元測試報告。

Testing Tasks

Task Name	Description
Junit	Runs tests from the Junit testing framework. This task has been tested with JUnit 3.0 up to JUnit 3.7; it won't work with versions prior to JUnit 3.0.
JunitReport	Merges the individual XML files generated by the Junit task and applies a stylesheet on the resulting merged document to provide a browsable report of the testcases results.

 官方網址：http://ant.apache.org/manual/index.html  

<junit>下面可以包含其它元素，例如：

　　1、<test>：運行單個TestCase

　　2、<batchtest>：運行多個TestCase

　　3、<formatter>：定義測試結果輸出格式

 還有很多，詳細可以參考官方文檔。

 

二、項目實例：

由於ant安裝比較得簡單，網上一搜一大把且現在ecplise基本都帶ant，所以本文並未說明如何搭建ant環境。

另外，在eclipse中可以通過:window->show view 來調出Ant視圖

1、目錄結構如下：

 

2、SimpleCalculation類代碼如下：

package com.glen.he;

public class SimpleCalculation {
    public int Add(int a,int b){        
        return (a+b);        
    }

}

 

3、測試類SimpleCalculationTest代碼如下：

package com.glen.he;

import com.glen.he.SimpleCalculation;

import static org.junit.Assert.*;
import org.junit.Test;

public class SimpleCalculationTest {

    SimpleCalculation sc = new SimpleCalculation();
    
    @Test
    public void AddTest() {
        
        int c = sc.Add(3, 5);    
        
        assertEquals(8, c);        
    }
}

 

4、在項目要目錄下添加build.xml(執行一個測試)文件，內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<project name="AntDemo" default="junit" basedir=".">
    <!-- =================================================================== -->
    <!-- 變量設置  -->
    <!-- =================================================================== -->

    <!-- 源代碼src路徑 -->
    <property name="src.path" value="src/java"/>
    <!-- 編譯文件class路徑 -->
    <property name="build.path" value="build"/>
    <!-- 單元測試代碼路徑 -->
    <property name="test.path" value="src/test"/>
    <!-- lib包路徑 -->
    <property name="lib.path" value="lib"/>         
        
    <!-- =================================================================== -->
    <!-- 設置classpath -->
    <!-- =================================================================== -->
    <path id="compile.path">        
        <fileset dir="${lib.path}">
            <include name="**/*.jar"/>
        </fileset>
        
        <pathelement path="${build.path}"/>
    </path>     

    <!-- =================================================================== -->
    <!-- 清除歷史編譯class -->
    <!-- =================================================================== -->
    <target name="clean" description="clean">
        <delete dir="${build.path}"/>
    </target>

    <!-- =================================================================== -->
    <!-- 編譯測試文件，初始化目錄 -->
    <!-- =================================================================== -->
    <target name="compile" description="compile">
        <mkdir dir="${build.path}"/>                        
        <javac srcdir="${src.path}" destdir="${build.path}"  classpathref="compile.path"/>
        <javac srcdir="${test.path}" destdir="${build.path}"  classpathref="compile.path"/>
    </target>      
         
    <!-- =================================================================== -->
    <!-- 執行測試案例 -->
    <!-- =================================================================== -->
    <target name="junit" depends="clean,compile">
        <junit printsummary="true">
             <classpath refid="compile.path"/>                  
                      
             <test name="com.glen.he.SimpleCalculationTest"/>
         </junit>
     </target>

</project>

說明： 

<junit printsummary="true">
　　<classpath refid="compile.path"/>
　　<test name="com.glen.he.SimpleCalculationTest"/>
</junit>

 

<path id="compile.path">
　　<fileset dir="${lib.path}">
　　　　<include name="**/*.jar"/>
　　</fileset>
　　<pathelement path="${build.path}"/>
</path

我們在<junit〉任務下，使用了編譯后的.class文件的目錄，還有編譯所需的jar包所在的目錄。 因為，JUnit任務實際就是為我們運行Test類，而不僅僅是像我們發布Ant文件那樣只是javac編譯，只需要編譯所需的Jar包。我們還需要像java任務那樣運.class文件,所以必須包括編譯后的.class文件。

 

5、然后把build.xml文件拖到Ant視圖中，如下圖，雙擊junit執行即可。

 

6、執行結果：

 1 Buildfile: D:\AntTest\build.xml
 2 clean:
 3    [delete] Deleting directory D:\AntTest\build
 4 compile:
 5     [mkdir] Created dir: D:\AntTest\build  
 6     [javac] Compiling 1 source file to D:\AntTest\build
 7    
 8     [javac] Compiling 1 source file to D:\AntTest\build
 9 junit:
10     [junit] Running com.glen.he.SimpleCalculationTest
11     [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 0.016 sec
12 BUILD SUCCESSFUL
13 Total time: 1 second

 

三、增強版build.xml

　　通過上面第二步，基本可以達到使用ant和junit來進行單元測試，但還遠遠不夠，比如需要批量運行案例，生成報告等，下面會介紹這些內容

 

1、使用formatter屬性輸出junit信息：

• 修改build.xml文件，增加第16，49，51，57，58，59行代碼
• 修改build.xml文件，修改53行代碼，增加了todir屬性，指定xml的輸出路徑。

<?xml version="1.0" encoding="UTF-8"?>
<project name="AntDemo" default="junit" basedir=".">
    <!-- =================================================================== -->
    <!-- 變量設置  -->
    <!-- =================================================================== -->

    <!-- 源代碼src路徑 -->
    <property name="src.path" value="src/java"/>
    <!-- 編譯文件class路徑 -->
    <property name="build.path" value="build"/>
    <!-- 單元測試代碼路徑 -->
    <property name="test.path" value="src/test"/>
    <!-- lib包路徑 -->
    <property name="lib.path" value="lib"/>
    <!-- 生成報告junit4.xml路徑 -->
    <property name="report.path" value="report"/>
        
    <!-- =================================================================== -->
    <!-- 設置classpath -->
    <!-- =================================================================== -->
    <path id="compile.path">        
        <fileset dir="${lib.path}">
            <include name="**/*.jar"/>
        </fileset>
        
        <pathelement path="${build.path}"/>
    </path>     

    <!-- =================================================================== -->
    <!-- 清除歷史編譯class -->
    <!-- =================================================================== -->
    <target name="clean" description="clean">
        <delete dir="${build.path}"/>
    </target>

    <!-- =================================================================== -->
    <!-- 編譯測試文件，初始化目錄 -->
    <!-- =================================================================== -->
    <target name="compile" description="compile">
        <mkdir dir="${build.path}"/>                        
        <javac srcdir="${src.path}" destdir="${build.path}"  classpathref="compile.path"/>
        <javac srcdir="${test.path}" destdir="${build.path}"  classpathref="compile.path"/>
    </target>      
         
    <!-- =================================================================== -->
    <!-- 執行測試案例 -->
    <!-- =================================================================== -->
    <target name="junit" depends="clean,compile">
        <mkdir dir="${report.path}"/>        
        <junit printsummary="true" fork="true">        
             <formatter type="xml" usefile="true"/>            
             <classpath refid="compile.path"/>                                  
             <test name="com.glen.he.SimpleCalculationTest" todir="${report.path}" fork="true"/>
         </junit>
     </target>

    <target name="delete">
        <delete dir="${report.path}"/>
    </target>
    
</project>

執行junit的task后，在項目report目錄下生成了一個名為TEST-com.glen.he.SimpleCalculationTest.xml的xml文件。

另外：

<formatter type="xml" usefile="true"/>中type屬性值還有plain、brief

這時會輸出一個文本文件，提供測試失敗時的詳細內容以及每個測試的運行統計。

 

 2、批量運行單元測試案例：

•  修改build.xml文件，把步驟7中的第53行代碼替換成下面的58~62行代碼;

<?xml version="1.0" encoding="UTF-8"?>
<project name="AntDemo" default="junit" basedir=".">
    <!-- =================================================================== -->
    <!-- 變量設置  -->
    <!-- =================================================================== -->

    <!-- 源代碼src路徑 -->
    <property name="src.path" value="src/java"/>
    <!-- 編譯文件class路徑 -->
    <property name="build.path" value="build"/>
    <!-- 單元測試代碼路徑 -->
    <property name="test.path" value="src/test"/>
    <!-- lib包路徑 -->
    <property name="lib.path" value="lib"/>
    <!-- 生成報告junit4.xml路徑 -->
    <property name="report.path" value="report"/>
        
    <!-- =================================================================== -->
    <!-- 設置classpath -->
    <!-- =================================================================== -->
    <path id="compile.path">        
        <fileset dir="${lib.path}">
            <include name="**/*.jar"/>
        </fileset>
        
        <pathelement path="${build.path}"/>
    </path>     

    <target name="init">
        <mkdir dir="${build.path}"/>
        <mkdir dir="${report.path}"/>
    </target>
    
    <!-- =================================================================== -->
    <!-- 清除歷史編譯class -->
    <!-- =================================================================== -->
    <target name="clean" description="clean">
        <delete dir="${build.path}"/>
    </target>

    <!-- =================================================================== -->
    <!-- 編譯測試文件，初始化目錄 -->
    <!-- =================================================================== -->
    <target name="compile" depends="init" description="compile">
        <javac srcdir="${src.path}" destdir="${build.path}"  classpathref="compile.path"/>
        <javac srcdir="${test.path}" destdir="${build.path}"  classpathref="compile.path"/>
    </target>      
         
    <!-- =================================================================== -->
    <!-- 執行測試案例 -->
    <!-- =================================================================== -->
    <target name="junit" depends="compile">                
        <junit printsummary="true" fork="true">        
             <formatter type="xml" usefile="true"/>        
            
             <classpath refid="compile.path"/>        
            
            <batchtest fork="on" todir="${report.path}" haltonfailure="no">
                <fileset dir="${build.path}">
                    <include name="**/*Test.class"/>
                </fileset>
            </batchtest>            
             
         </junit>

     </target>

    <!-- 清除Junit生成的報表文檔 -->
    <target name="delete">
        <delete dir="${report.path}"/>
    </target>
    
</project>

 

 3、使用<JunitReport>生成測試報告：

　　在上面我們已經知道，通過formatter(type=“xml”)輸出junit信息時會在指定目錄下生成一個Test-類路徑名.xml的xml文件，但是這個xml文件看起來很不方便。Ant提供了<junitreport>任務使用XSLT將xml文件轉換為HTML報告，該任務首先將生成的XML文件整合成單一的XML文件,然后再對他進行轉換,這個整合的文件默認情況下被命名為:TESTS-TestSuites.xml.

• 修改上面的build.xml文件，增加65~71行，如下：

<?xml version="1.0" encoding="UTF-8"?>
<project name="AntDemo" default="junit" basedir=".">
    <!-- =================================================================== -->
    <!-- 變量設置  -->
    <!-- =================================================================== -->

    <!-- 源代碼src路徑 -->
    <property name="src.path" value="src/java"/>
    <!-- 編譯文件class路徑 -->
    <property name="build.path" value="build"/>
    <!-- 單元測試代碼路徑 -->
    <property name="test.path" value="src/test"/>
    <!-- lib包路徑 -->
    <property name="lib.path" value="lib"/>
    <!-- 生成報告junit4.xml路徑 -->
    <property name="report.path" value="report"/>
        
    <!-- =================================================================== -->
    <!-- 設置classpath -->
    <!-- =================================================================== -->
    <path id="compile.path">        
        <fileset dir="${lib.path}">
            <include name="**/*.jar"/>
        </fileset>
        
        <pathelement path="${build.path}"/>
    </path>     

    <target name="init">
        <mkdir dir="${build.path}"/>
        <mkdir dir="${report.path}"/>
    </target>
    
    <!-- =================================================================== -->
    <!-- 清除歷史編譯class -->
    <!-- =================================================================== -->
    <target name="clean" description="clean">
        <delete dir="${build.path}"/>
    </target>

    <!-- =================================================================== -->
    <!-- 編譯測試文件，初始化目錄 -->
    <!-- =================================================================== -->
    <target name="compile" depends="init" description="compile">
        <javac srcdir="${src.path}" destdir="${build.path}"  classpathref="compile.path"/>
        <javac srcdir="${test.path}" destdir="${build.path}"  classpathref="compile.path"/>
    </target>      
         
    <!-- =================================================================== -->
    <!-- 執行測試案例 -->
    <!-- =================================================================== -->
    <target name="junit" depends="compile">                
        <junit printsummary="true" fork="true">        
             <formatter type="xml" usefile="true"/>        
            
             <classpath refid="compile.path"/>        
            
            <batchtest fork="on" todir="${report.path}" haltonfailure="no">
                <fileset dir="${build.path}">
                    <include name="**/*Test.class"/>
                </fileset>
            </batchtest>                 
         </junit>
        
        <!-- 產生單元測試報表文檔 -->
        <junitreport todir="${report.path}">
            <fileset dir="${report.path}">
                <include name="TEST-*.xml" />
            </fileset>
            <report format="frames" todir="${report.path}" />
        </junitreport>

     </target>

    <!-- 清除Junit生成的報表文檔 -->
    <target name="delete">
        <delete dir="${report.path}"/>
    </target>
    
</project>

執行后會在指定目錄下生成報告文檔，打開index.html可以很方便的看到執行的結果。

 1、如下圖所示（我又補充了3個案例，並且故意讓兩個案例失敗），顯示執行的統計結果：

 

2、點擊classes下面的ComplexCalculationTest，可以看到具體某個類里面的單元測試案例執行統計情況以及失敗案例的錯誤信息提示。

 

 

OVER！

 

參考：

http://blog.csdn.net/shendl/article/details/532587

http://blog.csdn.net/tochal/article/details/12560151