我应该如何使用 EasyMock 的 @Mock 注释（3.2 版中的新功能）？

Question

看起来 EasyMock 3.2 版现在支持使用注释来设置模拟对象。我是 EasyMock（和一般 Java）的新手，我正在尝试了解如何使用它。这些注释是做一些新的事情还是只是提供另一种做事的方式？ documentation 说：

从 EasyMock 3.2 开始，现在可以使用注释创建模拟。这是一个不错的 和更短的方法来创建你的模拟并将它们注入测试类。 这是上面的示例，现在使用注释：...

然后有一个清单显示了@TestSubject 和@Mock 注释的使用，但我不明白它是如何工作的。似乎它神奇地将被测类的私有字段设置为模拟对象。在我的大多数情况下，我只想制作返回预定义值的模拟对象，以便在 JUnit 测试用例中使用（目前不关心验证调用了哪些对象、调用了多少次等）。例如，对于某些测试，我想创建一个像这样的假 HttpServletRequest 对象：

public class SomeTest {
    // Construct mock object for typical HTTP request for the URL below 
    private static final String REQUEST_URL = "http://www.example.com/path/to/file?query=1&b=2#some-fragment";
    private static final Map<String, String> requestHeaderMap;
    static {
        Map<String, String> requestHeaders = new LinkedHashMap<String, String>();
        requestHeaders.put("host", "www.example.com");
        // ... (add any other desired headers here) ...
        requestHeaderMap = Collections.unmodifiableMap(requestHeaders);
    }

    private HttpServletRequest httpServletRequest;
    // ...

    @Before
    public void setUp() throws Exception {            
        httpServletRequest = createNiceMock(HttpServletRequest.class);
        expect(httpServletRequest.getRequestURI()).andReturn(REQUEST_URL).anyTimes();
        expect(httpServletRequest.getHeaderNames()).andReturn(Collections.enumeration(requestHeaderMap.keySet())).anyTimes();
        capturedString = new Capture<String>();
        expect(httpServletRequest.getHeader(capture(capturedString))).andAnswer(new IAnswer<String>() {
            public String answer() throws Throwable {
                String headerName = capturedString.getValue().toLowerCase();
                if (requestHeaderMap.containsKey(headerName))
                    return requestHeaderMap.get(headerName);
                else 
                    return "";
            }
        }).anyTimes();

        replay(httpServletRequest);

        // ...
    }

    @Test
    public void someMethod_givenAnHttpServletRequest_shouldDoSomething() {
        // ...
    }
}

我可以更改上面的代码以使用注释吗？如果是这样，我应该吗？什么情况下？

我认为也许将 @Mock 注释放在实例变量声明之上会自动处理 createNiceMock(...) 部分，但这似乎不起作用，所以我怀疑我误解了什么。

Answer 1

检查他们的源代码，他们使用反射将任何带有@Mock 的东西注入到@TestSubject 的字段中。他们的方法的javadoc

public static void injectMocks(final Object obj)

在 EasyMockSupport.java 中说：

向传入参数的类上使用 {@link Mock} 注释的每个字段注入一个模拟。然后，将这些模拟注入到使用 TestSubject 注释的每个类的字段中。

规则是

• 静态和最终字段被忽略
• 如果可以将模拟分配给字段，请执行此操作。同一个 mock 被多次分配
• 如果没有模拟可以分配给一个字段，静默跳过它
• 如果两个 mock 可以分配给同一个字段，则返回错误
• 在超类上递归搜索字段

注意：如果参数扩展了 EasyMockSupport，将使用它创建模拟以允许 replayAll/verifyAll 工作

@param obj 注入模拟对象的对象

@since 3.2

public static void injectMocks(final Object obj) { ... }

要使用@Mock 注释，您需要一个具有HttpServletRequest 字段的@TestSubject，以便EasyMock 设置@Mock（通过反射）。提供注释是为了更容易连接测试，它让您跳过 createMock，然后自己调用 settter。