org.apache.commons.collections
Class ProxyMap

java.lang.Object
  |
  +--org.apache.commons.collections.ProxyMap

All Implemented Interfaces:

java.util.Map

public abstract class ProxyMap

extends java.lang.Object

implements java.util.Map

This Map wraps another Map implementation, using the wrapped instance for its default implementation. This class is used as a framework on which to build to extensions for its wrapped Map object which would be unavailable or inconvenient via sub-classing (but usable via composition).

An example use case is where the wrapped Map needs synchronization (to make it thread-safe), but the Map returned by Collections.synchronizedMap(map) hides part of map's public interface.

Since:

2.0

Author:

Daniel Rall

Constructor Summary

ProxyMap(java.util.Map map)
Creates a new instance acting as a representative for the specified Map.

Method Summary

void	clear() Invokes the underlying Map.clear() method.
boolean	containsKey(java.lang.Object key) Invokes the underlying Map.containsKey(Object) method.
boolean	containsValue(java.lang.Object value) Invokes the underlying Map.containsValue(Object) method.
java.util.Set	entrySet() Invokes the underlying Map.entrySet() method.
boolean	equals(java.lang.Object m) Invokes the underlying Map.equals(Object) method.
java.lang.Object	get(java.lang.Object key) Invokes the underlying Map.get(Object) method.
int	hashCode() Invokes the underlying Map.hashCode() method.
boolean	isEmpty() Invokes the underlying Map.isEmpty() method.
java.util.Set	keySet() Invokes the underlying Map.keySet() method.
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Invokes the underlying Map.put(Object,Object) method.
void	putAll(java.util.Map t) Invokes the underlying Map.putAll(Map) method.
java.lang.Object	remove(java.lang.Object key) Invokes the underlying Map.remove(Object) method.
int	size() Invokes the underlying Map.size() method.
java.util.Collection	values() Invokes the underlying Map.values() method.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ProxyMap

public ProxyMap(java.util.Map map)

Creates a new instance acting as a representative for the specified Map.

Parameters:

map - The Map to whose operations to wrap.

Method Detail

clear

public void clear()

Invokes the underlying Map.clear() method.

Specified by:

clear in interface java.util.Map

containsKey

public boolean containsKey(java.lang.Object key)

Invokes the underlying Map.containsKey(Object) method.

Specified by:

containsKey in interface java.util.Map

containsValue

public boolean containsValue(java.lang.Object value)

Invokes the underlying Map.containsValue(Object) method.

Specified by:

containsValue in interface java.util.Map

entrySet

public java.util.Set entrySet()

Invokes the underlying Map.entrySet() method.

Specified by:

entrySet in interface java.util.Map

equals

public boolean equals(java.lang.Object m)

Invokes the underlying Map.equals(Object) method.

Specified by:

equals in interface java.util.Map

Overrides:

equals in class java.lang.Object

get

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

Invokes the underlying Map.get(Object) method.

Specified by:

get in interface java.util.Map

hashCode

public int hashCode()

Invokes the underlying Map.hashCode() method.

Specified by:

hashCode in interface java.util.Map

Overrides:

hashCode in class java.lang.Object

isEmpty

public boolean isEmpty()

Invokes the underlying Map.isEmpty() method.

Specified by:

isEmpty in interface java.util.Map

keySet

public java.util.Set keySet()

Invokes the underlying Map.keySet() method.

Specified by:

keySet in interface java.util.Map

put

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

Invokes the underlying Map.put(Object,Object) method.

Specified by:

put in interface java.util.Map

putAll

public void putAll(java.util.Map t)

Invokes the underlying Map.putAll(Map) method.

Specified by:

putAll in interface java.util.Map

remove

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

Invokes the underlying Map.remove(Object) method.

Specified by:

remove in interface java.util.Map

size

public int size()

Invokes the underlying Map.size() method.

Specified by:

size in interface java.util.Map

values

public java.util.Collection values()

Invokes the underlying Map.values() method.

Specified by:

values in interface java.util.Map