Package org.infinispan.xsite.spi

Interface XSiteEntryMergePolicy<K,V>

All Known Implementing Classes:
AlwaysRemoveXSiteEntryMergePolicy, DefaultXSiteEntryMergePolicy, PreferNonNullXSiteEntryMergePolicy, PreferNullXSiteEntryMergePolicy, XSiteMergePolicy
public interface XSiteEntryMergePolicy<K,V>
An interface to resolve conflicts for asynchronous cross-site replication.
Since:
12.0
Author:
Pedro Ruivo

  • Method Details

    • merge

      CompletionStage<SiteEntry<V>> merge(K key, SiteEntry<V> localEntry, SiteEntry<V> remoteEntry)
      Resolves conflicts for asynchronous cross-site replication.

      When a conflict is detected (concurrent updates on the same key in different sites), this method is invoked with the local data and the remote site's data (SiteEntry). It includes the value and the Metadata associated.

      The value and the Metadata may be null. If that is the case, it means the key doesn't exist (for localEntry) or it is a remove operation (for remoteEntry).

      The returned SiteEntry must be equal independent of the order of the arguments (i.e. resolve(k, s1, s2).equals(resolve(k, s2, s1))) otherwise your date may be corrupted. It is allowed to return one of the arguments (localEntry or remoteEntry) and to create a new SiteEntry with a new value.

      Note: if the return SiteEntry.getValue() is null, Infinispan will interpret it to remove the key.

      Note2: This method shouldn't block (I/O or locks). If it needs to block, use a different thread and complete the CompletionStage with the result. We recommend using BlockingManager.supplyBlocking(Supplier, Object).

      Parameters:
      key - The key that was updated concurrently.
      localEntry - The local value and Metadata stored.
      remoteEntry - The remote value and Metadata received.
      Returns:
      A CompletionStage with the SiteEntry.