junit使用简明手册

junit使用简要手册来自网辉在使用XP进行开发的过程，unittest是必不可少的环节。作为unittest，junit是首选的工具。本文从使用目的、如何使用、以及使用中需要考虑的问题，简略描述了junit的基本使用方法。使用目的

junit是java中书写unittest的framework，现在某些流行的unittest工具大都都是在junit上扩展而来的。现在它的版本是junit3.8.1，能够从.org上下载。使用方法1.

基本使用环节，Junit的使用非常简朴，它的基本使用环节：-

创立，从junit.framework.TestCase派生unittest需要的testcase-

书写测试办法，提供类似于以下函数签名的测试办法：publicvoidtestXXXXX();-

编译，书写完testcase后，编译所写的testcase类-

运行，启动junittestrunner，来运行这个testcase。Junit提供了2个基本的testrunner：字符界面和图形界面。启动命令分别以下：a图形界面：javajunit.swingui.TestRunnerXXXXXb字符界面：javajunit.textui.TestRunnerXXXXX2.

使用例子：importjunit.frmework.TestCase;publicclassTestSampleextendsTestCaset{

publicvoidtestMethod1(){

assertTrue(true);}}3.

setUp与tearDown，这两个函数是junitframework中提供初始化和反初始化每个测试办法的。setUp在每个测试办法调用前被调用，负责初始化测试办法所需要的测试环境；tearDown在每个测试办法被调用之后被调用，负责撤销测试环境。它们与测试办法的关系能够描述以下：测试开始->setUp->testXXXX->tearDown->测试结束4.

使用例子：importjunit.frmework.TestCase;publicclassTestSampleextendsTestCaset{

protectedvoidsetUp(){

//初始化……}

publicvoidtestMethod1(){

assertTrue(true);}potectedvoidtearDown(){

//撤销初始化……}}5.

分辨fail、exception。-

fail，盼望出现的错误。产生因素：assert函数出错（如assertFalse(true)）；fail函数产生（如fail(……)）。-

exception，不盼望出现的错误，属于unittest程序运行时抛出的异常。它和普通代码运行过程中抛出的runtime异常属于一种类型。对于assert、fail等函数请参见junit的javadoc。6.

使用例子：importjunit.frmework.TestCase;publicclassTestSampleextendsTestCaset{

protectedvoidsetUp(){

//初始化……}

publicvoidtestMethod1(){

……

try{

booleanb=……

assertTrue(b);

thrownewException(“Thisisatest.”);

fail(“Unablepoint.”);

//不可能达成

}catch(Exceptione){

fail(“Yes,Icatchu”);//应当达成点}……}potectedvoidtearDown(){

//撤销初始化……}}7.

组装TestSuite，运行更多的test。在junit中，Test、TestCase和TestSuite三者构成了composistepattern。通过组装自己的TestSuite，能够完毕对添加到这个TestSuite中的全部的TestCase的调用。并且这些定义的TestSuite还能够组装成更大的TestSuite，这样同时也方便了对于不停增加的TestCase的管理和维护。

它的另一种好处就是，能够从这个TestCase树的任意一种节点（TestSuite或TestCase）开始调用，来完毕这个节点下列的全部TestCase的调用。提高了unittest的灵活性。8.

使用例子：importjunit.framework.Test;importjunit.framework.TestSuite;publicclassTestAll{publicclassTestAll{

//定义一种suite，对于junit的作用能够视为类似于java应用程序的main。publicstaticTestsuite(){

TestSuitesuite=newTestSuite("Runningalltests.");

suite.addTestSuite(TestCase1.class);

suite.addTestSuite(TestCase2.class);

returnsuite;}}运行同运行单独的一种TestCase是同样的，参见step1“运行”。9.

使用Antjunittask。我们除了使用java来直接运行junit之外，我们还能够使用junit提供的junittask与ant结合来运行。涉及的几个重要的anttask以下：-

<junit>，定义一种junittask-

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

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

<formatter>，位于<junit>中，定义一种测试成果输出格式-

<junitreport>，定义一种junitreporttask-

<report>，位于<junitreport>中，输出一种junitreport具体的语法请参见有关文档。10.

使用例子：<junitprintsummary="yes"haltonfailure="no"><classpath>

<pathrefid="classpath"/>

<pathelementlocation="${dist.junit}"/></classpath><formattertype="brief"usefile="false"/><formattertype="xml"/><batchtesttodir="${doc.junitReport}">

<filesetdir="${dist.junit}"includes="**/*Test.class"/></batchtest></junit><junitreporttodir="${doc.junitReport}"><filesetdir="${doc.junitReport}">

<includename="TEST*-*.xml"/></fileset><reportformat="frames"styledir="${junit.styleDir}"todir="${doc.junitReport}"/></junitreport>检查表

junit的使用并不很难，然而要书写一种好的TestCase却并非易事。一种不好的TestCase往往是既浪费了时间，也起不了实际的作用。相反，一种好的TestCase，不仅能够较好的指出代码中存在的问题，并且也能够作为代码更精确的文档，同时还在持续集成的过程中起非常重要的作用。在此给出书写TestCase时需要注意的几点：-

测试的独立性：一次只测试一种对象，方便定位出错的位置。这有2层意思：一种TestCase，只测试一种对象；一种TestMethod，只测试这个对象中的一种办法。-

给测试办法一种适宜的名字。-

在assert函数中给出失败的因素，如：assertTrue(“…shouldbetrue”,

……)，方便查错。在这个例子中，如果无法通过assertTrue，那么给出的消息将被显示。在junit中每个assert函数都有第一种参数是出错时显示消息的函数原型。-

测试全部可能引发失败的地方，如：一种类中频繁改动的函数。对于那些仅仅只含有getter/setter的类，如果是由IDE（如Eclipse）产生的，则可不测；如果是人工写，那么最佳测试一下。-

在setUp和tearDown中的代码不应当是与测试办法有关的，而应当是全局有关的。如针对与测试办法A