Class ConcurrentLongHashMap<V>
java.lang.Object
org.apache.pulsar.common.util.collections.ConcurrentLongHashMap<V>
- Type Parameters:
V
-
Map from long to an Object.
The forEach method is specifically designed for single-threaded usage. When iterating over a map with concurrent writes, it becomes possible for new values to be either observed or not observed. There is no guarantee that if we write value1 and value2, and are able to see value2, then we will also see value1. In some cases, it is even possible to encounter two mappings with the same key, leading the keys method to return a List containing two identical keys.
It is crucial to understand that the results obtained from aggregate status methods such as keys and values are typically reliable only when the map is not undergoing concurrent updates from other threads. When concurrent updates are involved, the results of these methods reflect transient states that may be suitable for monitoring or estimation purposes, but not for program control.
Provides similar methods as a ConcurrentMap<long,Object>
with 2 differences:
- No boxing/unboxing from long -> Long
- Open hash map with linear probing, no node allocations to store the values
The forEach method is specifically designed for single-threaded usage. When iterating over a map with concurrent writes, it becomes possible for new values to be either observed or not observed. There is no guarantee that if we write value1 and value2, and are able to see value2, then we will also see value1. In some cases, it is even possible to encounter two mappings with the same key, leading the keys method to return a List containing two identical keys.
It is crucial to understand that the results obtained from aggregate status methods such as keys and values are typically reliable only when the map is not undergoing concurrent updates from other threads. When concurrent updates are involved, the results of these methods reflect transient states that may be suitable for monitoring or estimation purposes, but not for program control.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Builder of ConcurrentLongHashMap.static interface
Processor for one key-value entry, where the key islong
. -
Constructor Summary
ConstructorDescriptionDeprecated.ConcurrentLongHashMap
(int expectedItems) Deprecated.ConcurrentLongHashMap
(int expectedItems, int concurrencyLevel) Deprecated.ConcurrentLongHashMap
(int expectedItems, int concurrencyLevel, float mapFillFactor, float mapIdleFactor, boolean autoShrink, float expandFactor, float shrinkFactor) -
Method Summary
Modifier and TypeMethodDescriptionlong
capacity()
void
clear()
computeIfAbsent
(long key, LongFunction<V> provider) boolean
containsKey
(long key) void
forEach
(ConcurrentLongHashMap.EntryProcessor<V> processor) Iterate over all the entries in the map and apply the processor function to each of them.get
(long key) boolean
isEmpty()
keys()
static <V> ConcurrentLongHashMap.Builder<V>
putIfAbsent
(long key, V value) remove
(long key) boolean
long
size()
values()
-
Constructor Details
-
ConcurrentLongHashMap
Deprecated. -
ConcurrentLongHashMap
Deprecated. -
ConcurrentLongHashMap
Deprecated. -
ConcurrentLongHashMap
public ConcurrentLongHashMap(int expectedItems, int concurrencyLevel, float mapFillFactor, float mapIdleFactor, boolean autoShrink, float expandFactor, float shrinkFactor)
-
-
Method Details
-
newBuilder
-
size
public long size() -
capacity
public long capacity() -
isEmpty
public boolean isEmpty() -
get
-
containsKey
public boolean containsKey(long key) -
put
-
putIfAbsent
-
computeIfAbsent
-
remove
-
remove
-
clear
public void clear() -
forEach
Iterate over all the entries in the map and apply the processor function to each of them.Warning: Do Not Guarantee Thread-Safety.
- Parameters:
processor
- the processor to apply to each entry
-
keys
- Returns:
- a new list of all keys (makes a copy)
-
values
-