28

我编写了调用 Jersey 客户端 API 的代码,而后者又调用了我无法控制的 Web 服务。我不希望我的单元测试调用实际的 Web 服务。

为调用 Jersey 客户端 API 的代码编写单元测试的最佳方法是什么?我应该使用 Jersey 服务器 API 编写 JAX-RS Web 服务,然后使用 Jersey 测试框架进行单元测试吗?或者我应该模拟 Jersey Web 服务调用?我可以访问 JMock。还是我应该尝试另一种方法?

在我的研究中,我发现这个讨论描述了各种选项,但我确实找到了一个完整的解决方案。是否有可用的代码示例显示建议的 JUnit 方法?我在泽西岛的文档中找不到任何东西。

以下是相关的源代码:

public String getResult(URI uri) throws Exception {
  // error handling code removed for clarity
  ClientConfig clientConfig = new DefaultClientConfig();
  Client client = Client.create(clientConfig);
  WebResource service = client.resource(uri);
  String result = service.accept(accept).get(String.class);
  return result;
}

以下是我想通过的测试代码示例。我想测试(1)传入一个有效的 URI 并返回一个有效的字符串,以及(2)传入一个无效的(无论出于何种原因 - 无法访问或未经授权)的 URI 并返回一个异常。

@Test
public void testGetResult_ValidUri() throws Exception {
  String xml = retriever.getResult(VALID_URI);
  Assert.assertFalse(StringUtils.isBlank(xml));
}

@Test(expected = IllegalArgumentException.class)
public void testGetResult_InvalidUri() throws Exception {
  retriever.getResult(INVALID_URI);
}

以上所有内容都是对我的代码功能的简单描述。实际上,在它之上有一层接受两个 URI,首先尝试调用第一个 URI,如果该 URI 失败,则它会尝试调用第二个 URI。我希望进行单元测试,涵盖(1)第一个 URI 成功,(2)第一个 URI 失败,第二个 URI 成功,以及(3)两个 URI 都失败。这段代码非常复杂,我想使用 JUnit 测试这些不同的场景,但要做到这一点,我需要运行实际的备用 Web 服务或模拟 Jersey 客户端 API 调用。

4

3 回答 3

15

尝试使用 Mockito 或 Easymock 来模拟服务调用。您只需要模拟这些实际使用的方法 - 无需模拟每个方法。您可以为 WebResource 类创建模拟对象,然后模拟接受方法调用。

在@BeforeClass/@Before JUnit 测试方法中编写类似(Mockito 示例)

WebResource res = mock(WebResource.class);
when(res.accept(something)).thenReturn(thatWhatYouWant);

然后在您的测试中,您可以像使用真实对象一样使用 res 对象并在其上调用模拟方法。除了返回值,您还可以抛出异常。Mockito很酷。

于 2012-06-12T22:27:54.613 回答
14

通常,您真正追求的是“我使用 Jersey Client DSL 的方式是否会使用正确的有效负载和 URL 参数生成对正确 URL 的请求”。使用 Mockito 进行测试非常冗长,设置代码通常最终看起来像这样:

    when(authentication.queryParam(eq("sa"), anyBoolean())).thenReturn(testAuthentication);
    when(testAuthentication.resolveTemplate("channel", "smf")).thenReturn(testAuthentication);
    when(testAuthentication.request(
            MediaType.APPLICATION_JSON_TYPE)).thenReturn(mockRequestBuilder);
    when(mockRequestBuilder.post(any(Entity.class))).thenReturn(mockResponse);
    when(mockResponse.readEntity(ResponseWrapper.class)).thenReturn(successfulAuthResponse());

这基本上只是针对单个 REST 请求。它过于冗长,您只是在复制您认为在使用 Jersey Client DSL 时正确的步骤,而不是测试希望的结果。

而不是上面的,我的目标是模拟一个简单的服务。为此,我使用了 WireMock,它启动了一个 Jetty 服务器,我可以在其中存根诸如“期望对这个 URL 的请求,用这个消息响应并验证有效负载是这个”之类的东西。

我知道这是一个集成测试,它比仅使用 Mockito 慢一点,但我重视测试实际结果,并且在这种情况下我更重视测试的可读性。

基于 WireMock 的 Jersey 客户端测试的设置如下所示:

@Test
public void exactUrlOnly() {
    stubFor(get(urlEqualTo("/some/thing"))
            .willReturn(aResponse()
                .withHeader("Content-Type", "text/plain")
                .withBody("Hello world!")));

   assertThat(testClient.get("/some/thing").statusCode(), is(200));
   assertThat(testClient.get("/some/thing/else").statusCode(), is(404));
}
于 2014-10-22T05:17:53.990 回答
0

只需实现一个类似工作的服务,并在您的单元测试设置中使用 HttpServerFactory 启动该服务。

于 2012-06-13T00:53:54.663 回答