Author: bstansberry(a)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 {