Exemple JUnit 5 (Jupiter)
La documentation de l’exemple est générée dans le répertoire target/generated-snippets. Il serait possible de spécifier un autre répertoire.
Code de mockMvc
Le mock est celui qui est utilisé par Spring REST Docs pour générer la documentation. Il est relativement complexe. L’idéal est d’utiliser l’exemple qui est en téléchargement pour suivre les indications.
private MockMvc mockMvc;
@ExtendWith(RestDocumentationExtension.class)
public class JUnit5ExampleTests {
private MockMvc mockMvc;
@BeforeEach
public void setUp(WebApplicationContext webApplicationContext,
RestDocumentationContextProvider restDocumentation) {
this.mockMvc =
MockMvcBuilders.webAppContextSetup(webApplicationContext)
.apply(documentationConfiguration(restDocumentation))
.build();
}
Appel du service :
this.mockMvc.perform(get("/").accept(MediaType.APPLICATION_JSON))
.andExpect(status().isOk())
.andDo(document("index"));
Lors des builds, l’outil génère des extraits qui sont des modèles réutilisables. Nous pouvons ensuite personnaliser ces extraits...