org.apache.tools.ant.types.selectors.modifiedselector
Interface Cache

All Known Implementing Classes:
PropertiesfileCache

public interface Cache

A Cache let the user store key-value-pairs in a permanent manner and access them. It is possible that a client uses get() before load() therefore the implementation must ensure that no error occurred because of the wrong order. The implementing class should implement a useful toString() method.

Since:
Ant 1.6
Version:
2003-09-13

Method Summary
 void delete()
          Deletes the cache.
 java.lang.Object get(java.lang.Object key)
          Returns a value for a given key from the cache.
 boolean isValid()
          Checks its prerequisites.
 java.util.Iterator iterator()
          Returns an iterator over the keys in the cache.
 void load()
          Loads the cache, must handle not existing cache.
 void put(java.lang.Object key, java.lang.Object value)
          Saves a key-value-pair in the cache.
 void save()
          Saves modification of the cache.
 

Method Detail

isValid

boolean isValid()
Checks its prerequisites.

Returns:
true if all is ok, otherwise false.

delete

void delete()
Deletes the cache. If file based the file has to be deleted also.


load

void load()
Loads the cache, must handle not existing cache.


save

void save()
Saves modification of the cache.


get

java.lang.Object get(java.lang.Object key)
Returns a value for a given key from the cache.

Parameters:
key - the key
Returns:
the stored value

put

void put(java.lang.Object key,
         java.lang.Object value)
Saves a key-value-pair in the cache.

Parameters:
key - the key
value - the value

iterator

java.util.Iterator iterator()
Returns an iterator over the keys in the cache.

Returns:
An iterator over the keys.