[1.7.0] Add missing functions for DefinitionCache: replace, flush and type-checking

- Add version to configuration object, and have update script change it accordingly

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@1095 48356398-32a2-884e-a903-53898d9a118a

library/HTMLPurifier/DefinitionCache.php

@@ -6,8 +6,6 @@ require_once 'HTMLPurifier/DefinitionCache/Serializer.php';
  * Abstract class representing Definition cache managers that implements
  * useful common methods and is a factory.
  * @note The configuration object is transformed into the key used by the cache
- * @todo Implement flush()
- * @todo Implement replace()
  * @todo Get some sort of versioning variable so the library can easily
  *       invalidate the cache with a new version
  * @todo Make the test runner cache aware and allow the user to easily
@@ -16,7 +14,6 @@ require_once 'HTMLPurifier/DefinitionCache/Serializer.php';
  *       cache their custom HTMLDefinition, which can be loaded
  *       via a configuration directive
  * @todo Implement memcached
- * @todo Perform type checking on $def objects
  */
 class HTMLPurifier_DefinitionCache
 {
@@ -50,6 +47,20 @@ class HTMLPurifier_DefinitionCache
         return new HTMLPurifier_DefinitionCache_Serializer($name);
     }
     
+    /**
+     * Checks if a definition's type jives with the cache's type
+     * @note Throws an error on failure
+     * @param $def Definition object to check
+     * @return Boolean true if good, false if not
+     */
+    function checkDefType($def) {
+        if ($def->type !== $this->type) {
+            trigger_error("Cannot use definition of type {$def->type} in cache for {$this->type}");
+            return false;
+        }
+        return true;
+    }
+    
     /**
      * Adds a definition object to the cache
      */
@@ -64,6 +75,13 @@ class HTMLPurifier_DefinitionCache
         trigger_error('Cannot call abstract method', E_USER_ERROR);
     }
     
+    /**
+     * Replace an object in the cache
+     */
+    function replace($def, $config) {
+        trigger_error('Cannot call abstract method', E_USER_ERROR);
+    }
+    
     /**
      * Retrieves a definition object from the cache
      */
@@ -78,6 +96,13 @@ class HTMLPurifier_DefinitionCache
         trigger_error('Cannot call abstract method', E_USER_ERROR);
     }
     
+    /**
+     * Clears all objects from cache
+     */
+    function flush($config) {
+        trigger_error('Cannot call abstract method', E_USER_ERROR);
+    }
+    
 }
 
 ?>