[翻译]Unit testing with JUnit 4.x and EasyMock in Eclipse - Tutorial

原文地址：http://www.vogella.de/articles/JUnit/article.html

本文地址：博客园逖靖寒 http://gpcuster.cnblogs.com

译文：

在Eclipse中使用Junit4.x与EasyMock进行单元测试

摘要

这篇文章简单讲解了如何在Eclipse中利用Junit 4.x和EasyMock进行单元测试。

当你阅读完这篇文章后，可以在Eclipse中使用JUnit进行单元测试。

1. 概要

1.1. 单元测试

单元测试开发人员写的用于测试某一个功能的代码。单元测试可以保证程序的功能正常使用。

JUnit 4.x 是一个自动化测试的框架，最初的作者是Erich Gamma and Kent Beck。它使用Java的annotation特性来标记出需要进行测试的方法。

在JUnit中，有一个非常重要的约定：所有的测试用例都不应该依赖于其他的测试用例。

1.2. 安装

下载JUnit4.x.jar可以去JUnit的官网here，并且将其添加到classpath中。

现在的Eclipse版本中已经整合了Junit，你可以直接使用。

2. 如何编写单元测试

2.1. 概览

JUnit 使用annotations来区别需要进行测试的方法。

编写一个测试用例：

给需要测试的方法加上annotations：@org.JUnit.Test
如果你希望检测2个对象是否相等，使用org.JUnit.Assert.*，并调用assertEquals()。

Static imports在Java 5.0或以上版本是有效的，如：import static org.junit.Assert.*

2.2. 编写你的第一个单元测试

编写Java代码：

package gpcuster.cnblogs.com;

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class MyFirstJUnitTest {

    @Test
    public void simpleAdd() {
        int result = 1;
        int expected = 1;
        assertEquals(result, expected);
    }
}

2.3. 在Eclipse中运行你的单元测试

在Eclipse的菜单栏中选择：Run As -> JUnit test

Eclipse将通过绿色和红色的状态栏显示运行的结果。

3. 在Eclipse中使用JUnit

3.1. 准备

创建一个全新的项目"de.vogella.junit.junittest"。添加一个lib目录，将junit4.jar添加到classpath中，如果希望知道如何添加classpath，其查看Adding an external library to the Java classpath in Eclipse。

接着创建一个test的源代码文件夹，如下图所示：

点击"Add folder"，然后点击"Create new folder"。创建一个新的文件目录"test"。

3.2. 创建一个需要测试的类

创建一个包 "gpcuster.cnblog.com"。

在包 "gpcuster.cnblog.com"中创建一个类"MyClass" 代码如下：

package gpcuster.cnblogs.com;

public class MyClass {
    public int multiply(int x, int y) {
        return x / y;
    }
}

3.3. 创建一个测试类

选中你需要测试的类，然后操作New ->JUnit Test case，再选择"New JUnit 4 test"：

如果你还没有将JUnit放到你的classpath中，Eclipse将询问你是否将其加入classpath中：

测试类的代码如下：

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class MyClassTest {

    @Test
    public void testMultiply() {
        MyClass tester = new MyClass();
        assertEquals("Result", 50, tester.multiply(10, 5));

    }
}

鼠标右击测试类，然后选择Run-As-> Junit Test。

测试结果如图所示，你可以修改代码中存在的问题，然后再次运行。如果成功，将看到绿色的状态栏。

3.4. 创建测试集

如果需要测试的用例很多，我们可以创建一个测试集，包含所有需要进行测试的测试用例。

选项需要测试的类，然后鼠标右击：New-> Other -> JUnit -Test Suite

创建的代码如下:

package gpcuster.cnblogs.com;

import org.junit.runner.RunWith;
import org.junit.runners.Suite;

@RunWith(Suite.class)
@Suite.SuiteClasses( { MyClassTest.class })
public class AllTests {
}

4. 进一步了解JUnit

4.1. setUp()与tearDown()

对于每一个测试用例，你都可以实现setUp()和tearDown(). setUp在每一个测试用例初始化的时候被调用。tearDown()在每一个测试用例结束的时候被调用。

4.2. 在Eclipse中使用Static imports

Junit中大量使用了static方法。

Eclipse无法自动导入static imports。

你需要做的是将'org.junit.Assert'导入到Java > Editor > Content Assist > Favorites中。当你这么做了以后，你可以使用Content Assist (Ctrl+Space) 来添加方法。

4.3. Annotations

JUnit 4.x中Annotations的使用如下：

Annotation	描述
@Test public void method()	需要被测试的方法。
@Before public void method()	在每一个测试用例执行前，需要调用的方法。
@After public void method()	在每一个测试用例执行后，需要调用的方法。
@BeforeClass public void method()	所有测试用例执行前，需要调用的方法。
@AfterClass public void method()	所有测试用例执行后，需要调用的方法。
@Ignore	忽略该测试的方法。
@Test(expected=IllegalArgumentException.class)	期望测试用例抛出指定的异常。
@Test(timeout=100)	测试用例期望的执行时间。

表1. Annotations

4.4. Assert语句

JUnit 4.x中Assert语句的使用如下：

