📚 Spring Boot 2 Essentials - Método POST, DELETE e PUT

[JayCesar]

POST

    @PostMapping
    // @ResponseStatus(HttpStatus.CREATED) // assim tmb é possível
    public ResponseEntity<Anime> save(@RequestBody Anime anime){
        // Eu utilizo o Jackson para fazer o mapemaneto automático
        // Se ele encontrar o Json igula ao conteúdo de classe, ele faz o mapeamento
        // ResponseEntity.created() precisa de uma URI
        return new ResponseEntity<>(animeService.save(anime), HttpStatus.CREATED); // Assim eu retorno um 201
    }

Eu utilizo o HttpStatus.CREATED para poder gerar o código da request no Insominai / Navegador

"Gambiarra" para simular um anco:

    private static List<Anime> animes;

    static {
        animes = new ArrayList<>(List.of(new Anime(1L, "Dragon Ball (Test - Build - Hot Swap)"), new Anime(2L, "Bersek")));
    }

Método para salvar:

   public Anime findById(long id) {
        return animes.stream()
                .filter(anime -> anime.getId().equals(id))
                .findFirst()
                .orElseThrow(() -> new ResponseStatusException(HttpStatus.BAD_REQUEST, "Anime not found"));
    }

[JayCesar]

Delete

Essa é a documentação das coisas que estão rolando na internet:
https://www.rfc-editor.org/rfc/rfc7231
Em outras palavras, é uma documentação para eu consultar quando eu criar minhas API's;

Método Idempotente:
No contexto do RFC 7231, um método de solicitação é considerado idempotente se o efeito pretendido no servidor de várias solicitações idênticas com esse método for o mesmo que o efeito de uma única solicitação desse tipo. Entre os métodos de solicitação definidos por essa especificação, PUT, DELETE e métodos de solicitação seguros (GET, HEAD, OPTIONS e TRACE) são idempotentes.
Eles precisam não alterar o estado do servidor
É quando a resposta do servidor será sempre a mesma independente da quantidade de chamadas

Controller

    @DeleteMapping(path = "{id}")
    public ResponseEntity<Void> delete(@PathVariable long id){
        animeService.delete(id);
        return new ResponseEntity<>(HttpStatus.NO_CONTENT);
    }

Service

    public void delete(long id) {

[JayCesar]

PUT

Também é um método idempotente

    @PutMapping
    public ResponseEntity<Void> replace(@RequestBody Anime anime){
        animeService.replace(anime);
        return new ResponseEntity<>(HttpStatus.NO_CONTENT);
    }