Merged HEAD-QA to HEAD (4.2) (including moving test classes into separate folders)

51903 to 54309 


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

source/java/org/alfresco/repo/cache/AsynchronouslyRefreshedCache.java

@@ -22,16 +22,21 @@ package org.alfresco.repo.cache;
  * Implementation details in addition to the exposed interface.
  * 
  * @author Andy
- *
+ * @since 4.1.3
  */
 public interface AsynchronouslyRefreshedCache<T> extends RefreshableCache<T>
 {
-
     /**
      * Get the cache id
      * 
-     * @return
+     * @return          the cache ID
      */
     String getCacheId();
    
+    /**
+     * Determine if the cache is up to date
+     * 
+     * @return          <tt>true</tt> if the cache is not currently refreshing itself
+     */
+    boolean isUpToDate();
 }