serp.util
Interface RefMap

All Superinterfaces:

Map

All Known Implementing Classes:

RefKeyMap, RefValueMap

Deprecated. Replaced by the ReferenceMap.

public interface RefMap

extends Map

Interface implemented by maps that support weak or soft references for their keys or values.

Inner classes inherited from class java.util.Map

Map.Entry

Method Summary

boolean	makeHard(Object key) Deprecated. Harden the reference for the given key.
boolean	makeReference(Object key) Deprecated. Soften the reference for the given key.

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Method Detail

makeHard

public boolean makeHard(Object key)

Deprecated.

Harden the reference for the given key. This will ensure that the key and the value it corresponds to are not garbage collected. Note that this is a mutator method and can result in ConcurrentModificationExceptions being thrown by any iterator in use while this method is called.

Returns:

true if the reference to the key is now hard; false if the key does not exist in the map (or has already expired)

makeReference

public boolean makeReference(Object key)

Deprecated.

Soften the reference for the given key. This will allow the key and the value it corresponds to can be expired from the map, and the key/value garbage collected. This is the default for all new key/ value pairs added to the map. Note that this is a mutator method and can result in ConcurrentModificationExceptions being thrown by any iterator in use while this method is called.

Returns:

true if the reference to the key/value is now soft; false if the key does not exist or the key/value cannot be maintained in a reference (as for nuill values)