MeteredAsyncConsistentMap (onos-apps-fwd)

java.lang.Object
- org.onosproject.store.primitives.impl.DelegatingDistributedPrimitive
- - org.onosproject.store.primitives.impl.DelegatingAsyncConsistentMap<K,V>
  - - org.onosproject.store.primitives.impl.MeteredAsyncConsistentMap<K,V>

Type Parameters:

K - key type

V - value type

All Implemented Interfaces:

AsyncConsistentMap<K,V>, DistributedPrimitive, Transactional<MapUpdate<K,V>>
```
public class MeteredAsyncConsistentMap<K,V>
extends DelegatingAsyncConsistentMap<K,V>
```
AsyncConsistentMap that meters all its operations.

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

MeteredAsyncConsistentMap(AsyncConsistentMap<K,V> backingMap)

Constructors
Constructor and Description
`MeteredAsyncConsistentMap(AsyncConsistentMap<K,V> backingMap)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CompletableFuture<Void>`	`addListener(MapEventListener<K,V> listener, Executor executor)` Registers the specified listener to be notified whenever the map is updated.
`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<V>>`	`computeIf(K key, Predicate<? super V> condition, BiFunction<? super K,? super V,? extends V> 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<Versioned<V>>`	`computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)` If the specified key is not already associated with a value (or is mapped to null), attempts to compute its value using the given mapping function and enters it into this map unless null.
`CompletableFuture<Boolean>`	`containsKey(K key)` Returns true if this map contains a mapping for the specified key.
`CompletableFuture<Boolean>`	`containsValue(V value)` Returns true if this map contains the specified value.
`CompletableFuture<Set<Map.Entry<K,Versioned<V>>>>`	`entrySet()` Returns the set of entries contained in this map.
`CompletableFuture<Versioned<V>>`	`get(K 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<Boolean>`	`isEmpty()` Returns true if the map is empty.
`CompletableFuture<Set<K>>`	`keySet()` Returns a Set view of the keys contained in this map.
`CompletableFuture<Boolean>`	`prepare(TransactionLog<MapUpdate<K,V>> transactionLog)` Prepares a transaction for commitment.
`CompletableFuture<Boolean>`	`prepareAndCommit(TransactionLog<MapUpdate<K,V>> transactionLog)` Prepares and commits a transaction.
`CompletableFuture<Versioned<V>>`	`put(K key, V value)` Associates the specified value with the specified key in this map (optional operation).
`CompletableFuture<Versioned<V>>`	`putAndGet(K key, V value)` Associates the specified value with the specified key in this map (optional operation).
`CompletableFuture<Versioned<V>>`	`putIfAbsent(K key, V 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<V>>`	`remove(K key)` Removes the mapping for a key from this map if it is present (optional operation).
`CompletableFuture<Boolean>`	`remove(K 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<Boolean>`	`remove(K key, V value)` Removes the entry for the specified key only if it is currently mapped to the specified value.
`CompletableFuture<Void>`	`removeListener(MapEventListener<K,V> listener)` Unregisters the specified listener such that it will no longer receive map change notifications.
`CompletableFuture<Boolean>`	`replace(K key, long oldVersion, V newValue)` Replaces the entry for the specified key only if it is currently mapped to the specified version.
`CompletableFuture<Versioned<V>>`	`replace(K key, V value)` Replaces the entry for the specified key only if there is any value which associated with specified key.
`CompletableFuture<Boolean>`	`replace(K key, V oldValue, V newValue)` Replaces the entry for the specified key only if currently mapped to the specified value.
`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.
`CompletableFuture<Collection<Versioned<V>>>`	`values()` Returns the collection of values (and associated versions) contained in this map.

Methods inherited from class org.onosproject.store.primitives.impl.DelegatingAsyncConsistentMap
addStatusChangeListener, equals, getOrDefault, hashCode, removeStatusChangeListener, statusChangeListeners, toString

Methods inherited from class org.onosproject.store.primitives.impl.DelegatingDistributedPrimitive
applicationId, destroy, name, primitiveType

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.onosproject.store.service.AsyncConsistentMap
addListener, asConsistentMap, asConsistentMap, compute, computeIfPresent, destroy, primitiveType

Methods inherited from interface org.onosproject.store.service.DistributedPrimitive
applicationId, name

- Constructor Detail
  - MeteredAsyncConsistentMap
```
public MeteredAsyncConsistentMap(AsyncConsistentMap<K,V> backingMap)
```
- Method Detail
  - size
```
public CompletableFuture<Integer> size()
```
    Description copied from interface: AsyncConsistentMap
    
    Returns the number of entries in the map.
    
    Specified by:
    
    size in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    size in class DelegatingAsyncConsistentMap<K,V>
    
    Returns:
    
    a future for map size.
  - isEmpty
```
public CompletableFuture<Boolean> isEmpty()
```
    Description copied from interface: AsyncConsistentMap
    
    Returns true if the map is empty.
    
    Returns:
    
    a future whose value will be true if map has no entries, false otherwise.
  - containsKey
```
public CompletableFuture<Boolean> containsKey(K key)
```
    Description copied from interface: AsyncConsistentMap
    
    Returns true if this map contains a mapping for the specified key.
    
    Specified by:
    
    containsKey in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    containsKey in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key
    
    Returns:
    
    a future whose value will be true if map contains key, false otherwise.
  - containsValue
```
public CompletableFuture<Boolean> containsValue(V value)
```
    Description copied from interface: AsyncConsistentMap
    
    Returns true if this map contains the specified value.
    
    Specified by:
    
    containsValue in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    containsValue in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    value - value
    
    Returns:
    
    a future whose value will be true if map contains value, false otherwise.
  - get
```
public CompletableFuture<Versioned<V>> get(K key)
```
    Description copied from interface: AsyncConsistentMap
    
    Returns the value (and version) to which the specified key is mapped, or null if this map contains no mapping for the key.
    
    Specified by:
    
    get in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    get in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - the key whose associated value (and version) is to be returned
    
    Returns:
    
    a future value (and version) to which the specified key is mapped, or null if this map contains no mapping for the key
  - computeIfAbsent
```
public CompletableFuture<Versioned<V>> computeIfAbsent(K key,
                                                       Function<? super K,? extends V> mappingFunction)
