补习一下EasyMock

最近有时间, 再温习一下easymock相关的东东

http://shlteater.iteye.com/blog/394191
这篇blog对easymock原理讲解的比较详细

createControl() 用来创建一个生成mock对象的容器, 然后在replay(), verfiy的时候不用指定那些mock对象

createStrictMock 创建严格依照执行顺序mock对象

createNiceMock 宽松的mock对象, 可以被调用, 也可以不被调用, 对参数和返回值也没有严格的限制(返回值如果没有指定可以返回默认值0, null, false)

参数匹配除了使用eq()之外, 还可以使用anyInt(), anyLong()等, 参数匹配逻辑还有and(), startsWith(), endsWith()等, 此外还可以通过实现IArgumentMatcher接口定义自己的匹配模式, 在org.easymock.internal.matchers中有很多实现可以参考

在新版easymock中对于一个mock对象返回值为void的, 不用调用expectLastCall()了

easymock2.5 文档的一些摘要

mock的返回值比较常用的有两种处理方式andReturn(), andThrow(), 分别用来处理正常返回或者抛出异常. 如果需要对返回值的处理有特殊的需求, 可以直接实现IAnswer接口, easymock网站上举了一个需要自己实现IAnswer的例子, 就是对List.remove(index)的测试:

    List<String> l = createMock(List.class);

    // andAnswer style
    expect(l.remove(10)).andAnswer(new IAnswer<String>() {
        public String answer() throws Throwable {
            return getCurrentArguments()[0].toString();
        }
    });

这个连写比较有意思:

    expect(mock.voteForRemoval("Document"))
        .andReturn((byte) 42).times(3)
        .andThrow(new RuntimeException(), 4)
        .andReturn((byte) -42);

如果三次调用将返回42, 四次调用将抛出异常, 一次调用则返回-42

对调用次数的一些限定:
times(int min, int max) 指定范围
atLeastOnce() 至少一次调用
anyTimes() 任何次调用
once() 默认情况, 仅一次调用

EasyMock.createMock() 对方法调用顺序无要求
EasyMock.createStrictMock() 必须严格按照方法录制的顺序调用
verify(mock) 会显示所有不正确的方法调用

checkOrder(mock, true) 启动方法调用顺序检查

对参数的匹配检查, easymock默认的是equals(), 但是也提供了各种匹配器

比如对于数组来说, 可以采用aryEq()

anyBoolean(), anyByte(), anyChar(), anyDouble(), anyFloat(), anyInt(), anyLong(), anyObject(), anyShort()
参数可以是任意值, 基本类型和对象类型都可以

eq(X value, X delta) 参数只要在一定的范围就认为是匹配的, 仅适用float, double

capture(Capture<T> capture) 这个不知道怎么玩儿, 文档也没给例子, 估计用的比较少

定义自己的参数匹配器
这里有一个例子:

    IllegalStateException e = new IllegalStateException("Operation not allowed.")
    expect(mock.logThrowable(eqException(e))).andReturn(true);

这里首先要实现eqException()静态方法
然后实现接口IArgumentMatcher, 有两个方法需要实现:

public class ThrowableEquals implements IArgumentMatcher {
    private Throwable expected;

    public ThrowableEquals(Throwable expected) {
        this.expected = expected;
    }

    public boolean matches(Object actual) {
        if (!(actual instanceof Throwable)) {
            return false;
        }
        String actualMessage = ((Throwable) actual).getMessage();
        return expected.getClass().equals(actual.getClass())
                && expected.getMessage().equals(actualMessage);
    }

    public void appendTo(StringBuffer buffer) {
        buffer.append("eqException(");
        buffer.append(expected.getClass().getName());
        buffer.append(" with message \"");
        buffer.append(expected.getMessage());
        buffer.append("\"")");

    }
}

将mock由一种模式转换为另一种模式
resetToNice(mock), resetToDefault(mock) or resetToStrict(mock).

这里有一个andStubReturn()的例子, 不过没看出来和andReturn()有什么区别, 例子的意思是参数是Document调用一次返回42, 其他参数调用返回-1

    expect(mock.voteForRemoval("Document")).andReturn(42);
    expect(mock.voteForRemoval(not(eq("Document")))).andStubReturn(-1);

createNiceMock()创建的mock, 在调用的时候会返回空值(0, false, null)

不能对equals(), hashCode(), toString()三个方法进行mock

一个checkOrder()方法(同时也是IMocksControl)使用的例子:

    IMocksControl ctrl = createStrictControl();
    IMyInterface mock1 = ctrl.createMock(IMyInterface.class);
    IMyInterface mock2 = ctrl.createMock(IMyInterface.class);

    mock1.a();
    mock2.a();

    ctrl.checkOrder(false);

    mock1.c();
    expectLastCall().anyTimes();     
    mock2.c();
    expectLastCall().anyTimes();     

    ctrl.checkOrder(true);

    mock2.b();
    mock1.b();

    ctrl.replay();

EasyMockSupport 在2.5.2版本中出现鸟, 可以作为Test的基类来继承, 对EasyMock的一些静态方法进行了代理, 提供了一些便利的createMock, replayAll, verifyAll()等方法.