O que é um método idempotente no Spring Data?

O método idempotente no Spring Data é um método do repositório cuja execução repetida com os mesmos parâmetros de entrada garante o mesmo resultado final no armazenamento de dados.

A idempotência é importante no desenvolvimento de APIs e sistemas distribuídos para garantir fiabilidade em tentativas repetidas de realizar operações, por exemplo, em caso de erros de rede. Exemplos de operações idempotentes incluem:

• Leitura de dados (SELECT).
• Atualização de um registo existente (UPDATE), onde o novo estado é determinado exclusivamente pelos parâmetros da consulta, e não pelo estado atual.
• Eliminação de um registo (DELETE).

Operações não idempotentes incluem:

• Criação de um novo registo (INSERT), cuja execução cria uma nova entidade a cada execução.
• A atualização que depende do estado atual (por exemplo, incrementar um contador).

No contexto do Spring Data, a maioria dos métodos gerados por nome (find, get, count), bem como os métodos padrão JpaRepository (findById, findAll, deleteById), são idempotentes. Os métodos save podem ser tanto idempotentes (atualizar uma entidade existente) como não idempotentes (criar uma nova).

Exemplo:

// Método idempotente
Optional<User> findById(Long id);

// Método idempotente
void deleteById(Long id);

// Pode ser tanto idempotente (atualização) como não idempotente (criação)
<S extends User> S save(S entity);