org.gridgain.grid.kernal

Class GridNodeLocalMapImpl<K,V>

java.lang.Object

org.jdk8.backport.ConcurrentHashMap8<K,V>

org.gridgain.grid.kernal.GridNodeLocalMapImpl<K,V>

All Implemented Interfaces:

Externalizable, Serializable, ConcurrentMap<K,V>, Map<K,V>, GridMetadataAware, GridNodeLocalMap<K,V>

public class GridNodeLocalMapImpl<K,V>
extends org.jdk8.backport.ConcurrentHashMap8<K,V>
implements GridNodeLocalMap<K,V>, Externalizable

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jdk8.backport.ConcurrentHashMap8

org.jdk8.backport.ConcurrentHashMap8.Action<A>, org.jdk8.backport.ConcurrentHashMap8.BiAction<A,B>, org.jdk8.backport.ConcurrentHashMap8.BiFun<A,B,T>, org.jdk8.backport.ConcurrentHashMap8.DoubleByDoubleToDouble, org.jdk8.backport.ConcurrentHashMap8.DoubleToDouble, org.jdk8.backport.ConcurrentHashMap8.EntrySetView<K,V>, org.jdk8.backport.ConcurrentHashMap8.Fun<A,T>, org.jdk8.backport.ConcurrentHashMap8.Generator<T>, org.jdk8.backport.ConcurrentHashMap8.IntByIntToInt, org.jdk8.backport.ConcurrentHashMap8.IntToInt, org.jdk8.backport.ConcurrentHashMap8.KeySetView<K,V>, org.jdk8.backport.ConcurrentHashMap8.LongByLongToLong, org.jdk8.backport.ConcurrentHashMap8.LongToLong, org.jdk8.backport.ConcurrentHashMap8.ObjectByObjectToDouble<A,B>, org.jdk8.backport.ConcurrentHashMap8.ObjectByObjectToInt<A,B>, org.jdk8.backport.ConcurrentHashMap8.ObjectByObjectToLong<A,B>, org.jdk8.backport.ConcurrentHashMap8.ObjectToDouble<A>, org.jdk8.backport.ConcurrentHashMap8.ObjectToInt<A>, org.jdk8.backport.ConcurrentHashMap8.ObjectToLong<A>, org.jdk8.backport.ConcurrentHashMap8.Spliterator<T>, org.jdk8.backport.ConcurrentHashMap8.ValuesView<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
GridNodeLocalMapImpl() No-arg constructor is required by externalization.

Method Summary

Methods

Modifier and Type	Method and Description
V	addIfAbsent(K key, Callable<V> dflt) Gets the value with given key.
V	addIfAbsent(K key, V val) Unlike its sibling method ConcurrentMap.putIfAbsent(Object, Object) this method returns current mapping from the map.
<V> V	addMeta(String name, V val) Adds a new metadata.
<V> V	addMetaIfAbsent(String name, Callable<V> c) Adds given metadata value only if it was absent.
<V> V	addMetaIfAbsent(String name, V val) Adds given metadata value only if it was absent.
<V> Map<String,V>	allMeta() Gets all metadata in this entry.
void	copyMeta(GridMetadataAware from) Copies all metadata from another instance.
void	copyMeta(Map<String,?> data) Copies all metadata from given map.
boolean	hasMeta(String name) Tests whether or not given metadata is set.
<V> boolean	hasMeta(String name, V val) Tests whether or not metadata with given name and value is set.
<V> V	meta(String name) Gets metadata by name.
<V> V	putMetaIfAbsent(String name, Callable<V> c) Adds given metadata value only if it was absent.
<V> V	putMetaIfAbsent(String name, V val) Adds given metadata value only if it was absent.
void	readExternal(ObjectInput in)
protected Object	readResolve() Reconstructs object on demarshalling.
<V> V	removeMeta(String name) Removes metadata by name.
<V> boolean	removeMeta(String name, V val) Removes metadata only if its current value is equal to val passed in.
<V> boolean	replaceMeta(String name, V curVal, V newVal) Replaces given metadata with new newVal value only if its current value is equal to curVal.
String	toString()
void	writeExternal(ObjectOutput out)

Methods inherited from class org.jdk8.backport.ConcurrentHashMap8

clear, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, entrySpliterator, equals, get, getValueOrDefault, hashCode, isEmpty, keys, keySet, keySet, keySpliterator, mappingCount, merge, newKeySet, newKeySet, put, putAll, putIfAbsent, remove, remove, replace, replace, size, values, valueSpliterator

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.ConcurrentMap

putIfAbsent, remove, replace, replace

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Constructor Detail

GridNodeLocalMapImpl

public GridNodeLocalMapImpl()

No-arg constructor is required by externalization.

Method Detail

addIfAbsent

@Nullable
public V addIfAbsent(K key,
                     @Nullable
                     Callable<V> dflt)

Gets the value with given key. If that value does not exist, calls given closure to get the default value, puts it into the map and returns it. If closure is null return null.

Specified by:

addIfAbsent in interface GridNodeLocalMap<K,V>

Parameters:

