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" failonerror="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" failonerror="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方法以及异常处理的方法，可以使代码更为简洁。



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



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



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



在自己的应用程序包中包含一个TestSuite测试类