在woyo写的Junit4培训讲义

 

1. OverView

毋庸置疑，程序员要对自己编写的代码负责，您不仅要保证它能通过编译，正常地运行，而且要满足需求和设计预期的效果。单元测试正是验证代码行为是否 满足预期的有效手段之一。但不可否认，做测试是件很枯燥无趣的事情，而一遍又一遍的测试则更是让人生畏的工作。幸运的是，单元测试工具 JUnit 使这一切变得简单艺术起来。

JUnit 是 Java 社区中知名度最高的单元测试工具。它诞生于 1997 年，由 Erich Gamma 和 Kent Beck 共同开发完成。其中 Erich Gamma 是经典著作《设计模式：可复用面向对象软件的基础》一书的作者之一，并在 Eclipse 中有很大的贡献； Kent Beck 则是一位极限编程（ XP ）方面的专家和先驱。

麻雀虽小，五脏俱全。 JUnit 设计的非常小巧，但是功能却非常强大。 Martin Fowler 如此评价 JUnit ：在软件开发领域，从来就没有如此少的代码起到了如此重要的作用。它大大简化了开发人员执行单元测试的难度，特别是 JUnit 4 使用 Java 5 中的注解（ annotation ）使测试变得更加简单。

2. 概念介绍

2.1 简单测试

在附件中的代码包中有生产代码 Money 类。请看以下对 Money 类的测试代码（所有测试代码也可以在附件的代码包中查找）

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

public class TestSample {
         @Test
         public void add() {
                   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));
         }
} 

 在这段测试代码中有几点需要注意和 Junit3 测试代码不同之处：

 

1 该测试方法主要测试 Money 类中 add （）方法是否能正确对货币进行操作。在 Junit4 中对测试方法只要用 @Test 就标明该方法是测试方法。方法名字可以自行定义，不像 Junit3 中所有测试方法都要有 test 前缀。

2 测试类也不需要继承 TestCase 。 Junit4 中测试类不需要继承任何 Junit 中接口和类。

3 断言在 Junit4 中要静态导入。如本段代码中的 assertTrue 。

            Junit4 特性测试

请先阅读一遍下列代码，然后我会对这段代码的一些 Junit4 特性进行详细说明。

 

import static org.junit.Assert.assertTrue ;
import java.util.ArrayList;
import org.junit.After;
import org.junit.Before;
import org.junit.Ignore;
import org.junit.Test;

public class TestFixture {
         private Money f12CHF ;
         private Money f14CHF ;
         private Money f26CHF ;
         private Money f28USD ; 

         @Before
         public void setUp() {
                   f12CHF = new Money(12, "CHF" );
                   f14CHF = new Money(14, "CHF" );
                   f26CHF = new Money(26, "CHF" );
                   f28USD = new Money(28, "USD" );
         }

         @Test
         public void testAdd() {
                   Money result = f12CHF .add(f14CHF );
                   assertTrue (f26CHF .equals(result));
         } 

         @Ignore ("this test method isn't working now" )
         @Test (expected = IndexOutOfBoundsException.class )
         public void empty() {
                   new ArrayList<Object>().get(0);
         } 

         @After
         public void tearDown() {
                   f12CHF = null ;
                   f14CHF = null ;
                   f26CHF = null ;
                   f28USD = null ;
         } 

          @Test(timeout = 1000)
          public void testTimeOut() throws InterruptedException {
              Thread.sleep(1000);
             // Thread.sleep(1001);
             Money result = f12CHF.add(f14CHF);
         }
} 

 

1 ． @Before 和 @After

在 Junit3 中对测试数据的初始化是放在 setUp 方法中，而对测试数据的重置和销毁是放在 tearDown 方法中。在 Junit4 中则可以使用 @Before 和 @After 来代替。在这段代码中方法名字还是使用 setUp 和 tearDown 是为了让有 Junit3 经验的开发者更好理解 @Before 和 @After 。其实在 Junit4 中这两个方法名可以自行定义为其他任何名字。

2 ． @Test （ expected=XXXException.class ）

