org.opendaylight.yangtools.util

Class ImmutableOffsetMap<K,V>

java.lang.Object

org.opendaylight.yangtools.util.ImmutableOffsetMap<K,V>

Type Parameters:

K - the type of keys maintained by this map

V - the type of mapped values

All Implemented Interfaces:

Serializable, Map<K,V>, Immutable, MutationBehaviour<Immutable>, UnmodifiableMapPhase<K,V>

@Beta
public abstract class ImmutableOffsetMap<K,V>
extends Object
implements UnmodifiableMapPhase<K,V>, Serializable

Implementation of the Map interface which stores a set of immutable mappings using a key-to-offset map and a backing array. This is useful for situations where the same key set is shared across a multitude of maps, as this class uses a global cache to share the key-to-offset mapping.

See Also:

Serialized Form

Nested Class Summary

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

Map.Entry<K,V>

Method Summary

Modifier and Type	Method and Description
void	clear()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<K,V>>	entrySet()
boolean	equals(Object o)
V	get(Object key)
int	hashCode()
boolean	isEmpty()
Set<K>	keySet()
static <K,V> Map<K,V>	orderedCopyOf(Map<K,V> m) Create an ImmutableOffsetMap as a copy of an existing map.
V	put(K key, V value)
void	putAll(Map<? extends K,? extends V> m)
V	remove(Object key)
int	size()
abstract MutableOffsetMap<K,V>	toModifiableMap() Return an isolated modifiable version of this map.
String	toString()
static <K,V> Map<K,V>	unorderedCopyOf(Map<K,V> m) Create an ImmutableOffsetMap as a copy of an existing map.
Collection<V>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Method Detail

toModifiableMap

@Nonnull
public abstract MutableOffsetMap<K,V> toModifiableMap()

Description copied from interface: UnmodifiableMapPhase

Return an isolated modifiable version of this map. Its mappings must match the mappings present in this map. Any modification of the returned map must not be affect the contents of this map.

Specified by:

toModifiableMap in interface UnmodifiableMapPhase<K,V>

Returns:

An modifiable version of this map.

orderedCopyOf

@Nonnull
public static <K,V> Map<K,V> orderedCopyOf(@Nonnull
                                                    Map<K,V> m)

Create an ImmutableOffsetMap as a copy of an existing map. This is actually not completely true, as this method returns an ImmutableMap for empty and singleton inputs, as those are more memory-efficient. This method also recognizes ImmutableOffsetMap on input, and returns it back without doing anything else. It also recognizes MutableOffsetMap (as returned by toModifiableMap()) and makes an efficient copy of its contents. All other maps are converted to an ImmutableOffsetMap with the same iteration order as input.

Parameters:

m - Input map, may not be null.

Returns:

An isolated, immutable copy of the input map

unorderedCopyOf

@Nonnull
public static <K,V> Map<K,V> unorderedCopyOf(@Nonnull
                                                      Map<K,V> m)

Create an ImmutableOffsetMap as a copy of an existing map. This is actually not completely true, as this method returns an ImmutableMap for empty and singleton inputs, as those are more memory-efficient. This method also recognizes ImmutableOffsetMap on input, and returns it back without doing anything else. It also recognizes MutableOffsetMap (as returned by toModifiableMap()) and makes an efficient copy of its contents. All other maps are converted to an ImmutableOffsetMap. Iterator order is not guaranteed to be retained.

Parameters:

m - Input map, may not be null.

Returns:

An isolated, immutable copy of the input map

size

public final int size()

Specified by:

size in interface Map<K,V>

isEmpty

public final boolean isEmpty()

Specified by:

isEmpty in interface Map<K,V>

hashCode

public final int hashCode()

Specified by:

hashCode in interface Map<K,V>

Overrides:

hashCode in class Object

equals

public final boolean equals(Object o)

Specified by:

equals in interface Map<K,V>

Overrides:

equals in class Object

containsKey

public final boolean containsKey(Object key)

Specified by:

containsKey in interface Map<K,V>

containsValue

public final boolean containsValue(Object value)

Specified by:

containsValue in interface Map<K,V>

get

public final V get(Object key)

Specified by:

get in interface Map<K,V>

remove

public final V remove(Object key)

Specified by:

remove in interface Map<K,V>

put

public final V put(K key,
                   V value)

Specified by:

put in interface Map<K,V>

putAll

public final void putAll(@Nonnull
                         Map<? extends K,? extends V> m)

Specified by:

putAll in interface Map<K,V>

clear

public final void clear()

Specified by:

clear in interface Map<K,V>

keySet

public final Set<K> keySet()

Specified by:

keySet in interface Map<K,V>

values

@Nonnull
public final Collection<V> values()

Specified by:

values in interface Map<K,V>

entrySet

@Nonnull
public final Set<Map.Entry<K,V>> entrySet()

Specified by:

entrySet in interface Map<K,V>

toString

public final String toString()

Overrides:

toString in class Object