Requête et réponse

Un corps de la requête par défaut est généré dans le fichier request-description.adoc. 

Celui de la réponse dans response-description.adoc.

Pour un Body :

{  
  "contact": {   
    "name": "Jane Doe",  
    "email": "jane.doe@example.com"  
  }  
} 

Nous pouvons configurer ainsi :

this.mockMvc.perform(get("/user/5") 
.accept(MediaType.APPLICATION_JSON)) 
  .andExpect(status().isOk())  
  .andDo(document("index",  
  responseFields(  
    fieldWithPath("contact.email")  
    .description("The user's email address"), [...] 

La requête est présentée sous la forme d’un tableau ayant pour extrait le fichier request-fields.adoc.

Nous pouvons aussi utiliser des chemins JSON.

Il est aussi possible de préciser le type du champ via le type (Object) de la classe FieldDescriptor.

.andDo(document("index",  
  responseFields(  
  fieldWithPath("contact.email").type(JsonFieldType.STRING)  
    .description("The user's email address"))));