```
    Description copied from interface: AsyncConsistentMap
    
    If the specified key is not already associated with a value (or is mapped to null), attempts to compute its value using the given mapping function and enters it into this map unless null. If a conflicting concurrent modification attempt is detected, the returned future will be completed exceptionally with ConsistentMapException.ConcurrentModification.
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    mappingFunction - the function to compute a value
    
    Returns:
    
    the current (existing or computed) value associated with the specified key, or null if the computed value is null
  - computeIf
```
public CompletableFuture<Versioned<V>> computeIf(K key,
                                                 Predicate<? super V> condition,
                                                 BiFunction<? super K,? super V,? extends V> remappingFunction)
```
    Description copied from interface: AsyncConsistentMap
    
    If the value for the specified key satisfies a condition, attempts to compute a new mapping given the key and its current mapped value. If the computed value is null, the current mapping will be removed from the map. If a conflicting concurrent modification attempt is detected, the returned future will be completed exceptionally with ConsistentMapException.ConcurrentModification.
    
    Specified by:
    
    computeIf in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    computeIf in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    condition - condition that should evaluate to true for the computation to proceed
    
    remappingFunction - the function to compute a value
    
    Returns:
    
    the new value associated with the specified key, or the old value if condition evaluates to false
  - put
```
public CompletableFuture<Versioned<V>> put(K key,
                                           V value)
```
    Description copied from interface: AsyncConsistentMap
    
    Associates the specified value with the specified key in this map (optional operation). If the map previously contained a mapping for the key, the old value is replaced by the specified value.
    
    Specified by:
    
    put in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    put in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    value - value to be associated with the specified key
    
    Returns:
    
    the previous value (and version) associated with key, or null if there was no mapping for key.
  - putAndGet
```
public CompletableFuture<Versioned<V>> putAndGet(K key,
                                                 V value)
