Ant+Junit4实现自动单元测试

Ant+Junit4实现自动单元测试 



一、Junit概述 



     Junit测试是程序员测试，即所谓白盒测试，因为程序员知道被测试的软件如何（How）完成功能和完成什么样（What）的功能。 
　 Junit本质上是一套框架，即开发者制定了一套条条框框，遵循这此条条框框要求编写测试代码，如继承某个类，实现某个接口，就可以用Junit进行自动测试了。 
　　由于Junit相对独立于所编写的代码，可以测试代码的编写可以先于实现代码的编写，XP 中推崇的 test first design的实现有了现成的手段：用Junit写测试代码，写实现代码，运行测试，测试失败，修改实现代码，再运行测试，直到测试成功。以后对代码的修改和优化，运行测试成功，则修改成功。 
　　Java 下的 team 开发，采用 svn(版本控制) + ant(项目管理) + junit(集成测试) 的模式时，通过对ant的配置，可以很简单地实现测试自动化。 
　　对不同性质的被测对象，如Class，Jsp，Servlet，Ejb等，Junit有不同的使用技巧，以后慢慢地分别讲叙。以下以Class测试为例讲解，除非特殊说明。 



二、环境准备 



1、下载Apache Ant version 1.8.0，并配置环境ANT_HOME（如何配置ant环境请查阅相关资料） 



2、下载junit4的jar包，本文使用的junit版本是junit-4.4.jar，将junit-4.4.jar放入ANT_HOME/lib/下面 



三、创建测试工程、测试代码 



1、创建测试工程，工程结构 

2、创建java源代码（下面以Money这个类为例进行说明） 



package com.easyluck.helloword; 
public class Money { 
private int fAmount;// 余额 
private String fCurrency;// 货币类型 
public Money(int amount, String currency) { 
  this.fAmount = amount; 
  this.fCurrency = currency; 
} 
public int amount() { 
  return this.fAmount; 
} 
public String currency() { 
  return this.fCurrency; 
} 
public Money add(Money m) {// 加钱 
  return new Money(amount() + m.amount(), currency()); 
} 
@Override 
public boolean equals(Object anObject) {// 判断钱数是否相等 
  if (anObject instanceof Money) { 
   Money aMoney = (Money) anObject; 
   return aMoney.currency().equals(currency())&& (amount() == aMoney.amount()); 
  } 
  return false; 
} 
} 

3、创建测试代码 



Junit本身是围绕着两个设计模式来设计的：命令模式和集成模式。命令模式与集成模式的本质区别是，前者一次只运行一个测试。 



1）命令模式 



       利用TestCase定义一个子类，在这个子类中生成一个被测试的对象，编写代码检测某个方法被调用后对象的状态与预期的状态是否一致，进而断言程序代码有没有bug。 
　　当这个子类要测试不只一个方法的实现代码时，可以先建立测试基础，让这些测试在同一个基础上运行，一方面可以减少每个测试的初始化，而且可以测试这些不同方法之间的联系。 
　　例如，我们要测试Money的Add方法，可以如下: 
public class MoneyTest extends TestCase { //TestCase的子类 



    @Test 
    public void testAdd() 

{ //把测试代码放在testAdd中         Money m12CHF= new Money(12, "CHF"); //本行和下一行进行一些初始化         Money m14CHF= new Money(14, "CHF");         Money expected= new Money(26, "CHF");//预期的结果         Money result= m12CHF.add(m14CHF); //运行被测试的方法          assertTrue(expected.equals(result)); //判断运行结果是否与预期的相同     } 
} 



　　如果测试一下equals方法，用类似的代码，如下： 
public class MoneyTest extends TestCase { //TestCase的子类 



        @Test 
        public void testEquals() 

{ //把测试代码放在testEquals中         Money m12CHF= new Money(12, "CHF"); //本行和下一行进行一些初始化         Money m14CHF= new Money(14, "CHF");         assertTrue(\!m12CHF.equals(null));//进行不同情况的测试          assertEquals(m12CHF, m12CHF);          assertEquals(m12CHF, new Money(12, "CHF")); // (1)          assertTrue(\!m12CHF.equals(m14CHF));         } 
} 



　　当要同时进行测试Add和equals方法时，可以将它们的各自的初始化工作，合并到一起进行，形成测试基础,用setUp初始化，用tearDown清除。如下： 
public class MoneyTest extends TestCase {//TestCase的子类 
    private Money f12CHF;//提取公用的对象 
    private Money f14CHF; 



