org.infinispan.distribution.DistributionManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of infinispan-core
Infinispan core module
There is a newer version: 15.1.0.Dev04
package org.infinispan.distribution;

import java.util.Collection;
import java.util.List;
import java.util.Set;

import org.infinispan.distribution.ch.ConsistentHash;
import org.infinispan.factories.scopes.Scope;
import org.infinispan.factories.scopes.Scopes;
import org.infinispan.remoting.transport.Address;
import org.infinispan.topology.CacheTopology;

/**
 * A component that manages the distribution of elements across a cache cluster
 *
 * @author Manik Surtani
 * @author [email protected]
 * @author Vladimir Blagojevic
 * @author [email protected]
 * @since 4.0
 */
@Scope(Scopes.NAMED_CACHE)
public interface DistributionManager {

   /**
    * Returns the data locality characteristics of a given key.
    * @param key key to test
    * @return a DataLocality that allows you to test whether a key is mapped to the local node or not, and the degree of
    * certainty of such a result.
    *
    * @deprecated Since 9.0, please use {@code getCacheTopology().getDistributionInfo(key)} instead.
    */
   @Deprecated
   DataLocality getLocality(Object key);

   /**
    * Locates a key in a cluster.  The returned addresses may not be owners of the keys if a rehash happens to be
    * in progress or is pending, so when querying these servers, invalid responses should be checked for and the next
    * address checked accordingly.
    *
    * @param key key to test
    * @return a list of addresses where the key may reside
    *
    * @deprecated Since 9.0, please use {@code getCacheTopology().getDistributionInfo(key)} instead.
    */
   @Deprecated
   List locate(Object key);

   /**
    * Returns the first Address containing the key.  Equivalent to returning the first element of {@link #locate(Object)}
    * @param key key to test
    * @return the first address on which the key may reside
    * @deprecated Since 9.0, please use {@code getCacheTopology().getDistributionInfo(key)} instead.
    */
   @Deprecated
   Address getPrimaryLocation(Object key);

   /**
    * Locates a list of keys in a cluster.  Like {@link #locate(Object)} the returned addresses may not be owners
    * of the keys if a rehash happens to be in progress or is pending, so when querying these servers, invalid responses
    * should be checked for and the next address checked accordingly.
    *
    * @param keys list of keys to locate
    * @return all the nodes that would need to write a copy of one of the keys.
    * @deprecated Since 9.0, no direct replacement.
    */
   @Deprecated
   Set locateAll(Collection