Co je to idempotentní metoda ve Spring Data?

Idempotentní metoda v Spring Data je metoda repozitáře, jejíž opakované provádění se stejnými vstupními parametry zaručuje stejný konečný výsledek v úložišti dat.

Idempotence je důležitá při vývoji API a distribuovaných systémů, aby byla zajištěna spolehlivost při opakovaných pokusech o provedení operací, například v případě síťových chyb. Příklady idempotentních operací jsou:

• Čtení dat (SELECT).
• Aktualizace existujícího záznamu (UPDATE), kde je nový stav určen výhradně parametry dotazu a nikoli aktuálním stavem.
• Odstranění záznamu (DELETE).

Neidempotentní operace zahrnují:

• Vytvoření nového záznamu (INSERT), který při každém provedení vytvoří novou entitu.
• Aktualizace závislá na aktuálním stavu (například inkrementace čítače).

V kontextu Spring Data jsou většina metod generovaných podle jména (find, get, count) a také standardní metody JpaRepository (findById, findAll, deleteById) idempotentní. Metody save mohou být jak idempotentní (aktualizace existující entity), tak neidempotentní (vytvoření nové).

Příklad:

// Idempotentní metoda
Optional<User> findById(Long id);

// Idempotentní metoda
void deleteById(Long id);

// Může být jak idempotentní (aktualizace), tak ne (vytvoření)
<S extends User> S save(S entity);