Recursos swagger (tags)

• Incluiremos anotações nos recursos (controllers)

@Tag(name = "Movies", description = "Controller for Movie")
public class MovieController {}

Resultado:

Anotações nos endpoints REST

@Operation(
    description = "Create a new movie",
    summary = "Create a new movie",
    responses = {
         @ApiResponse(description = "Created", responseCode = "201"),
         @ApiResponse(description = "Bad Request", responseCode = "400"),
         @ApiResponse(description = "Unauthorized", responseCode = "401"),
         @ApiResponse(description = "Forbidden", responseCode = "403"),
         @ApiResponse(description = "Unprocessable Entity", responseCode = "422")
    }
)
@PreAuthorize("hasRole('ROLE_ADMIN')")
@PostMapping(produces = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<MovieDTO> insert(@RequestBody MovieDTO dto) {

@GetMapping(value = "/{id}", produces = MediaType.APPLICATION_JSON_VALUE)
public MovieDTO findById(@PathVariable Long id) {

Antes: Só tínhamos o 200 no movies.

Depois: Os outros códigos inseridos + o media type de JSON.