Assert语句	描述
fail(String)	方法失败。
assertTrue(true)	检测是否为真。
assertsEquals([String message], expected, actual)	检测2个对象是否相等
assertsEquals([String message], expected, actual, tolerance)	检测2个对象在允许的精度范围内是否相等。
assertNull([message], object)	检测是否为空。
assertNotNull([message], object)	检测是否为非空。
assertSame([String], expected, actual)	检测2个对象是否是为一个对象。
assertNotSame([String], expected, actual)	检测2个对象是否是为非一个对象。
assertTrue([message], boolean condition)	检测是否为真。
try {a.shouldThroughException(); fail("Failed")} catch (RuntimeException e) {asserttrue(true);}	检测是否抛出异常。

表2. Assert语句

5. Easy Mock

5.1. Easy Mock 概要

我们的上一个示例非常简单，但是在实际的环境中，我们的需要测试的类可能会依赖与其他的第三方库。

所以，测试我们的类需要去模拟或者是控制其他的第三方库。最佳的处理方案应该是创建一个mock对象。mock对象可以手工编写产生也可以通过使用EasyMock来产生。

mock对象是一个空的接口，你可以完全控制实现接口的对象的所有行为。

5.2. Using Junit and Easy Mock

下载EasyMock，将easymock.jar添加到你的classpath中。

创建一个Java Project JavaMockTest。同时创建下面代码中的这些类。 IncomeCalculator需要被测试。

package income;

public enum Position {
    BOSS, PROGRAMMER, SURFER
}

                            
package income.exceptions;

public class PositionException extends RuntimeException {

    private static final long serialVersionUID = 1L;

    public PositionException(String message) {
        super(message);
    }
}

                            
package income.exceptions;

public class CalcMethodException extends RuntimeException {

    private static final long serialVersionUID = 1L;

    public CalcMethodException(String message) {
        super(message);
    }
}

                            
package income.method;

import income.Position;

public interface ICalcMethod {

    public abstract double calc(Position position);

}
                            
package income;

import income.exceptions.CalcMethodException;
import income.exceptions.PositionException;
import income.method.ICalcMethod;


public class IncomeCalculator{
    
    private ICalcMethod calcMethod;
    private Position position;

    public void setCalcMethod(ICalcMethod calcMethod){
        this.calcMethod = calcMethod;
    }
    public void setPosition(Position position){
        this.position = position;
    }
    public double calc (){
        if (calcMethod==null){
            throw new CalcMethodException("CalcMethod not yet maintained");
        }
        if (position==null){
            throw new PositionException("Position not yet maintained");
        }
        return calcMethod.calc(position);
    }
}

我们在JUnit中使用EasyMock来进行测试：

package income;

import static org.junit.Assert.assertEquals;
import static org.junit.Assert.fail;
import income.exceptions.CalcMethodException;
import income.exceptions.PositionException;
import income.method.ICalcMethod;

import org.easymock.EasyMock;
import org.junit.Before;
import org.junit.Test;

public class IncomeCalculatorTest {

    private ICalcMethod calcMethod;
    private IncomeCalculator calc;

    @Before
    public void setUp() throws Exception {
        calcMethod = EasyMock.createMock(ICalcMethod.class);
        calc = new IncomeCalculator();
    }

    @Test
    public void testCalc1() {
        // Setting up the expected value of the method call calc
        EasyMock.expect(calcMethod.calc(Position.BOSS)).andReturn(70000.0)
                .times(2);
        EasyMock.expect(calcMethod.calc(Position.PROGRAMMER))
                .andReturn(50000.0);
        // Setup is finished need to activate the mock
        EasyMock.replay(calcMethod);

        calc.setCalcMethod(calcMethod);
        try {
            calc.calc();
            fail("Exception did not occur");
        } catch (PositionException e) {

        }
        calc.setPosition(Position.BOSS);
        assertEquals(70000.0, calc.calc());
        assertEquals(70000.0, calc.calc());
        calc.setPosition(Position.PROGRAMMER);
        assertEquals(50000.0, calc.calc());
        calc.setPosition(Position.SURFER);
        EasyMock.verify(calcMethod);
    }

    @Test(expected = CalcMethodException.class)
    public void testNoCalc() {
        calc.setPosition(Position.SURFER);
        calc.calc();
    }

    @Test(expected = PositionException.class)
    public void testNoPosition() {
        EasyMock.expect(calcMethod.calc(Position.BOSS)).andReturn(70000.0);
        EasyMock.replay(calcMethod);
        calc.setCalcMethod(calcMethod);
        calc.calc();
    }

    @Test(expected = PositionException.class)
    public void testCalc2() {
        // Setting up the expected value of the method call calc
        EasyMock.expect(calcMethod.calc(Position.SURFER)).andThrow(
                new PositionException("Don't know this guy")).times(1);

        // Setup is finished need to activate the mock
        EasyMock.replay(calcMethod);
        calc.setPosition(Position.SURFER);
        calc.setCalcMethod(calcMethod);
        calc.calc();
    }

}

expect方法告诉我们的Mock对象如果针对特殊的参数返回特定的值。

我们需要调用reply方法使我们的Mock对象有效。

当调用结束的时候，你可以调用verify的方法来检查Mock对象是否被调用了。