## org.apache.tools.ant.types.selectors.modifiedselector
Class PropertiesfileCache

    java.lang.Object
      |
      +--org.apache.tools.ant.types.selectors.modifiedselector.PropertiesfileCache

All Implemented Interfaces:
  Cache

public class PropertiesfileCache
extends java.lang.Object
implements Cache

Use java.util.Properties for storing the values. The use of this Cache-implementation requires the use of the parameter for defining, where to store the properties file. The ModifiedSelector sets the cachefile to the default value cache.properties. Supported s are:

name | values | description | required
--- | --- | --- | ---
cache.cachefile | path to file | the name of the properties file | yes

Since:
  Ant 1.6
Version:
  2003-09-13
Author:
  Jan Matèrne

Constructor Summary
`PropertiesfileCache()` Bean-Constructor.
`PropertiesfileCache(java.io.File cachefile)` Constructor.

Method Summary
`void` `delete()` Deletes the cache and its underlying file.
`java.lang.Object` `get(java.lang.Object key)` Returns a value for a given key from the cache.
`java.io.File` `getCachefile()`
`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.
`void` `setCachefile(java.io.File file)`
`java.lang.String` `toString()` Override Object.toString().

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### PropertiesfileCache

    public PropertiesfileCache()

  Bean-Constructor.

### PropertiesfileCache

    public PropertiesfileCache(java.io.File cachefile)

  Constructor.

Parameters:
  `cachefile` - set the cachefile

Method Detail

### setCachefile

    public void setCachefile(java.io.File file)

### getCachefile

    public java.io.File getCachefile()

### isValid

    public boolean isValid()

  Description copied from interface: `Cache`
  Checks its prerequisites.

  Specified by:
    `isValid` in interface `Cache`
  Returns:
    true if all is ok, otherwise false.

### load

    public void load()

  Description copied from interface: `Cache`
  Loads the cache, must handle not existing cache.

  Specified by:
    `load` in interface `Cache`

### save

    public void save()

  Saves modification of the cache. Cache is only saved if there is one ore more entries. Because entries can not be deleted by this API, this Cache implementation checks the existence of entries before creating the file for performance optimisation.

  Specified by:
    `save` in interface `Cache`

### delete

    public void delete()

  Deletes the cache and its underlying file.

  Specified by:
    `delete` in interface `Cache`

### get

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

  Returns a value for a given key from the cache.

  Specified by:
    `get` in interface `Cache`
  Parameters:
    `key` - the key
  Returns:
    the stored value

### put

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

  Saves a key-value-pair in the cache.

  Specified by:
    `put` in interface `Cache`
  Parameters:
    `key` - the key
    `value` - the value

### iterator

    public java.util.Iterator iterator()

  Returns an iterator over the keys in the cache.

  Specified by:
    `iterator` in interface `Cache`
  Returns:
    An iterator over the keys.

### toString

    public java.lang.String toString()

  Override Object.toString().

  Overrides:
    `toString` in class `java.lang.Object`
  Returns:
    information about this cache

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.