[hibernate-commits] Hibernate SVN: r14918 - in core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2: builder and 1 other directory.

[hibernate-commits at lists.jboss.org]

Author: bstansberry at jboss.com
Date: 2008-07-10 15:36:02 -0400 (Thu, 10 Jul 2008)
New Revision: 14918

Modified:
   core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/JndiMultiplexedJBossCacheRegionFactory.java
   core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/MultiplexedJBossCacheRegionFactory.java
   core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/MultiplexingCacheInstanceManager.java
   core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/SharedCacheInstanceManager.java
Log:
Javadoc

Modified: core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/JndiMultiplexedJBossCacheRegionFactory.java
===================================================================
--- core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/JndiMultiplexedJBossCacheRegionFactory.java	2008-07-10 15:49:26 UTC (rev 14917)
+++ core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/JndiMultiplexedJBossCacheRegionFactory.java	2008-07-10 19:36:02 UTC (rev 14918)
@@ -33,9 +33,9 @@
  * {@link #getCacheInstanceManager() CacheInstanceManager}.
  * <p>
  * Supports separate JBoss Cache instances for entity, collection, query
- * and timestamp caching, with the expectation that a single multiplexed
- * JGroups channel will be shared between the caches. JBoss Cache instances
- * are created from a factory.
+ * and timestamp caching, with the expectation that a single multiplexed JGroups 
+ * resource (i.e. a multiplexed channel or a shared transport channel) will be 
+ * shared between the caches. JBoss Cache instances are created from a factory.
  * </p>
  * <p>
  * This version finds the factory in JNDI. See 

Modified: core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/MultiplexedJBossCacheRegionFactory.java
===================================================================
--- core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/MultiplexedJBossCacheRegionFactory.java	2008-07-10 15:49:26 UTC (rev 14917)
+++ core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/MultiplexedJBossCacheRegionFactory.java	2008-07-10 19:36:02 UTC (rev 14918)
@@ -33,9 +33,9 @@
  * {@link #getCacheInstanceManager() CacheInstanceManager}.
  * <p>
  * Supports separate JBoss Cache instances for entity, collection, query
- * and timestamp caching, with the expectation that a single multiplexed
- * JGroups channel will be shared between the caches. JBoss Cache instances
- * are created from a factory.
+ * and timestamp caching, with the expectation that a single JGroups resource 
+ * (i.e. a multiplexed channel or a shared transport channel) will be shared 
+ * between the caches. JBoss Cache instances are created from a factory.
  * </p>
  * <p>
  * This version instantiates the factory itself. See 

Modified: core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/MultiplexingCacheInstanceManager.java
===================================================================
--- core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/MultiplexingCacheInstanceManager.java	2008-07-10 15:49:26 UTC (rev 14917)
+++ core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/MultiplexingCacheInstanceManager.java	2008-07-10 19:36:02 UTC (rev 14918)
@@ -44,9 +44,10 @@
 import org.hibernate.util.PropertiesHelper;
 
 /**
- * Allows building separate {@link Cache} instances for each type of region, but
- * supports using the JGroups multiplexer under the covers to re-use the same group
- * communication stack. <p/>
+ * Allows building separate {@link Cache} instances for each type of region,
+ * with the expectation that a single multiplexed JGroups resource (i.e. a 
+ * multiplexed channel or a shared transport channel) will be shared between 
+ * the caches.<p/>
  * 
  * @author Steve Ebersole
  * @author Brian Stansberry

Modified: core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/SharedCacheInstanceManager.java
===================================================================
--- core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/SharedCacheInstanceManager.java	2008-07-10 15:49:26 UTC (rev 14917)
+++ core/trunk/cache-jbosscache2/src/main/java/org/hibernate/cache/jbc2/builder/SharedCacheInstanceManager.java	2008-07-10 19:36:02 UTC (rev 14918)
@@ -42,12 +42,14 @@
 import org.hibernate.util.PropertiesHelper;
 
 /**
- * A {@link CacheInstanceManager} implementation where we use a single cache
- * instance we assume to be configured for invalidation if operating on a
- * cluster. Under that assumption, we can store all data into the same
- * {@link Cache} instance.
+ * A {@link CacheInstanceManager} implementation where we use a single JBoss Cache
+ * instance for each type of region. If operating on a cluster, the cache must
+ * be configured for REPL_SYNC if query caching is enabled. If query caching
+ * is not used, REPL_SYNC or INVALIDATION_SYNC are valid, with 
+ * INVALIDATION_SYNC preferred.
  * 
  * @author Steve Ebersole
+ * @author Brian Stansberry
  */
 public class SharedCacheInstanceManager implements CacheInstanceManager {