public class AtomixConsistentMap extends io.atomix.resource.AbstractResource<AtomixConsistentMap> implements AsyncConsistentMap<String,byte[]>
AsyncConsistentMap primitive.DistributedPrimitive.Status, DistributedPrimitive.Type| Modifier and Type | Field and Description |
|---|---|
static String |
CHANGE_SUBJECT |
DEFAULT_OPERTATION_TIMEOUT_MILLIS| Constructor and Description |
|---|
AtomixConsistentMap(io.atomix.copycat.client.CopycatClient client,
Properties properties) |
| Modifier and Type | Method and Description |
|---|---|
CompletableFuture<Void> |
addListener(MapEventListener<String,byte[]> listener,
Executor executor)
Registers the specified listener to be notified whenever the map is updated.
|
void |
addStatusChangeListener(Consumer<DistributedPrimitive.Status> listener)
Registers a listener to be called when the primitive's status changes.
|
CompletableFuture<Version> |
begin(TransactionId transactionId)
Begins the transaction.
|
CompletableFuture<Void> |
clear()
Removes all of the mappings from this map (optional operation).
|
CompletableFuture<Void> |
commit(TransactionId transactionId)
Commits a previously prepared transaction and unlocks the object.
|
CompletableFuture<Versioned<byte[]>> |
computeIf(String key,
Predicate<? super byte[]> condition,
BiFunction<? super String,? super byte[],? extends byte[]> remappingFunction)
If the value for the specified key satisfies a condition, attempts to compute a new
mapping given the key and its current mapped value.
|
CompletableFuture<Boolean> |
containsKey(String key)
Returns true if this map contains a mapping for the specified key.
|
CompletableFuture<Boolean> |
containsValue(byte[] value)
Returns true if this map contains the specified value.
|
CompletableFuture<Set<Map.Entry<String,Versioned<byte[]>>>> |
entrySet()
Returns the set of entries contained in this map.
|
CompletableFuture<Versioned<byte[]>> |
get(String key)
Returns the value (and version) to which the specified key is mapped, or null if this
map contains no mapping for the key.
|
CompletableFuture<Versioned<byte[]>> |
getOrDefault(String key,
byte[] defaultValue)
Returns the value (and version) to which the specified key is mapped, or the provided
default value if this map contains no mapping for the key.
|
CompletableFuture<Boolean> |
isEmpty()
Returns true if the map is empty.
|
CompletableFuture<Set<String>> |
keySet()
Returns a Set view of the keys contained in this map.
|
String |
name()
Returns the name of this primitive.
|
CompletableFuture<AtomixConsistentMap> |
open() |
CompletableFuture<Boolean> |
prepare(TransactionLog<MapUpdate<String,byte[]>> transactionLog)
Prepares a transaction for commitment.
|
CompletableFuture<Boolean> |
prepareAndCommit(TransactionLog<MapUpdate<String,byte[]>> transactionLog)
Prepares and commits a transaction.
|
CompletableFuture<Versioned<byte[]>> |
put(String key,
byte[] value)
Associates the specified value with the specified key in this map (optional operation).
|
CompletableFuture<Versioned<byte[]>> |
putAndGet(String key,
byte[] value)
Associates the specified value with the specified key in this map (optional operation).
|
CompletableFuture<Versioned<byte[]>> |
putIfAbsent(String key,
byte[] value)
If the specified key is not already associated with a value associates
it with the given value and returns null, else behaves as a get
returning the existing mapping without making any changes.
|
CompletableFuture<Versioned<byte[]>> |
remove(String key)
Removes the mapping for a key from this map if it is present (optional operation).
|
CompletableFuture<Boolean> |
remove(String key,
byte[] value)
Removes the entry for the specified key only if it is currently
mapped to the specified value.
|
CompletableFuture<Boolean> |
remove(String key,
long version)
Removes the entry for the specified key only if its current
version in the map is equal to the specified version.
|
CompletableFuture<Void> |
removeListener(MapEventListener<String,byte[]> listener)
Unregisters the specified listener such that it will no longer
receive map change notifications.
|
void |
removeStatusChangeListener(Consumer<DistributedPrimitive.Status> listener)
Unregisters a previously registered listener to be called when the primitive's status changes.
|
CompletableFuture<Versioned<byte[]>> |
replace(String key,
byte[] value)
Replaces the entry for the specified key only if there is any value
which associated with specified key.
|
CompletableFuture<Boolean> |
replace(String key,
byte[] oldValue,
byte[] newValue)
Replaces the entry for the specified key only if currently mapped
to the specified value.
|
CompletableFuture<Boolean> |
replace(String key,
long oldVersion,
byte[] newValue)
Replaces the entry for the specified key only if it is currently mapped to the
specified version.
|
CompletableFuture<Void> |
rollback(TransactionId transactionId)
Aborts a previously prepared transaction and unlocks the object.
|
CompletableFuture<Integer> |
size()
Returns the number of entries in the map.
|
Collection<Consumer<DistributedPrimitive.Status>> |
statusChangeListeners()
Returns the collection of status change listeners previously registered.
|
CompletableFuture<Collection<Versioned<byte[]>>> |
values()
Returns the collection of values (and associated versions) contained in this map.
|
close, config, context, delete, equals, hashCode, isClosed, isOpen, onEvent, onRecovery, onStateChange, options, recover, serializer, state, toString, typeclone, finalize, getClass, notify, notifyAll, wait, wait, waitaddListener, asConsistentMap, asConsistentMap, compute, computeIfAbsent, computeIfPresent, destroy, primitiveTypeapplicationIdpublic static final String CHANGE_SUBJECT
public AtomixConsistentMap(io.atomix.copycat.client.CopycatClient client,
Properties properties)
public String name()
DistributedPrimitivename in interface DistributedPrimitivepublic CompletableFuture<AtomixConsistentMap> open()
open in interface io.atomix.catalyst.util.Managed<AtomixConsistentMap>open in interface io.atomix.resource.Resource<AtomixConsistentMap>open in class io.atomix.resource.AbstractResource<AtomixConsistentMap>public CompletableFuture<Boolean> isEmpty()
AsyncConsistentMapisEmpty in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Integer> size()
AsyncConsistentMapsize in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Boolean> containsKey(String key)
AsyncConsistentMapcontainsKey in interface AsyncConsistentMap<String,byte[]>key - keypublic CompletableFuture<Boolean> containsValue(byte[] value)
AsyncConsistentMapcontainsValue in interface AsyncConsistentMap<String,byte[]>value - valuepublic CompletableFuture<Versioned<byte[]>> get(String key)
AsyncConsistentMapget in interface AsyncConsistentMap<String,byte[]>key - the key whose associated value (and version) is to be returnedpublic CompletableFuture<Versioned<byte[]>> getOrDefault(String key, byte[] defaultValue)
AsyncConsistentMapgetOrDefault in interface AsyncConsistentMap<String,byte[]>key - the key whose associated value (and version) is to be returneddefaultValue - the default value to return if the key is not setpublic CompletableFuture<Set<String>> keySet()
AsyncConsistentMapkeySet in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Collection<Versioned<byte[]>>> values()
AsyncConsistentMapvalues in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Set<Map.Entry<String,Versioned<byte[]>>>> entrySet()
AsyncConsistentMapentrySet in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Versioned<byte[]>> put(String key, byte[] value)
AsyncConsistentMapput in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is to be associatedvalue - value to be associated with the specified keypublic CompletableFuture<Versioned<byte[]>> putAndGet(String key, byte[] value)
AsyncConsistentMapputAndGet in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is to be associatedvalue - value to be associated with the specified keypublic CompletableFuture<Versioned<byte[]>> putIfAbsent(String key, byte[] value)
AsyncConsistentMapputIfAbsent in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is to be associatedvalue - value to be associated with the specified keypublic CompletableFuture<Versioned<byte[]>> remove(String key)
AsyncConsistentMapremove in interface AsyncConsistentMap<String,byte[]>key - key whose value is to be removed from the mappublic CompletableFuture<Boolean> remove(String key, byte[] value)
AsyncConsistentMapremove in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is associatedvalue - value expected to be associated with the specified keypublic CompletableFuture<Boolean> remove(String key, long version)
AsyncConsistentMapremove in interface AsyncConsistentMap<String,byte[]>key - key with which the specified version is associatedversion - version expected to be associated with the specified keypublic CompletableFuture<Versioned<byte[]>> replace(String key, byte[] value)
AsyncConsistentMapreplace in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is associatedvalue - value expected to be associated with the specified keypublic CompletableFuture<Boolean> replace(String key, byte[] oldValue, byte[] newValue)
AsyncConsistentMapreplace in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is associatedoldValue - value expected to be associated with the specified keynewValue - value to be associated with the specified keypublic CompletableFuture<Boolean> replace(String key, long oldVersion, byte[] newValue)
AsyncConsistentMapreplace in interface AsyncConsistentMap<String,byte[]>key - key key with which the specified value is associatedoldVersion - version expected to be associated with the specified keynewValue - value to be associated with the specified keypublic CompletableFuture<Void> clear()
AsyncConsistentMapclear in interface AsyncConsistentMap<String,byte[]>public CompletableFuture<Versioned<byte[]>> computeIf(String key, Predicate<? super byte[]> condition, BiFunction<? super String,? super byte[],? extends byte[]> remappingFunction)
AsyncConsistentMapcomputeIf in interface AsyncConsistentMap<String,byte[]>key - key with which the specified value is to be associatedcondition - condition that should evaluate to true for the computation to proceedremappingFunction - the function to compute a valuepublic CompletableFuture<Void> addListener(MapEventListener<String,byte[]> listener, Executor executor)
AsyncConsistentMapaddListener in interface AsyncConsistentMap<String,byte[]>listener - listener to notify about map eventsexecutor - executor to use for handling incoming map eventspublic CompletableFuture<Void> removeListener(MapEventListener<String,byte[]> listener)
AsyncConsistentMapremoveListener in interface AsyncConsistentMap<String,byte[]>listener - listener to unregisterpublic CompletableFuture<Version> begin(TransactionId transactionId)
Transactionalbegin in interface Transactional<MapUpdate<String,byte[]>>transactionId - the transaction identifier for the transaction to beginpublic CompletableFuture<Boolean> prepare(TransactionLog<MapUpdate<String,byte[]>> transactionLog)
Transactionalprepare in interface Transactional<MapUpdate<String,byte[]>>transactionLog - transaction logtrue if prepare is successful and transaction is ready to be committed
false otherwisepublic CompletableFuture<Boolean> prepareAndCommit(TransactionLog<MapUpdate<String,byte[]>> transactionLog)
TransactionalprepareAndCommit in interface Transactional<MapUpdate<String,byte[]>>transactionLog - transaction logtrue if prepare is successful and transaction was committed
false otherwisepublic CompletableFuture<Void> commit(TransactionId transactionId)
Transactionalcommit in interface Transactional<MapUpdate<String,byte[]>>transactionId - transaction identifierpublic CompletableFuture<Void> rollback(TransactionId transactionId)
Transactionalrollback in interface Transactional<MapUpdate<String,byte[]>>transactionId - transaction identifierpublic void addStatusChangeListener(Consumer<DistributedPrimitive.Status> listener)
DistributedPrimitiveaddStatusChangeListener in interface DistributedPrimitivelistener - The listener to be called when the status changes.public void removeStatusChangeListener(Consumer<DistributedPrimitive.Status> listener)
DistributedPrimitiveremoveStatusChangeListener in interface DistributedPrimitivelistener - The listener to unregisterpublic Collection<Consumer<DistributedPrimitive.Status>> statusChangeListeners()
DistributedPrimitivestatusChangeListeners in interface DistributedPrimitive