Co je metoda merge a jakou funkci plní?

Metoda merge se používá v různých kontextech v Javě.

1. V kontextu JPA (Java Persistence API): Metoda persist přidá entitu do kontextu perzistence, čímž ji učiní spravovanou. Metoda merge také přidá entitu, ale liší se tím, že kopíruje stav neregistrované instance entity do spravované instance. Pokud spravovaná instance neexistuje, je vytvořena. merge vrací spravovanou instanci.

   Klíčové rozdíly:

   • persist funguje pouze s novými entitami.
   • merge může pracovat s novými nebo odpojenými entitami.
   • persist nevrací novou entitu.
   • merge vrací spravovanou entitu (novou nebo aktualizovanou).

   Příklad použití v JPA:

   // JPA
   EntityManager em = ...;
   MyEntity detachedEntity = new MyEntity();
   // ... nastavení stavu detachedEntity
   
   em.getTransaction().begin();
   MyEntity managedEntity = em.merge(detachedEntity);
   // Nyní je managedEntity spravovaná instance
   em.getTransaction().commit();
   

2. V kontextu kolekcí (Map): Metoda merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction) v rozhraní Map slouží k aktualizaci nebo přidání prvku. Pokouší se přiřadit danou value ke klíči key. Pokud klíč již existuje, aplikuje se remappingFunction pro výpočet nové hodnoty na základě existující a předané. Pokud klíč neexistuje, přiřadí se předaná value (pokud není null). Pokud je výsledek remappingFunction null, prvek je odstraněn.

   Příklad použití v Map:

   // Map
   Map<String, Integer> counts = new HashMap<>();
   
   counts.merge("apple", 1, Integer::sum); // Přidá "apple": 1
   counts.merge("banana", 1, Integer::sum); // Přidá "banana": 1
   counts.merge("apple", 1, Integer::sum); // Aktualizuje "apple" na 2
   

Funkce metody merge závisí na kontextu jejího použití, ale obecně jde o slučování nebo synchronizaci stavu dat.