key - Key to get the value for.

dflt - Default value producing closure.

Returns:

Value for the key or the value produced by the closure if key does not exist in the map. Return null if key is not found and closure is null.

addIfAbsent

public V addIfAbsent(K key,
            V val)

Unlike its sibling method ConcurrentMap.putIfAbsent(Object, Object) this method returns current mapping from the map.

Specified by:

addIfAbsent in interface GridNodeLocalMap<K,V>

Parameters:

key - Key.

val - Value to put if one does not exist.

Returns:

Current mapping for a given key.

addMeta

public <V> V addMeta(String name,
            V val)

Adds a new metadata.

Specified by:

addMeta in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

val - Metadata value.

Returns:

Metadata previously associated with given name, or null if there was none.

putMetaIfAbsent

public <V> V putMetaIfAbsent(String name,
                    V val)

Adds given metadata value only if it was absent.

Specified by:

putMetaIfAbsent in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

val - Value to add if it's not attached already.

Returns:

null if new value was put, or current value if put didn't happen.

putMetaIfAbsent

public <V> V putMetaIfAbsent(String name,
                    Callable<V> c)

Adds given metadata value only if it was absent.

Specified by:

putMetaIfAbsent in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

c - Factory closure to produce value to add if it's not attached already. Not that unlike GridMetadataAware.addMeta(String, Object) method the factory closure will not be called unless the value is required and therefore value will only be created when it is actually needed.

Returns:

null if new value was put, or current value if put didn't happen.

addMetaIfAbsent

public <V> V addMetaIfAbsent(String name,
                    V val)

Adds given metadata value only if it was absent. Unlike GridMetadataAware.putMetaIfAbsent(String, Callable), this method always returns the latest value and never previous one.

Specified by:

addMetaIfAbsent in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

val - Value to add if it's not attached already.

Returns:

The value of the metadata after execution of this method.

addMetaIfAbsent

public <V> V addMetaIfAbsent(String name,
                    Callable<V> c)

Adds given metadata value only if it was absent.

Specified by:

addMetaIfAbsent in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

c - Factory closure to produce value to add if it's not attached already. Not that unlike GridMetadataAware.addMeta(String, Object) method the factory closure will not be called unless the value is required and therefore value will only be created when it is actually needed. If null and metadata value is missing - null will be returned from this method.

Returns:

The value of the metadata after execution of this method.

meta

@Nullable
public <V> V meta(String name)

Gets metadata by name.

Specified by:

meta in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Metadata name.

Returns:

Metadata value or null.

removeMeta

@Nullable
public <V> V removeMeta(String name)

Removes metadata by name.

Specified by:

removeMeta in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Name of the metadata to remove.

Returns:

Value of removed metadata or null.

removeMeta

public <V> boolean removeMeta(String name,
                     V val)

Removes metadata only if its current value is equal to val passed in.

Specified by:

removeMeta in interface GridMetadataAware

Type Parameters:

V - Value type.

Parameters:

name - Name of metadata attribute.

val - Value to compare.

Returns:

True if value was removed, false otherwise.

allMeta

public <V> Map<String,V> allMeta()

Gets all metadata in this entry.

Specified by:

allMeta in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Returns:

All metadata in this entry.

hasMeta

public boolean hasMeta(String name)

Tests whether or not given metadata is set.

Specified by:

hasMeta in interface GridMetadataAware

Parameters:

name - Name of the metadata to test.

Returns:

Whether or not given metadata is set.

hasMeta

public <V> boolean hasMeta(String name,
                  V val)

Tests whether or not metadata with given name and value is set. Returns true if attachment with given name it set and its value is equals to provided value. Otherwise returns false.

Specified by:

hasMeta in interface GridMetadataAware

Type Parameters:

V - Type of the value.

Parameters:

name - Name of the metadata.

val - Value to compare. Cannot be null.

Returns:

true if metadata with given name is set and its value is equals to provided value - otherwise returns false.

replaceMeta

public <V> boolean replaceMeta(String name,
                      V curVal,
                      V newVal)

Replaces given metadata with new newVal value only if its current value is equal to curVal. Otherwise, it is no-op.

Specified by:

replaceMeta in interface GridMetadataAware

Parameters:

name - Name of the metadata.

curVal - Current value to check.

newVal - New value.

Returns:

true if replacement occurred, false otherwise.

copyMeta

public void copyMeta(GridMetadataAware from)

Copies all metadata from another instance.

Specified by:

copyMeta in interface GridMetadataAware

Parameters:

from - Metadata aware instance to copy metadata from.

copyMeta

public void copyMeta(Map<String,?> data)

Copies all metadata from given map.

Specified by:

copyMeta in interface GridMetadataAware

Parameters:

data - Map to copy metadata from.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

readResolve

protected Object readResolve()
                      throws ObjectStreamException

Reconstructs object on demarshalling.

Returns:

Reconstructed object.

Throws:

ObjectStreamException - Thrown in case of demarshalling error.

toString

public String toString()

Overrides:

toString in class org.jdk8.backport.ConcurrentHashMap8<K,V>