Local maps can be used to share data safely in a single Vert.x instance.
The map only allows immutable keys and values in the map, OR certain mutable objects such as Buffer instances which will be copied when they are added to the map.
This ensures there is no shared access to mutable state from different threads (e.g. different event loops) in the Vert.x instance, and means you don't have to protect access to that state using synchronization or locks.
Constructor and description |
---|
LocalMap
(java.lang.Object delegate) |
Type | Name and description |
---|---|
void |
clear() Clear all entries in the map |
void |
close() Close and release the map |
V |
get(K key) Get a value from the map |
java.lang.Object |
getDelegate() |
boolean |
isEmpty() @return
|
V |
put(K key, V value) Put an entry in the map |
V |
putIfAbsent(K key, V value) Put the entry only if there is no existing entry for that key |
V |
remove(K key) Remove an entry from the map |
boolean |
removeIfPresent(K key, V value) Remove the entry only if there is an entry with the specified key and value |
V |
replace(K key, V value) Replace the entry only if there is an existing entry with the key |
boolean |
replaceIfPresent(K key, V oldValue, V newValue) Replace the entry only if there is an existing entry with the specified key and value |
int |
size() Get the size of the map |
Methods inherited from class | Name |
---|---|
class java.lang.Object |
java.lang.Object#wait(long, int), java.lang.Object#wait(long), java.lang.Object#wait(), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll() |
Clear all entries in the map
Close and release the map
Get a value from the map
key
- the key
Put an entry in the map
key
- the keyvalue
- the valuePut the entry only if there is no existing entry for that key
key
- the keyvalue
- the valueRemove an entry from the map
key
- the keyRemove the entry only if there is an entry with the specified key and value
key
- the keyvalue
- the valueReplace the entry only if there is an existing entry with the key
key
- the keyvalue
- the new valueReplace the entry only if there is an existing entry with the specified key and value
key
- the keyoldValue
- the old valuenewValue
- the new valueGet the size of the map