¿Qué es un método idempotente en Spring Data?

El método idempotente en Spring Data es un método del repositorio cuya ejecución repetida con los mismos parámetros de entrada garantiza el mismo resultado final en el almacenamiento de datos.

La idempotencia es importante en el desarrollo de API y sistemas distribuidos para garantizar la fiabilidad en intentos repetidos de realizar operaciones, por ejemplo, en caso de errores de red. Ejemplos de operaciones idempotentes son:

• Leer datos (SELECT).
• Actualizar un registro existente (UPDATE), donde el nuevo estado se determina exclusivamente por los parámetros de la consulta, y no por el estado actual.
• Eliminar un registro (DELETE).

Las operaciones no idempotentes incluyen:

• Crear un nuevo registro (INSERT), cuya ejecución crea una nueva entidad en cada ocasión.
• La actualización que depende del estado actual (por ejemplo, incrementar un contador).

En el contexto de Spring Data, la mayoría de los métodos generados por nombre (find, get, count), así como los métodos estándar JpaRepository (findById, findAll, deleteById), son idempotentes. Los métodos save pueden ser tanto idempotentes (actualizar una entidad existente) como no idempotentes (crear una nueva).

Ejemplo:

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

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

// Puede ser tanto idempotente (actualización) como no idempotente (creación)
<S extends User> S save(S entity);