<?php
/* Please see the README and LICENSE files. */

/**
 * Abstract class for specific types of cache controllers
 */
abstract class Cache_Controller {    
    /**
     * Add an object to the cache
     * 
     * @param String $name The object's unique name
     * @param Mixed $object The object to add
     * @param int $max_age The number of seconds to remain valid
     */
    abstract public function set($name,$object,$max_age=0);
    
    /**
     * Get something from the cache
     * 
     * @param String $name The unique name
     * @return Mixed The object
     */
    abstract public function get($name);
    
    /**
     * Check for the existance of an object in the cache
     * 
     * @param String $name The unique name
     * @return Boolean True if the object is stored and retrievable
     */
    abstract public function has($name);
    
    /**
     * Invalidate the keyed item, or everything if key is omitted
     */
    abstract public function clear($key=NULL);
    
}

?>