org.onosproject.store.primitives.impl

Class ExecutingAsyncAtomicValue<V>

java.lang.Object

org.onosproject.store.primitives.impl.DelegatingDistributedPrimitive

org.onosproject.store.primitives.impl.ExecutingDistributedPrimitive

org.onosproject.store.primitives.impl.ExecutingAsyncAtomicValue<V>

All Implemented Interfaces:

AsyncAtomicValue<V>, DistributedPrimitive

public class ExecutingAsyncAtomicValue<V>
extends ExecutingDistributedPrimitive
implements AsyncAtomicValue<V>

AsyncAtomicValue that executes asynchronous callbacks on a user provided Executor.

Nested Class Summary

Nested classes/interfaces inherited from interface org.onosproject.store.service.DistributedPrimitive

DistributedPrimitive.Status, DistributedPrimitive.Type

Field Summary

Fields inherited from interface org.onosproject.store.service.DistributedPrimitive

DEFAULT_OPERTATION_TIMEOUT_MILLIS

Constructor Summary

Constructors

Constructor and Description
ExecutingAsyncAtomicValue(AsyncAtomicValue<V> delegateValue, Executor orderedExecutor, Executor threadPoolExecutor)

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.

Methods inherited from class org.onosproject.store.primitives.impl.ExecutingDistributedPrimitive

addStatusChangeListener, asyncFuture, destroy, removeStatusChangeListener

Methods inherited from class org.onosproject.store.primitives.impl.DelegatingDistributedPrimitive

applicationId, equals, hashCode, name, primitiveType, statusChangeListeners, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.onosproject.store.service.AsyncAtomicValue

asAtomicValue, asAtomicValue, primitiveType

Methods inherited from interface org.onosproject.store.service.DistributedPrimitive

addStatusChangeListener, applicationId, destroy, name, removeStatusChangeListener, statusChangeListeners

Constructor Detail

ExecutingAsyncAtomicValue

public ExecutingAsyncAtomicValue(AsyncAtomicValue<V> delegateValue,
                                 Executor orderedExecutor,
                                 Executor threadPoolExecutor)

Method Detail

compareAndSet

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

Description copied from interface: AsyncAtomicValue

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.

Specified by:

compareAndSet in interface AsyncAtomicValue<V>

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

public CompletableFuture<V> get()

Description copied from interface: AsyncAtomicValue

Gets the current value.

Specified by:

get in interface AsyncAtomicValue<V>

Returns:

CompletableFuture that will be completed with the value

getAndSet

public CompletableFuture<V> getAndSet(V value)

Description copied from interface: AsyncAtomicValue

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

Specified by:

getAndSet in interface AsyncAtomicValue<V>

Parameters:

value - the new value

Returns:

CompletableFuture that will be completed with the previous value

set

public CompletableFuture<Void> set(V value)

Description copied from interface: AsyncAtomicValue

Sets to the given value.

Specified by:

set in interface AsyncAtomicValue<V>

Parameters:

value - value to set

Returns:

CompletableFuture that will be completed when the operation finishes

addListener

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

Description copied from interface: AsyncAtomicValue

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

Specified by:

addListener in interface AsyncAtomicValue<V>

Parameters:

listener - listener to notify about events

Returns:

CompletableFuture that will be completed when the operation finishes

removeListener

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

Description copied from interface: AsyncAtomicValue

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

Specified by:

removeListener in interface AsyncAtomicValue<V>

Parameters:

listener - listener to unregister

Returns:

CompletableFuture that will be completed when the operation finishes