one.microstream.collections.types

Interface XAddGetMap<K,V>

All Superinterfaces:

CapacityCarrying, CapacityExtendable, Copyable, ExtendedCollection<KeyValue<K,V>>, ExtendedMap<K,V>, Iterable<KeyValue<K,V>>, Sized, XAddingMap<K,V>, XGettingCollection<KeyValue<K,V>>, XGettingMap<K,V>, XGettingSet<KeyValue<K,V>>, XIterable<KeyValue<K,V>>, XJoinable<KeyValue<K,V>>

All Known Subinterfaces:

XBasicTable<K,V>, XChart<K,V>, XMap<K,V>, XPutGetMap<K,V>, XTable<K,V>

All Known Implementing Classes:

EqHashTable, HashTable, LockedMap

public interface XAddGetMap<K,V>
extends XAddingMap<K,V>, XGettingMap<K,V>

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	XAddGetMap.Creator<K,V>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XGettingMap

XGettingMap.Bridge<K,V>, XGettingMap.EntriesBridge<K,V>, XGettingMap.Keys<K,V>, XGettingMap.Satellite<K,V>, XGettingMap.Values<K,V>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XIterable

XIterable.Executor<E>

Nested classes/interfaces inherited from interface one.microstream.typing.Copyable

Copyable.Static

Method Summary

Modifier and Type	Method and Description
KeyValue<K,V>	addGet(K key, V value)
V	ensure(K key, Function<? super K,V> valueProvider) Ensures that this map instance contains a non-null value for the passed key and returns that value.
KeyValue<K,V>	substitute(K key, V value)

Methods inherited from interface one.microstream.collections.types.XAddingMap

add, nullKeyAllowed, nullValuesAllowed, set, valueSet

Methods inherited from interface one.microstream.collections.interfaces.CapacityExtendable

currentCapacity, currentFreeCapacity, ensureCapacity, ensureFreeCapacity

Methods inherited from interface one.microstream.collections.types.XGettingMap

copy, get, immure, keys, lookup, nullKeyAllowed, nullValuesAllowed, old, oldMap, query, searchValue, values, view

Methods inherited from interface one.microstream.collections.types.XGettingSet

iterate

Methods inherited from interface one.microstream.collections.types.XGettingCollection

applies, contains, containsAll, containsId, containsSearched, copyTo, count, countBy, distinct, distinct, equality, equals, equals, equalsContent, except, filterTo, get, hashCode, hasVolatileElements, intersect, intSize, iterator, join, max, min, nullContained, search, seek, size, toArray, toArray, union

Methods inherited from interface one.microstream.collections.interfaces.ExtendedCollection

nullAllowed

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface one.microstream.collections.interfaces.CapacityCarrying

isFull, maximumCapacity, remainingCapacity

Methods inherited from interface one.microstream.collections.interfaces.Sized

isEmpty

Method Detail

addGet

KeyValue<K,V> addGet(K key,
                     V value)

substitute

KeyValue<K,V> substitute(K key,
                         V value)

ensure

V ensure(K key,
         Function<? super K,V> valueProvider)

Ensures that this map instance contains a non-null value for the passed key and returns that value.

If a non-null value can be found for the passed key, it is returned. Otherwise, the value provided by the passed supplier will be associated with the passed key and is returned.

Parameters:

key - the search key.

valueProvider - the value supplier used to provide a value for the passed key in case non could be found.

Returns:

the value associated with the passed key, either already existing or newly assiciated by the call of this method.