```
    Description copied from interface: AsyncConsistentMap
    
    Associates the specified value with the specified key in this map (optional operation). If the map previously contained a mapping for the key, the old value is replaced by the specified value.
    
    Specified by:
    
    putAndGet in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    putAndGet in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    value - value to be associated with the specified key
    
    Returns:
    
    new value.
  - remove
```
public CompletableFuture<Versioned<V>> remove(K key)
```
    Description copied from interface: AsyncConsistentMap
    
    Removes the mapping for a key from this map if it is present (optional operation).
    
    Specified by:
    
    remove in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    remove in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key whose value is to be removed from the map
    
    Returns:
    
    the value (and version) to which this map previously associated the key, or null if the map contained no mapping for the key.
  - clear
```
public CompletableFuture<Void> clear()
```
    Description copied from interface: AsyncConsistentMap
    
    Removes all of the mappings from this map (optional operation). The map will be empty after this call returns.
    
    Specified by:
    
    clear in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    clear in class DelegatingAsyncConsistentMap<K,V>
    
    Returns:
    
    future that will be successfully completed when the map is cleared
  - keySet
```
public CompletableFuture<Set<K>> keySet()
```
    Description copied from interface: AsyncConsistentMap
    
    Returns a Set view of the keys contained in this map. This method differs from the behavior of java.util.Map.keySet() in that what is returned is a unmodifiable snapshot view of the keys in the ConsistentMap. Attempts to modify the returned set, whether direct or via its iterator, result in an UnsupportedOperationException.
    
    Specified by:
    
    keySet in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    keySet in class DelegatingAsyncConsistentMap<K,V>
    
    Returns:
    
    a set of the keys contained in this map
  - values
```
public CompletableFuture<Collection<Versioned<V>>> values()
```
    Description copied from interface: AsyncConsistentMap
    
    Returns the collection of values (and associated versions) contained in this map. This method differs from the behavior of java.util.Map.values() in that what is returned is a unmodifiable snapshot view of the values in the ConsistentMap. Attempts to modify the returned collection, whether direct or via its iterator, result in an UnsupportedOperationException.
    
    Specified by:
    
    values in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    values in class DelegatingAsyncConsistentMap<K,V>
    
    Returns:
    
    a collection of the values (and associated versions) contained in this map
  - entrySet
```
public CompletableFuture<Set<Map.Entry<K,Versioned<V>>>> entrySet()
```
    Description copied from interface: AsyncConsistentMap
    
    Returns the set of entries contained in this map. This method differs from the behavior of java.util.Map.entrySet() in that what is returned is a unmodifiable snapshot view of the entries in the ConsistentMap. Attempts to modify the returned set, whether direct or via its iterator, result in an UnsupportedOperationException.
    
    Specified by:
    
    entrySet in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    entrySet in class DelegatingAsyncConsistentMap<K,V>
    
    Returns:
    
    set of entries contained in this map.
  - putIfAbsent
```
public CompletableFuture<Versioned<V>> putIfAbsent(K key,
                                                   V value)
```
    Description copied from interface: AsyncConsistentMap
    
    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.
    
    Specified by:
    
    putIfAbsent in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    putIfAbsent in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    value - value to be associated with the specified key
    
    Returns:
    
    the previous value associated with the specified key or null if key does not already mapped to a value.
  - remove
```
public CompletableFuture<Boolean> remove(K key,
                                         V value)
```
    Description copied from interface: AsyncConsistentMap
    
    Removes the entry for the specified key only if it is currently mapped to the specified value.
    
    Specified by:
    
    remove in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    remove in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is associated
    
    value - value expected to be associated with the specified key
    
    Returns:
    
    true if the value was removed
  - remove
```
public CompletableFuture<Boolean> remove(K key,
                                         long version)
```
    Description copied from interface: AsyncConsistentMap
    
    Removes the entry for the specified key only if its current version in the map is equal to the specified version.
    
    Specified by:
    
    remove in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    remove in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified version is associated
    
    version - version expected to be associated with the specified key
    
    Returns:
    
    true if the value was removed
  - replace
```
public CompletableFuture<Versioned<V>> replace(K key,
                                               V value)
```
    Description copied from interface: AsyncConsistentMap
    
    Replaces the entry for the specified key only if there is any value which associated with specified key.
    
    Specified by:
    
    replace in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    replace in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is associated
    
    value - value expected to be associated with the specified key
    
    Returns:
    
    the previous value associated with the specified key or null
  - replace
```
public CompletableFuture<Boolean> replace(K key,
                                          V oldValue,
                                          V newValue)
```
    Description copied from interface: AsyncConsistentMap
    
    Replaces the entry for the specified key only if currently mapped to the specified value.
    
    Specified by:
    
    replace in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    replace in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key with which the specified value is associated
    
    oldValue - value expected to be associated with the specified key
    
    newValue - value to be associated with the specified key
    
    Returns:
    
    true if the value was replaced
  - replace
```
public CompletableFuture<Boolean> replace(K key,
                                          long oldVersion,
                                          V newValue)
