如何使用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 Docs记录此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

根据此链接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")
        ));