io.atomix.core.value

Interface AsyncDistributedValue<V>

Type Parameters:

V - value type

All Superinterfaces:

AsyncPrimitive, DistributedPrimitive

public interface AsyncDistributedValue<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(ValueEventListener<V> listener) Registers the specified listener to be notified whenever the atomic value is updated.
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(ValueEventListener<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 DistributedValue<V>	sync() Returns a synchronous wrapper around the asynchronous primitive.
DistributedValue<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

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(ValueEventListener<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(ValueEventListener<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 DistributedValue<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

DistributedValue<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