de.innovationgate.utils

Class HierarchyMap

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap

de.innovationgate.utils.HierarchyMap

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map

public class HierarchyMap
extends java.util.HashMap

A map that is intended to be used in a hierarchy of maps. The HierarchyMap may have a parent map. All requests that are issued to this map and which cannot be served by it (bc. the entry does not exist) are issued to the parent map. So a request to a HierarchyMap may be transported upside in the hierarchy if the parents are also HierarchyMaps. NOTE that this - in some ways - breaks intended java.util.Map behaviour!

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Constructor Summary

Constructors

Constructor and Description
HierarchyMap(java.util.Map parent) Constructs a HierarchyMap with the given parent

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() Clears the current map (NOT the parent!)
boolean	containsKey(java.lang.Object key) Looks for the key in the current and parent map
boolean	containsValue(java.lang.Object value) Looks for the value in the current and parent map
java.util.Set	entrySet() Returns an entry set of the current and parent map
java.lang.Object	get(java.lang.Object key) Returns an entry from the current map.
boolean	isEmpty() Returns true if the current and parent map is empty.
java.util.Set	keySet() Returns a key set of the current and parent map
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Adds a value to the current map.
void	putAll(java.util.Map m) Adds multiple values to the current map.
java.lang.Object	remove(java.lang.Object key) Removes a value from the current map.
int	size() Size of the current and parent map together.
java.util.Collection	values() Returns a value collection of the current and parent map.

Methods inherited from class java.util.HashMap

clone

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

equals, hashCode

Constructor Detail

HierarchyMap

public HierarchyMap(java.util.Map parent)

Constructs a HierarchyMap with the given parent

Parameters:

parent -

Method Detail

clear

public void clear()

Clears the current map (NOT the parent!)

Specified by:

clear in interface java.util.Map

Overrides:

clear in class java.util.HashMap

containsKey

public boolean containsKey(java.lang.Object key)

Looks for the key in the current and parent map

Specified by:

containsKey in interface java.util.Map

Overrides:

containsKey in class java.util.HashMap

containsValue

public boolean containsValue(java.lang.Object value)

Looks for the value in the current and parent map

Specified by:

containsValue in interface java.util.Map

Overrides:

containsValue in class java.util.HashMap

entrySet

public java.util.Set entrySet()

Returns an entry set of the current and parent map

Specified by:

entrySet in interface java.util.Map

Overrides:

entrySet in class java.util.HashMap

get

public java.lang.Object get(java.lang.Object key)

Returns an entry from the current map. If it does not exist there, it is returned from the parent map.

Specified by:

get in interface java.util.Map

Overrides:

get in class java.util.HashMap

isEmpty

public boolean isEmpty()

Returns true if the current and parent map is empty.

Specified by:

isEmpty in interface java.util.Map

Overrides:

isEmpty in class java.util.HashMap

keySet

public java.util.Set keySet()

Returns a key set of the current and parent map

Specified by:

keySet in interface java.util.Map

Overrides:

keySet in class java.util.HashMap

size

public int size()

Size of the current and parent map together. This may not match the number of individual keys in both maps together as there may be keys that both maps have.

Specified by:

size in interface java.util.Map

Overrides:

size in class java.util.HashMap

values

public java.util.Collection values()

Returns a value collection of the current and parent map. The collection is a list that contains the current maps values first, then the parent map values.

Specified by:

values in interface java.util.Map

Overrides:

values in class java.util.HashMap

put

public java.lang.Object put(java.lang.Object key,
                   java.lang.Object value)

Adds a value to the current map.

Specified by:

put in interface java.util.Map

Overrides:

put in class java.util.HashMap

putAll

public void putAll(java.util.Map m)

Adds multiple values to the current map.

Specified by:

putAll in interface java.util.Map

Overrides:

putAll in class java.util.HashMap

remove

public java.lang.Object remove(java.lang.Object key)

Removes a value from the current map.

Specified by:

remove in interface java.util.Map

Overrides:

remove in class java.util.HashMap