io.atomix.core.value

Interface AsyncAtomicValue<V>

Type Parameters:

V - value type

All Superinterfaces:

AsyncPrimitive, DistributedPrimitive

public interface AsyncAtomicValue<V>
extends AsyncPrimitive

Distributed version of java.util.concurrent.atomic.AtomicReference.

All methods of this interface return a future immediately after a successful invocation. The operation itself is executed asynchronous and the returned future will be completed when the operation finishes.

Field Summary

Fields inherited from interface io.atomix.primitive.DistributedPrimitive

DEFAULT_OPERATION_TIMEOUT_MILLIS

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	addListener(AtomicValueEventListener<V> listener) Registers the specified listener to be notified whenever the atomic value is updated.
CompletableFuture<Boolean>	compareAndSet(V expect, V update) Atomically sets the value to the given updated value if the current value is equal to the expected value.
CompletableFuture<V>	get() Gets the current value.
CompletableFuture<V>	getAndSet(V value) Atomically sets to the given value and returns the old value.
CompletableFuture<Void>	removeListener(AtomicValueEventListener<V> listener) Unregisters the specified listener such that it will no longer receive atomic value update notifications.
CompletableFuture<Void>	set(V value) Sets to the given value.
default AtomicValue<V>	sync() Returns a synchronous wrapper around the asynchronous primitive.
AtomicValue<V>	sync(Duration operationTimeout) Returns a synchronous wrapper around the asynchronous primitive.

Methods inherited from interface io.atomix.primitive.AsyncPrimitive

close, delete

Methods inherited from interface io.atomix.primitive.DistributedPrimitive

addStateChangeListener, name, protocol, removeStateChangeListener, type

Method Detail

compareAndSet

CompletableFuture<Boolean> compareAndSet(V expect,
                                         V update)

Atomically sets the value to the given updated value if the current value is equal to the expected value.

IMPORTANT: Equality is based on the equality of the serialized {code byte[]} representations.

Parameters:

expect - the expected value

update - the new value

Returns:

CompletableFuture that will be completed with true if update was successful. Otherwise future will be completed with a value of false

get

CompletableFuture<V> get()

Gets the current value.

Returns:

CompletableFuture that will be completed with the value

getAndSet

CompletableFuture<V> getAndSet(V value)

Atomically sets to the given value and returns the old value.

Parameters:

value - the new value

Returns:

CompletableFuture that will be completed with the previous value

set

CompletableFuture<Void> set(V value)

Sets to the given value.

Parameters:

value - value to set

Returns:

CompletableFuture that will be completed when the operation finishes

addListener

CompletableFuture<Void> addListener(AtomicValueEventListener<V> listener)

Registers the specified listener to be notified whenever the atomic value is updated.

Parameters:

listener - listener to notify about events

Returns:

CompletableFuture that will be completed when the operation finishes

removeListener

CompletableFuture<Void> removeListener(AtomicValueEventListener<V> listener)

Unregisters the specified listener such that it will no longer receive atomic value update notifications.

Parameters:

listener - listener to unregister

Returns:

CompletableFuture that will be completed when the operation finishes

sync

default AtomicValue<V> sync()

Description copied from interface: AsyncPrimitive

Returns a synchronous wrapper around the asynchronous primitive.

Specified by:

sync in interface AsyncPrimitive

Returns:

the synchronous primitive

sync

AtomicValue<V> sync(Duration operationTimeout)

Description copied from interface: AsyncPrimitive

Returns a synchronous wrapper around the asynchronous primitive.

Specified by:

sync in interface AsyncPrimitive

Parameters:

operationTimeout - the synchronous operation timeout

Returns:

the synchronous primitive