Spring HATEOAS / MockMvc / JsonPath最佳实践

时间:2014-08-29 14:46:57

标签: spring rest spring-data-rest spring-hateoas

我正在使用MockMvc和JsonPath为Spring HATEOAS后端编写单元测试。 要测试响应中包含的链接,我正在执行以下操作:

@Test
public void testListEmpty() throws Exception {
    mockMvc.perform(get("/rest/customers"))
            .andExpect(status().isOk())
            .andExpect(content().contentType(MediaType.APPLICATION_JSON))
            .andExpect(jsonPath("$.links", hasSize(1))) // make sure links only contains self link
            .andExpect(jsonPath("$.links[?(@.rel=='self')]", hasSize(1))) //  make sure the self link exists 1 time
            .andExpect(jsonPath("$.links[?(@.rel=='self')].href", contains("http://localhost/rest/customers{?page,size,sort}"))) // test self link is correct
            .andExpect(jsonPath("$.links[?(@.rel=='self')][0].href", is("http://localhost/rest/customers{?page,size,sort}"))) // alternative to test self link is correct
            .andExpect(jsonPath("$.content", hasSize(0))); // make sure no content elements exists
}

但是我想知道是否有一些最好的做法我应该用它来让自己更容易:

  • 包含http://localhost的测试链接感觉不对。我可以使用一些Spring MovkMvc助手来确定主机吗?
  • 使用JsonPath时,很难测试数组是否包含2个属性具有特定值的元素。 就像那样,数组应该包含一个具有特定值的自链接。 有没有更好的方法来测试上面那个 在测试包含错误消息的字段的验证错误时,这也会发挥作用。

我在一些博文中看到了如下所示的技巧:

.andExpect(jsonPath("$.fieldErrors[*].path", containsInAnyOrder("title", "description")))
.andExpect(jsonPath("$.fieldErrors[*].message", containsInAnyOrder(
    "The maximum length of the description is 500 characters.",
    "The maximum length of the title is 100 characters.")));

但这并不能保证标题有特定的错误信息。 也可能是标题错误地“描述的最大长度为500个字符”。但测试会成功。

2 个答案:

答案 0 :(得分:2)

您可以使用Traverson(包含在Spring HATEOAS中)遍历测试中的链接。

如果您使用的是Spring Boot,我会考虑使用@WebIntegrationTest("server.port=0")而不是MockMvc,因为在某些情况下,我遇到的行为与实际应用程序略有不同。

您可以在我的帖子中找到一些示例:Implementing HAL hypermedia REST API using Spring HATEOAS。 另请查看tests in the sample project

答案 1 :(得分:0)

在不牺牲对数组元素测试两个属性约束的需求的情况下,解决http://localhost问题的一种方法是使用org.hamcrest.CoreMatchers.hasItem(org.hamcrest.Matcher nestedMatcher)匹配器。您上面显示的测试现在变为:

.andExpect(jsonPath("$.links[?(@.rel=='self')].href", hasItem(endsWith("/rest/customers{?page,size,sort}"))))
.andExpect(jsonPath("$.links[?(@.rel=='self')][0].href", hasItem(endsWith("/rest/customers{?page,size,sort}"))))