    protected void setUp() 

{//初始化公用对象         f12CHF= new Money(12, "CHF");         f14CHF= new Money(14, "CHF");     } 


    @Test 
    public void testEquals() 

{//测试equals方法的正确性          assertTrue(\!f12CHF.equals(null));          assertEquals(f12CHF, f12CHF);          assertEquals(f12CHF, new Money(12, "CHF"));          assertTrue(\!f12CHF.equals(f14CHF));     } 


    @Test 





    public void testSimpleAdd() 

{//测试add方法的正确性         Money expected= new Money(26, "CHF");         Money result= f12CHF.add(f14CHF);          assertTrue(expected.equals(result));     } 
} 



将以上三个中的任一个TestCase子类代码保存到名为MoneyTest.java的文件里，并在文件首行增加 import junit.framework.*; 
，都是可以运行的。关于Junit运行的问题很有意思，下面单独说明。 
　　上面为解释概念“测试基础(fixture)”，引入了两个对两个方法的测试。命令模式与集成模式的本质区别是，前者一次只运行一个测试 



2）集成模式 



利用TestSuite可以将一个TestCase子类中所有test**()方法包含进来一起运行，还可将TestSuite子类也包含进来，从而行成了一种等级关系。可以把TestSuite视为一个容器，可以盛放TestCase中的test**()方法，它自己也可以嵌套。这种体系架构，非常类似于现实中程序一步步开发一步步集成的现况。 
　　对上面的例子，有代码如下： 
public class MoneyTest extends TestCase {//TestCase的子类 
.... 
public static Test suite() {//静态Test 
TestSuite suite= new TestSuite();//生成一个TestSuite 
suite.addTest(new MoneyTest("testEquals")); //加入测试方法 
suite.addTest(new MoneyTest("testSimpleAdd")); 
return suite; 
} 
} 



　　从Junit2.0开始，有列简捷的方法: 
public class MoneyTest extends TestCase {//TestCase的子类 
.... 
public static Test suite() {静态Test 
return new TestSuite(MoneyTest.class); //以类为参数 
} 
} 




4、测试代码的运行 



1）用Junit提供的运行器运行 



2）使用ant命令运行 



（a）编写ant运行时需要的build.xml文件 



<?xml version="1.0"?> 
<!-- ============================================= 
     auto unittest task                                                           
     ========================================== --> 
<project name="auto unittest task" default="junit and report" basedir="."> 
  <property name="output folder" value="build"/> 
  <property name="src folder" value="src"/> 
  <property name="test folder" value="test"/> 
  <property name="report folder" value="report" /> 

     <property name="build.src.dir" value="${output folder}/classes" /> 
     <property name="build.testcase.dir" value="${output folder}/testcases" /> 
     <!-- - - - - - - - - - - - - - - - - - 
           set the depends jar files                     
     - - - - - - - - - - - - - - - - - --> 
     <path id="test.lib.classpath"> 
   <fileset dir="../public/test"> 
    <include name="*.jar"/> 
   </fileset> 
  </path> 
     <path id="compile.lib.classpath"> 
    <fileset dir="../public/test"> 
     <include name="**/*.jar"/> 
    </fileset> 
  </path> 

  <!-- - - - - - - - - - - - - - - - - - 
          target: test report folder init                     
         - - - - - - - - - - - - - - - - - --> 
  <target name="test init"> 
   <mkdir dir="${report folder}"/> 
   <mkdir dir="${build.src.dir}"/> 
   <mkdir dir="${build.testcase.dir}"/> 
  </target> 

  <!-- - - - - - - - - - - - - - - - - - 
          target: compile                     
         - - - - - - - - - - - - - - - - - --> 
  <target name="compile" depends="test init"> 
   <javac srcdir="${src folder}" destdir="${build.src.dir}" 
    encoding="utf-8" debug="on" deprecation="on" 
    optimize="on" failοnerrοr="true" 
             source="1.6" target="1.6"/> 
   <echo>compilation complete!</echo> 
  </target> 
  <!-- - - - - - - - - - - - - - - - - - 
          target: compile test cases                     
         - - - - - - - - - - - - - - - - - --> 
  <target name="test compile" depends="compile"> 
   <javac srcdir="${test folder}" destdir="${build.testcase.dir}" 
    encoding="utf-8" debug="on" deprecation="on" 
    optimize="on" failοnerrοr="true" 
             source="1.6" target="1.6"> 
    <classpath> 
     <pathelement path="${test.lib.classpath}"/> 
     <pathelement location="${build.src.dir}" /> 
      <pathelement path="" /> 
    </classpath> 
    <include name="**/*.java"/> 
      </javac> 
   <echo>test compilation complete!</echo> 
  </target> 

  <target name="all compile" depends="compile, test compile"> 
  </target> 

  <!-- ======================================== 
          target: auto test all test case and output report file                     
       ===================================== --> 
  <target name="junit and report" depends="all compile"> 
   <junit printsummary="on" fork="true" showoutput="true"> 
    <classpath> 
     <pathelement path="${test.lib.classpath}"/> 
     <pathelement path="${build.src.dir}"/> 
     <pathelement path="${build.testcase.dir}"/> 
    </classpath> 
    <formatter type="xml" /> 
    <batchtest todir="${report folder}"> 
     <fileset dir="${build.testcase.dir}"> 
      <include name="**/*Test*.*" /> 
     </fileset> 
    </batchtest> 
   </junit> 
   <junitreport todir="${report folder}"> 
    <fileset dir="${report folder}"> 
     <include name="TEST-*.xml" /> 
    </fileset> 
    <report format="frames" todir="${report folder}" /> 
   </junitreport> 
  </target> 

   <target name="clean" description="Deletes compiled and generated code"> 
   <delete dir="${output folder}"/> 
        <delete dir="${report folder}"/> 
   </target> 
</project> 

（b）执行ant命令，执行结果 



E:\workspaces_new\HelloWord>ant 
Buildfile: E:\workspaces_new\HelloWord\build.xml 
test init: 
    [mkdir] Created dir: E:\workspaces_new\HelloWord\report 
    [mkdir] Created dir: E:\workspaces_new\HelloWord\build\classes 
    [mkdir] Created dir: E:\workspaces_new\HelloWord\build\testcases 
compile: 
    [javac] E:\workspaces_new\HelloWord\build.xml:45: warning: 'includeantruntim 
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab 
le builds 
    [javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\classe 
s 
     [echo] compilation complete! 
test compile: 
    [javac] E:\workspaces_new\HelloWord\build.xml:56: warning: 'includeantruntim 
e' was not set, defaulting to build.sysclasspath=last; set to false for repeatab 
le builds 
    [javac] Compiling 2 source files to E:\workspaces_new\HelloWord\build\testca 
ses 
     [echo] test compilation complete! 
all compile: 
junit and report: 
    [junit] Running com.easyluck.helloword.HelloWorldTest 
    [junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec 
    [junit] Running com.easyluck.helloword.MoneyTest 
    [junit] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 0.125 sec 
[junitreport] Processing E:\workspaces_new\HelloWord\report\TESTS-TestSuites.xml 
to C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164 
[junitreport] Loading stylesheet jar:file:/D:/apache-ant/lib/ant-junit.jar!/org/ 
apache/tools/ant/taskdefs/optional/junit/xsl/junit-frames.xsl 
[junitreport] Transform time: 344ms 
[junitreport] Deleting: C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\null1711790164 
BUILD SUCCESSFUL 
Total time: 4 seconds 

5、一些问题 
有人在实践基础上总结出一些非常有价值的使用技巧，我没有经过一一“测试”，暂列在此。 



不要用TestCase的构造函数初始化Fixture，而要用setUp()和tearDown()方法。 



不要依赖或假定测试运行的顺序，因为JUnit利用Vector保存测试方法。所以不同的平台会按不同的顺序从Vector中取出测试方法。 



避免编写有副作用的TestCase。例如：如果随后的测试依赖于某些特定的交易数据，就不要提交交易数据。简单的回滚就可以了。 



当继承一个测试类时，记得调用父类的setUp()和tearDown()方法。 



将测试代码和工作代码放在一起，一边同步编译和更新。（使用Ant中有支持junit的task.） 



测试类和测试方法应该有一致的命名方案。如在工作类名前加上test从而形成测试类名。 



确保测试与时间无关，不要依赖使用过期的数据进行测试。导致在随后的维护过程中很难重现测试。 



如果你编写的软件面向国际市场，编写测试时要考虑国际化的因素。不要仅用母语的Locale进行测试。 



尽可能地利用JUnit提供地assert/fail方法以及异常处理的方法，可以使代码更为简洁。 



测试要尽可能地小，执行速度快。 



把测试程序建立在与被测对象相同的包中 



在你的原始代码目录中避免测试码出现，可在一个源码镜像目录中放测试码