Merged BRANCHES/DEV/mward/head_cachestats to HEAD:

89575: ACE-3327: Work In Progress. TX cache statistics.
   89642: ACE-3327: Exposes statistics through JMX. Adds hit ratio.
   89649: ACE-3327: Added "@since 5.0" to new classes.
   89691: ACE-3327: improved TransactionalCache stats tests.
   89743: ACE-3327: fixed lack of thread safety for InMemoryCacheStatistics.
   89752: ACE-3327: now possible to disable/enable tx cache statistics per-cache with properties.



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

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

@@ -0,0 +1,26 @@
+package org.alfresco.repo.cache;
+
+/**
+ * Read operations on {@link CacheStatistics} throw this
+ * RuntimeException when no statistics exist for the
+ * specified cache.
+ * 
+ * @since 5.0
+ * @author Matt Ward
+ */
+public class NoStatsForCache extends RuntimeException
+{
+    private static final long serialVersionUID = 1L;
+    private final String cacheName;
+    
+    public NoStatsForCache(String cacheName)
+    {
+        super("No statistics have been calculated for cache ["+cacheName+"]");
+        this.cacheName = cacheName;
+    }
+
+    public String getCacheName()
+    {
+        return this.cacheName;
+    }
+}