```
    Description copied from interface: AsyncConsistentMap
    
    Replaces the entry for the specified key only if it is currently mapped to the specified version.
    
    Specified by:
    
    replace in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    replace in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    key - key key with which the specified value is associated
    
    oldVersion - version expected to be associated with the specified key
    
    newValue - value to be associated with the specified key
    
    Returns:
    
    true if the value was replaced
  - addListener
```
public CompletableFuture<Void> addListener(MapEventListener<K,V> listener,
                                           Executor executor)
```
    Description copied from interface: AsyncConsistentMap
    
    Registers the specified listener to be notified whenever the map is updated.
    
    Specified by:
    
    addListener in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    addListener in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    listener - listener to notify about map events
    
    executor - executor to use for handling incoming map events
    
    Returns:
    
    future that will be completed when the operation finishes
  - removeListener
```
public CompletableFuture<Void> removeListener(MapEventListener<K,V> listener)
```
    Description copied from interface: AsyncConsistentMap
    
    Unregisters the specified listener such that it will no longer receive map change notifications.
    
    Specified by:
    
    removeListener in interface AsyncConsistentMap<K,V>
    
    Overrides:
    
    removeListener in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    listener - listener to unregister
    
    Returns:
    
    future that will be completed when the operation finishes
  - begin
```
public CompletableFuture<Version> begin(TransactionId transactionId)
```
    Description copied from interface: Transactional
    
    Begins the transaction.
    
    Specified by:
    
    begin in interface Transactional<MapUpdate<K,V>>
    
    Overrides:
    
    begin in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    transactionId - the transaction identifier for the transaction to begin
    
    Returns:
    
    a completable future to be completed with the lock version
  - prepare
```
public CompletableFuture<Boolean> prepare(TransactionLog<MapUpdate<K,V>> transactionLog)
```
    Description copied from interface: Transactional
    
    Prepares a transaction for commitment.
    
    Specified by:
    
    prepare in interface Transactional<MapUpdate<K,V>>
    
    Overrides:
    
    prepare in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    transactionLog - transaction log
    
    Returns:
    
    true if prepare is successful and transaction is ready to be committed false otherwise
  - commit
```
public CompletableFuture<Void> commit(TransactionId transactionId)
```
    Description copied from interface: Transactional
    
    Commits a previously prepared transaction and unlocks the object.
    
    Specified by:
    
    commit in interface Transactional<MapUpdate<K,V>>
    
    Overrides:
    
    commit in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    transactionId - transaction identifier
    
    Returns:
    
    future that will be completed when the operation finishes
  - rollback
```
public CompletableFuture<Void> rollback(TransactionId transactionId)
```
    Description copied from interface: Transactional
    
    Aborts a previously prepared transaction and unlocks the object.
    
    Specified by:
    
    rollback in interface Transactional<MapUpdate<K,V>>
    
    Overrides:
    
    rollback in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    transactionId - transaction identifier
    
    Returns:
    
    future that will be completed when the operation finishes
  - prepareAndCommit
```
public CompletableFuture<Boolean> prepareAndCommit(TransactionLog<MapUpdate<K,V>> transactionLog)
```
    Description copied from interface: Transactional
    
    Prepares and commits a transaction.
    
    Specified by:
    
    prepareAndCommit in interface Transactional<MapUpdate<K,V>>
    
    Overrides:
    
    prepareAndCommit in class DelegatingAsyncConsistentMap<K,V>
    
    Parameters:
    
    transactionLog - transaction log
    
    Returns:
    
    true if prepare is successful and transaction was committed false otherwise

Class MeteredAsyncConsistentMap<K,V>

Nested Class Summary

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

Field Summary

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

Constructor Summary

Method Summary

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

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

Methods inherited from class java.lang.Object

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

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

Constructor Detail

MeteredAsyncConsistentMap

Method Detail

size

isEmpty

containsKey

containsValue

get

computeIfAbsent

computeIf

put

putAndGet

remove

clear

keySet

values

entrySet

putIfAbsent

remove

remove

replace

replace

replace

addListener

removeListener

begin

prepare

commit

rollback

prepareAndCommit