如何使用 Spring Rest Docs 记录对象列表

Question

我正在使用 Spring Rest Docs 来记录我的 REST API。我在我的集成测试中使用 mockMVC，我想记录以下 JSON 响应：

GET /api/v1/customers/3b658b39-4264-4995-99d8-90a1672a75a7

{
    "id": "3b658b39-4264-4995-99d8-90a1672a75a7",
    "name": "Foo",
    "nickname": "Bar",
    "phones": [
        {
            "id": "6ca3a963-bacb-4770-a470-5902b4a17b77", 
            "alias": "Personal Phone 1",   
            "countryCode": "55",
            "areaCode": "34",
            "number": "99999-9999"
        },
        {
            "id": "f3a3726b-b5f8-4652-a044-7bf3d95a37de",
            "alias": "Personal Phone 2",    
            "countryCode": "55",
            "areaCode": "34",
            "number": "88888-8888"
        }
    ]
}

如何记录上面的电话列表？您可以使用以下使用 Spring REST 文档的代码段来记录此 API 操作：

this.mockMvc.perform(
    get("/api/v1/customers/3b658b39-4264-4995-99d8-90a1672a75a7")
       .accept(APPLICATION_JSON))
       .andExpect(status().isOk())
           .andDo(document("customer").withResponseFields(
               fieldWithPath("id").description("Unique identifier"),
               fieldWithPath("name").description("Customer full name"),
               fieldWithPath("nickname").description("How the customer wants to be called")));

Answer 1

据此link https://docs.spring.io/spring-restdocs/docs/current/reference/html5/#documenting-your-api-request-response-payloads-fields-json

记录嵌套数组对象时，可以这样使用：

this.mockMvc.perform(
get("/api/v1/customers/3b658b39-4264-4995-99d8-90a1672a75a7")
   .accept(APPLICATION_JSON))
   .andExpect(status().isOk())
       .andDo(document("customer").withResponseFields(
           fieldWithPath("id").description("Unique identifier"),
           fieldWithPath("name").description("Customer full name"),
           fieldWithPath("nickname").description("How the customer wants to be called"),
           fieldWithPath("phones[].id").description("PHONE ID DESCRIPTION"),
           fieldWithPath("phones[].alias").description("PHONE ALIAS DESCRIPTION"),
           fieldWithPath("phones[].countryCode").description("PHONE COUNTRY CODE DESCRIPTION"),
           fieldWithPath("phones[].areaCode").description("PHONE AREA CODE DESCRIPTION")
           fieldWithPath("phones[].number").description("PHONE NUMBER DESCRIPTION")
        ));

如何使用 Spring Rest Docs 记录对象列表

How to document list of objects using Spring Rest Docs

java

documentation

spring

spring-restdocs