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


Copyright © 2001-2004 The Apache Software Foundation. All Rights Reserved.