net.cscott.jutil

Class AbstractMapEntry<K,V>

java.lang.Object

net.cscott.jutil.AbstractMapEntry<K,V>

All Implemented Interfaces:

java.util.Map.Entry<K,V>

Direct Known Subclasses:

PairMapEntry

public abstract class AbstractMapEntry<K,V>
extends java.lang.Object
implements java.util.Map.Entry<K,V>

An AbstractMapEntry takes care of most of the grunge work involved in subclassing Map.Entry. For an immutable entry, you need only implement getKey() and getValue(). For a modifiable entry, you must also implement setValue(Object); the default implementation throws an UnsupportedOperationException.

Version:

$Id: AbstractMapEntry.java,v 1.3 2006-10-30 20:14:40 cananian Exp $

Author:

C. Scott Ananian

Constructor Summary

Constructors

Constructor and Description
AbstractMapEntry()

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o) Compares the specified object with this entry for equality.
abstract K	getKey() Returns the key corresponding to this entry.
abstract V	getValue() Returns the value corresponding to this entry.
int	hashCode() Returns the hash code value for this map entry.
V	setValue(V value) Replaces the value corresponding to this entry with the specified value (optional operation).
java.lang.String	toString() Returns a human-readable representation of this map entry.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map.Entry

comparingByKey, comparingByKey, comparingByValue, comparingByValue

Constructor Detail

AbstractMapEntry

public AbstractMapEntry()

Method Detail

getKey

public abstract K getKey()

Returns the key corresponding to this entry.

Specified by:

getKey in interface java.util.Map.Entry<K,V>

getValue

public abstract V getValue()

Returns the value corresponding to this entry. If the mapping has been removed from the backing map (by the iterator's remove() operation), the results of this call are undefined.

Specified by:

getValue in interface java.util.Map.Entry<K,V>

setValue

public V setValue(V value)

Replaces the value corresponding to this entry with the specified value (optional operation). (Writes through to the map.) The behavior of this call is undefined if the mapping has already been removed from the map (by the iterator's remove() operation).

Specified by:

setValue in interface java.util.Map.Entry<K,V>

Returns:

old value corresponding to entry.

toString

public java.lang.String toString()

Returns a human-readable representation of this map entry.

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Compares the specified object with this entry for equality. Returns true if the given object is also a map entry and the two entries represent the same mapping.

Specified by:

equals in interface java.util.Map.Entry<K,V>

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Returns the hash code value for this map entry.

Specified by:

hashCode in interface java.util.Map.Entry<K,V>

Overrides:

hashCode in class java.lang.Object