org.opends.server.api

Class DITCacheMap<T>

java.lang.Object

java.util.AbstractMap<DN,T>

org.opends.server.api.DITCacheMap<T>

Type Parameters:

T - arbitrary object type.

All Implemented Interfaces:

Map<DN,T>

public final class DITCacheMap<T>
extends AbstractMap<DN,T>

The DITCacheMap class implements custom Map for structural storage of arbitrary objects in Directory Information Tree (DIT) like structure.

This Map intended usage is for caching various server objects which can be subject to subtree operations like retrieval or removal of all objects under a specific DN. While using a regular Map it would require the entire Map iteration to achieve, this Map implementation maintains such internal structure that subtree operations are more efficient and do not require iterations over the entire map, instead additional subtree operations methods are provided by this Map to do just that.

API wise it behaves exactly like a regular Map implementation except for providing additional subtree methods. All required linkage and structuring is performed within this Map implementation itself and not exposed via the API in any way. For example, putting these key/value pairs:

 cn=Object1,ou=Objects,dc=example,dc=com : object1
 cn=Object2,ou=Objects,dc=example,dc=com : object2
 cn=Object3,ou=Objects,dc=example,dc=com : object3
 

then invoking a subtree method on this Map with any of these keys:

 ou=Objects,dc=example,dc=com
 dc=example,dc=com
 dc=com
 

would bring all three objects previously stored in this map into subtree operation scope. Standard Map API methods can only work with the objects previously stored in this map explicitly.

Note that this Map implementation is not synchronized.

Nested Class Summary

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

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

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

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
DITCacheMap() Default constructor.
DITCacheMap(Map<? extends DN,? extends T> m) Constructs a new DITCacheMap from a given Map.

Method Summary

Methods

Modifier and Type	Method and Description
void	clear()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<DN,T>>	entrySet()
T	get(Object key)
Collection<T>	getSubtree(DN key) Returns a set of stored objects subordinate to subtree DN.
boolean	isEmpty()
T	put(DN key, T value)
void	putAll(Map<? extends DN,? extends T> m)
T	remove(Object key)
boolean	removeSubtree(DN key, Collection<? super T> values) Removes a set of stored objects subordinate to subtree DN.
int	size()

Methods inherited from class java.util.AbstractMap

clone, equals, hashCode, keySet, toString, values

Methods inherited from class java.lang.Object

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

Constructor Detail

DITCacheMap

public DITCacheMap()

Default constructor.

DITCacheMap

public DITCacheMap(Map<? extends DN,? extends T> m)

Constructs a new DITCacheMap from a given Map.

Parameters:

m - existing Map to construct new DITCacheMap from.

Method Detail

size

public int size()

Specified by:

size in interface Map<DN,T>

Overrides:

size in class AbstractMap<DN,T>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<DN,T>

Overrides:

isEmpty in class AbstractMap<DN,T>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<DN,T>

Overrides:

containsKey in class AbstractMap<DN,T>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<DN,T>

Overrides:

containsValue in class AbstractMap<DN,T>

get

public T get(Object key)

Specified by:

get in interface Map<DN,T>

Overrides:

get in class AbstractMap<DN,T>

getSubtree

public Collection<T> getSubtree(DN key)

Returns a set of stored objects subordinate to subtree DN.

Parameters:

key - subtree DN.

Returns:

collection of stored objects subordinate to subtree DN.

put

public T put(DN key,
    T value)

Specified by:

put in interface Map<DN,T>

Overrides:

put in class AbstractMap<DN,T>

remove

public T remove(Object key)

Specified by:

remove in interface Map<DN,T>

Overrides:

remove in class AbstractMap<DN,T>

removeSubtree

public boolean removeSubtree(DN key,
                    Collection<? super T> values)

Removes a set of stored objects subordinate to subtree DN.

Parameters:

key - subtree DN.

values - collection for removed objects subordinate to subtree DN or null.

Returns:

true on success or false otherwise.

putAll

public void putAll(Map<? extends DN,? extends T> m)

Specified by:

putAll in interface Map<DN,T>

Overrides:

putAll in class AbstractMap<DN,T>

clear

public void clear()

Specified by:

clear in interface Map<DN,T>

Overrides:

clear in class AbstractMap<DN,T>

entrySet

public Set<Map.Entry<DN,T>> entrySet()

Specified by:

entrySet in interface Map<DN,T>

Specified by:

entrySet in class AbstractMap<DN,T>