在 JUnit4.0 之前，对错误的测试，我们只能通过 fail 来产生一个错误，并在 try 块里面 assertTrue （ true ）来测试。现在，通过 @Test 中的 expected 属性就可以实现了。 expected 属性的值是一个异常的类型，如代码中的 IndexOutOfBoundsException.class 。 （注释掉 @lgnore(“this test method isn't working now ”) ，运行后可查看 ）

3 ． @Ignore

有该标记的测试方法在测试中会被忽略。，你可以为该标签传递一个 String 的参数，来表明为什么会忽略这个测试方法。比如： @lgnore(“this test method isn't working now ”) ，在执行的时候，仅会报告该方法没有实现，而不会运行该测试方法。如代码中的 empty （）方法。

4. @ Test （ timeout =… ）

该 标记 传入了一个时间（毫秒）给测试方法，如果测试方法在指定的时间之内没有运行完，则测试会失败，即使被测试方法测试正确也会失败。该标记主要用于测试被测试方法运行所需时间，即用于方法的简单性能测试。（将 Thread.sleep(1001)和 Thread.sleep(1000) 切换注释后运行查看结果对比两种结果 ）

再看下列代码。

 

import static org.junit.Assert.assertTrue ;
import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Test; 

public class TestOnce {
         private static Money f12CHF ;
         private static Money f14CHF ;
         private static Money f26CHF ;
         private static Money f28USD ; 

         @BeforeClass
         public static void setUp() {
                   f12CHF = new Money(12, "CHF" );
                   f14CHF = new Money(14, "CHF" );
                   f26CHF = new Money(26, "CHF" );
                   f28USD = new Money(28, "USD" );
         } 

         @Test
         public void testAdd() {
                   Money result = f12CHF .add(f14CHF );
                   assertTrue (f26CHF .equals(result));
         }

         @AfterClass
         public static void TearDown() {
                   f12CHF = null ;
                   f14CHF = null ;
                   f26CHF = null ;
                   f28USD = null ;
         }
} 

 

5 ． @BeforeClass 和 @AfterClass

这里 @BeforeClass 和 @AfterClass 是为了在一个 Test 类的所有测试方法执行前后各执行一次。这是为了能在 @BeforeClass 中初始化一些昂贵的资源，例如数据库连接，然后执行所有的测试方法，最后在 @AfterClass 中释放资源。

正如你看到的，由于 @BeforeClass 和 @AfterClass 仅执行一次，因此它们只能标记静态方法，在所有测试方法中共享的资源也必须是静态引用。可仔细查看上述代码中对私有成员变量和标记 @BeforeClass 和 @AfterClass 的方法的类型。

            Junit4 参数测试

有时候要对某一特定方法传入各种不同的参数值，用来测试这个方法的健壮性。在 Junit3 中必须为每种参数值单独写一个独立的测试方法。这样就造成很多测试代码测试的都是同一方法，只是传入的参数值有不同。在 Junit4 中只需要一个测试方法就能针对 N 种不同参数值进行 N 次测试。试看如下代码：

 

import static org.junit.Assert.assertTrue ;
import java.util.Arrays;
import java.util.Collection;
import org.junit.BeforeClass;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters; 

/**
  * @author Administrator
  * 第一个注意点
  */
@RunWith (Parameterized.class )
public class TestParameter {
         private static Money f12CHF ;
         //       第二个注意点
         private Money expected ;
         private Money target ;

         @BeforeClass
         public static void setUp() {
                   f12CHF = new Money(12, "CHF" );
         } 

         /**
           *  第三个注意点
           * @return
           */
         @Parameters
         public static Collection words() {
                   return Arrays.asList (new Object[][] { { new Money(23, "CHF" ), new Money(11, "CHF" ) },
                                     { new Money(28, "CHF" ), new Money(16, "CHF" ) }
                   });
         } 

         /**
           * 第四个注意点
         * 参数化测试必须的构造函数
         * @paramexpected    期望的测试结果，对应参数集中的第一个参数
         * @paramtarget 测试数据，对应参数集中的第二个参数
        */
         public TestParameter(Money expected, Money target) {
                   this .expected = expected;
                   this .target = target;
         }

         /**
           * 实际需要测试的方法
           */
         @Test
         public void add() {
                   assertTrue (expected .equals(f12CHF .add(target )));
         }
} 

 

请详细查看注释中所标注的注意点。首先测试类需要声明 @RunWith(Parameterized.class) 。然后设置两个成员变量，一个是测试期望返回的值变量，如代码中 expected ， 还有一个是测试方法传入的参数值变量，如代码中 target 。针对这两个成员变量，新建包含这两个成员变量的测试类构造方法。再新建一个方法进行参数初始化。必须将该方法声明为 static 并返回一个 Collection 类型。需要用 @Parameters 注解来修饰该方法。在该方法内部，仅仅创建一个多维 Object 数组，并将该数组转换为 List 。然后运行 Junit 后，测试通过后的界面如下图：

由图可知执行该测试类时，通过 add () 测试方法运行两次，将代码中 words 方法里的每个值对运行一次。

            Junit4 套件测试

相比 Junit3 的套件测试， Junit4 的套件测试只需要两个注解就可以运行了，而不需要写任何代码。代码示例如下：

import junit.framework.JUnit4TestAdapter;
import junit.framework.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Suite;
import org.junit.runners.Suite.SuiteClasses;

@RunWith (Suite.class )
@SuiteClasses ( { TestSample.class , TestFixture.class , TestOnce.class , TestParameter.class })
public class TestSuite {
         public static Test suite() {
                   return new JUnit4TestAdapter(TestSuite.class );
         }
} 

 

在 JUnit 4 中，套件被两个新注解所替代。第一个是 @RunWith ，设计它是为了方便让不同的运行器执行一个特别的测试类。 JUnit4 绑定一个叫做 Suite 的套件运行器，必须在 @RunWith 注释中指定这个运行器。不仅如此，还必须提供另一项叫做 @SuiteClasses 的注释，它将一个意欲表示测试套件的类列表作为参数。如代码所示，将需要测试的测试类依次放入 SuiteClasses 中就可以了。另外如果要使用ant1.7 之前的版本，则要像代码中所示对suite 方法进行编写。如果是1.7 后版本或者是使用maven 则删除suite 方法就可以了。