Documenter la fiche d'un livre — exercice corrigé de Spring Boot : écrire le serveur (école d'ingénieur) (chapitre 9)

Documenter la fiche d'un livre

Le client Vue face au serveur · niveau 2

Énoncé

Avec les annotations @Operation et @ApiResponse de springdoc, donner un résumé à l'opération « fiche d'un livre » et documenter sa réponse 404. Vérifier par un test que le document OpenAPI les contient.

Corrigé


    @Operation(summary = "Fiche d’un livre",
            description = "Le livre d’ISBN donné, avec son prix et son stock.")
    @ApiResponse(responseCode = "200", description = "Le livre existe.")
    @ApiResponse(responseCode = "404", description = "Aucun livre n’a cet ISBN.")
    @GetMapping("/{isbn}")
    public LivreVue trouver(@PathVariable String isbn) {


    @Test
    void laFicheEstDocumentee() {
        assertThat(mvc.get().uri("/v3/api-docs"))
                .hasStatusOk()
                .bodyJson()
                .extractingPath("$.paths['/api/livres/{isbn}'].get.summary").isEqualTo("Fiche d’un livre");
        assertThat(mvc.get().uri("/v3/api-docs"))
                .bodyJson()
                .extractingPath("$.paths['/api/livres/{isbn}'].get.responses['404'].description")
                .isEqualTo("Aucun livre n’a cet ISBN.");
    }