Merged BRANCHES/DEV/THOR1 to HEAD:

30458: ALF-10100: need to be able to apply %age or abs disk space usage constraints on ${dir.cachedcontent}
   30573: ALF-9613: Add min age of files checking to cached content cleaner
   30594: ALF-10100: added more sensible default in sample config for quota size (4GB)
   30695: ALF-10391, ALF-10392: Added MBeans and improved logging for monitoring purposes.
   30850: THOR-202: CachingContentStore quota manager should reject large files
   30901: Added warn-level logging about failure to cache content item
   30951: THOR-217 - when the quota is met or exceeded, then next time the cleaner runs it must use some strategy to make some space.





git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@30956 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/repo/content/caching/ContentCache.java

@@ -18,6 +18,8 @@
  */
 package org.alfresco.repo.content.caching;
 
+import java.io.File;
+
 import org.alfresco.service.cmr.repository.ContentReader;
 import org.alfresco.service.cmr.repository.ContentWriter;
 
@@ -30,6 +32,14 @@ import org.alfresco.service.cmr.repository.ContentWriter;
  */
 public interface ContentCache
 {
+    /**
+     * Returns the location where cache files will be written (cacheRoot) - implementation
+     * dependant and may be null.
+     * 
+     * @return cacheRoot
+     */
+    public File getCacheRoot();
+    
     /**
      * Check to see if the content - specified by URL - exists in the cache.
      * <p>
@@ -66,12 +76,21 @@ public interface ContentCache
 
     /**
      * Remove a cached item from the in-memory lookup table. Implementation should not remove
-     * the actual cached content (file) - this should be left to the clean-up process.
+     * the actual cached content (file) - this should be left to the clean-up process or can
+     * be deleted with {@link #deleteFile(String)}.
      * 
      * @param contentUrl
      */
     void remove(String contentUrl);
 
+    /**
+     * Deletes the cached content file for the specified URL. To remove the item from the
+     * lookup table also, use {@link #remove(String)} after calling this method.
+     * 
+     * @param url
+     */
+    void deleteFile(String url);
+
     /**
      * Retrieve a ContentWriter to write content to a cache file. Upon closing the stream
      * a listener will add the new content file to the in-memory lookup table.