Author: tv Date: Sat Feb 6 17:39:19 2016 New Revision: 1728857 URL: http://svn.apache.org/viewvc?rev=1728857&view=rev Log: Fix Javadoc for Java 8. Thanks to Mat Jaggard for the patch.
Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/CacheAccess.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/PartitionedCacheAccess.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/behavior/ICacheAccess.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSAdminBean.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSJMXBean.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/servlet/JCSAdminServlet.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AbstractAuxiliaryCacheEventLogging.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AuxiliaryCacheFactory.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/AbstractDiskCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/PurgatoryElement.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/indexed/IndexedDiskCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/JDBCDiskCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/mysql/MySQLDiskCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWait.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWaitFacade.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralElementDescriptor.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPDiscoveryListener.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPService.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteAuxiliaryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheListener.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheNoWaitFacade.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/RemoteCacheNoWait.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/client/RemoteHttpCacheClient.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/server/AbstractRemoteCacheService.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheServer.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheStartupServlet.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/value/RemoteCacheResponse.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElement.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElementSerialized.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheEventQueue.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheService.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheServiceNonLocal.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/control/CompositeCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/control/CompositeCacheConfigurator.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/control/group/GroupId.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/memory/AbstractDoubleLinkedListMemoryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/memory/AbstractMemoryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/memory/behavior/IMemoryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/memory/lru/LHMLRUMemoryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/memory/lru/LRUMemoryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/utils/config/OptionConverter.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/utils/net/HostNameUtil.java commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/utils/struct/BoundedQueue.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/MockAuxiliaryCache.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCacheRandomConcurrentTestUtil.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCacheUnitTestAbstract.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/disk/block/HugeQuantityBlockDiskCacheLoadTest.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/remote/MockRemoteCacheClient.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/auxiliary/remote/MockRemoteCacheService.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/engine/SystemPropertyUsageUnitTest.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/engine/control/CompositeCacheDiskUsageUnitTest.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/utils/serialization/CompressingSerializerUnitTest.java commons/proper/jcs/trunk/commons-jcs-core/src/test/java/org/apache/commons/jcs/utils/threadpool/ThreadPoolUnitTest.java commons/proper/jcs/trunk/src/changes/changes.xml Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/CacheAccess.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/CacheAccess.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/CacheAccess.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/CacheAccess.java Sat Feb 6 17:39:19 2016 @@ -105,7 +105,7 @@ public class CacheAccess<K, V> } /** - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -117,7 +117,7 @@ public class CacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param name Key the Serializable is stored as - * @return The ICacheElement<K, V> if the object is found or null + * @return The ICacheElement<K, V> if the object is found or null */ @Override public ICacheElement<K, V> getCacheElement( K name ) @@ -128,7 +128,7 @@ public class CacheAccess<K, V> /** * Get multiple elements from the cache based on a set of cache keys. * <p> - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -140,7 +140,7 @@ public class CacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param names set of Serializable cache keys - * @return a map of K key to ICacheElement<K, V> element, or empty map if none of the keys are present + * @return a map of K key to ICacheElement<K, V> element, or empty map if none of the keys are present */ @Override public Map<K, ICacheElement<K, V>> getCacheElements( Set<K> names ) @@ -151,7 +151,7 @@ public class CacheAccess<K, V> /** * Get multiple elements from the cache based on a set of cache keys. * <p> - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -163,7 +163,7 @@ public class CacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param pattern key search pattern - * @return a map of K key to ICacheElement<K, V> element, or empty map if no keys match the pattern + * @return a map of K key to ICacheElement<K, V> element, or empty map if no keys match the pattern */ @Override public Map<K, ICacheElement<K, V>> getMatchingCacheElements( String pattern ) Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/PartitionedCacheAccess.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/PartitionedCacheAccess.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/PartitionedCacheAccess.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/PartitionedCacheAccess.java Sat Feb 6 17:39:19 2016 @@ -206,7 +206,7 @@ public class PartitionedCacheAccess<K ex } /** - * Gets the ICacheElement<K, V> (the wrapped object) for the key from the desired partition. + * Gets the ICacheElement<K, V> (the wrapped object) for the key from the desired partition. * <p> * @param key key * @return result, null if not found. Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/behavior/ICacheAccess.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/behavior/ICacheAccess.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/behavior/ICacheAccess.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/access/behavior/ICacheAccess.java Sat Feb 6 17:39:19 2016 @@ -80,7 +80,7 @@ public interface ICacheAccess<K, V> throws CacheException; /** - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -92,14 +92,14 @@ public interface ICacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param name Key the object is stored as - * @return The ICacheElement<K, V> if the object is found or null + * @return The ICacheElement<K, V> if the object is found or null */ ICacheElement<K, V> getCacheElement( K name ); /** * Get multiple elements from the cache based on a set of cache keys. * <p> - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -111,7 +111,7 @@ public interface ICacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param names set of Object cache keys - * @return a map of Object key to ICacheElement<K, V> element, or empty map if none of the keys are + * @return a map of Object key to ICacheElement<K, V> element, or empty map if none of the keys are * present */ Map<K, ICacheElement<K, V>> getCacheElements( Set<K> names ); @@ -119,7 +119,7 @@ public interface ICacheAccess<K, V> /** * Get multiple elements from the cache based on a set of cache keys. * <p> - * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other + * This method returns the ICacheElement<K, V> wrapper which provides access to element info and other * attributes. * <p> * This returns a reference to the wrapper. Any modifications will be reflected in the cache. No @@ -131,7 +131,7 @@ public interface ICacheAccess<K, V> * The last access time in the ElementAttributes should be current. * <p> * @param pattern key search pattern - * @return a map of Object key to ICacheElement<K, V> element, or empty map if no keys match the + * @return a map of Object key to ICacheElement<K, V> element, or empty map if no keys match the * pattern */ Map<K, ICacheElement<K, V>> getMatchingCacheElements( String pattern ); Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSAdminBean.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSAdminBean.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSAdminBean.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSAdminBean.java Sat Feb 6 17:39:19 2016 @@ -177,7 +177,7 @@ public class JCSAdminBean implements JCS /** * Tries to estimate how much data is in a region. This is expensive. If there are any non serializable objects in * the region or an error occurs, suppresses exceptions and returns 0. - * <p/> + * <p> * * @return int The size of the region in bytes. */ @@ -190,7 +190,7 @@ public class JCSAdminBean implements JCS /** * Tries to estimate how much data is in a region. This is expensive. If there are any non serializable objects in * the region or an error occurs, suppresses exceptions and returns 0. - * <p/> + * <p> * * @return int The size of the region in bytes. */ @@ -279,7 +279,7 @@ public class JCSAdminBean implements JCS /** * Clears all regions in the cache. - * <p/> + * <p> * If this class is running within a remote cache server, clears all regions via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears all regions in the cache directly via * the usual cache API. @@ -324,7 +324,7 @@ public class JCSAdminBean implements JCS /** * Clears a particular cache region. - * <p/> + * <p> * If this class is running within a remote cache server, clears the region via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears the region directly via the usual * cache API. @@ -361,7 +361,7 @@ public class JCSAdminBean implements JCS /** * Removes a particular item from a particular region. - * <p/> + * <p> * If this class is running within a remote cache server, removes the item via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears the region directly via the usual * cache API. Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSJMXBean.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSJMXBean.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSJMXBean.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/JCSJMXBean.java Sat Feb 6 17:39:19 2016 @@ -50,7 +50,7 @@ public interface JCSJMXBean /** * Tries to estimate how much data is in a region. This is expensive. If there are any non serializable objects in * the region or an error occurs, suppresses exceptions and returns 0. - * <p/> + * <p> * * @return int The size of the region in bytes. */ @@ -58,7 +58,7 @@ public interface JCSJMXBean /** * Clears all regions in the cache. - * <p/> + * <p> * If this class is running within a remote cache server, clears all regions via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears all regions in the cache directly via * the usual cache API. @@ -67,7 +67,7 @@ public interface JCSJMXBean /** * Clears a particular cache region. - * <p/> + * <p> * If this class is running within a remote cache server, clears the region via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears the region directly via the usual * cache API. @@ -76,7 +76,7 @@ public interface JCSJMXBean /** * Removes a particular item from a particular region. - * <p/> + * <p> * If this class is running within a remote cache server, removes the item via the <code>RemoteCacheServer</code> * API, so that removes will be broadcast to client machines. Otherwise clears the region directly via the usual * cache API. Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/servlet/JCSAdminServlet.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/servlet/JCSAdminServlet.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/servlet/JCSAdminServlet.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/admin/servlet/JCSAdminServlet.java Sat Feb 6 17:39:19 2016 @@ -95,7 +95,6 @@ public class JCSAdminServlet * @param response * @param context * @return Template - * @throws Exception * */ @Override Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AbstractAuxiliaryCacheEventLogging.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AbstractAuxiliaryCacheEventLogging.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AbstractAuxiliaryCacheEventLogging.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AbstractAuxiliaryCacheEventLogging.java Sat Feb 6 17:39:19 2016 @@ -31,7 +31,7 @@ import java.util.Set; /** * All ICacheEvents are defined as final. Children must implement process events. These are wrapped * in event log parent calls. - * <p> + * * You can override the public method, but if you don't, the default will call getWithTiming. */ public abstract class AbstractAuxiliaryCacheEventLogging<K, V> @@ -39,7 +39,7 @@ public abstract class AbstractAuxiliaryC { /** * Puts an item into the cache. - * <p> + * * @param cacheElement * @throws IOException */ @@ -52,7 +52,7 @@ public abstract class AbstractAuxiliaryC /** * Puts an item into the cache. Wrapped in logging. - * <p> + * * @param cacheElement * @throws IOException */ @@ -72,7 +72,7 @@ public abstract class AbstractAuxiliaryC /** * Implementation of put. - * <p> + * * @param cacheElement * @throws IOException */ @@ -81,7 +81,7 @@ public abstract class AbstractAuxiliaryC /** * Gets the item from the cache. - * <p> + * * @param key * @return ICacheElement, a wrapper around the key, value, and attributes * @throws IOException @@ -95,7 +95,7 @@ public abstract class AbstractAuxiliaryC /** * Gets the item from the cache. Wrapped in logging. - * <p> + * * @param key * @return ICacheElement, a wrapper around the key, value, and attributes * @throws IOException @@ -116,7 +116,7 @@ public abstract class AbstractAuxiliaryC /** * Implementation of get. - * <p> + * * @param key * @return ICacheElement, a wrapper around the key, value, and attributes * @throws IOException @@ -126,9 +126,9 @@ public abstract class AbstractAuxiliaryC /** * Gets multiple items from the cache based on the given set of keys. - * <p> + * * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -141,9 +141,9 @@ public abstract class AbstractAuxiliaryC /** * Gets multiple items from the cache based on the given set of keys. - * <p> + * * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -164,9 +164,9 @@ public abstract class AbstractAuxiliaryC /** * Implementation of getMultiple. - * <p> + * * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -176,14 +176,14 @@ public abstract class AbstractAuxiliaryC /** * Gets items from the cache matching the given pattern. Items from memory will replace those * from remote sources. - * <p> + * * This only works with string keys. It's too expensive to do a toString on every key. - * <p> + * * Auxiliaries will do their best to handle simple expressions. For instance, the JDBC disk * cache will convert * to % and . to _ - * <p> + * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data matching the pattern. * @throws IOException */ @@ -196,9 +196,9 @@ public abstract class AbstractAuxiliaryC /** * Gets mmatching items from the cache based on the given pattern. - * <p> + * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data matching the pattern. * @throws IOException */ @@ -218,9 +218,9 @@ public abstract class AbstractAuxiliaryC /** * Implementation of getMatching. - * <p> + * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data matching the pattern. * @throws IOException */ @@ -229,7 +229,7 @@ public abstract class AbstractAuxiliaryC /** * Removes the item from the cache. Wraps the remove in event logs. - * <p> + * * @param key * @return boolean, whether or not the item was removed * @throws IOException @@ -243,7 +243,7 @@ public abstract class AbstractAuxiliaryC /** * Removes the item from the cache. Wraps the remove in event logs. - * <p> + * * @param key * @return boolean, whether or not the item was removed * @throws IOException @@ -264,7 +264,7 @@ public abstract class AbstractAuxiliaryC /** * Specific implementation of remove. - * <p> + * * @param key * @return boolean, whether or not the item was removed * @throws IOException @@ -274,7 +274,7 @@ public abstract class AbstractAuxiliaryC /** * Removes all from the region. Wraps the removeAll in event logs. - * <p> + * * @throws IOException */ @Override @@ -286,7 +286,7 @@ public abstract class AbstractAuxiliaryC /** * Removes all from the region. Wraps the removeAll in event logs. - * <p> + * * @throws IOException */ protected final void removeAllWithEventLogging() @@ -305,7 +305,7 @@ public abstract class AbstractAuxiliaryC /** * Specific implementation of removeAll. - * <p> + * * @throws IOException */ protected abstract void processRemoveAll() @@ -313,7 +313,7 @@ public abstract class AbstractAuxiliaryC /** * Synchronously dispose the remote cache; if failed, replace the remote handle with a zombie. - * <p> + * * @throws IOException */ @Override @@ -326,7 +326,7 @@ public abstract class AbstractAuxiliaryC /** * Synchronously dispose the remote cache; if failed, replace the remote handle with a zombie. * Wraps the removeAll in event logs. - * <p> + * * @throws IOException */ protected final void disposeWithEventLogging() @@ -345,7 +345,7 @@ public abstract class AbstractAuxiliaryC /** * Specific implementation of dispose. - * <p> + * * @throws IOException */ protected abstract void processDispose() Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AuxiliaryCacheFactory.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AuxiliaryCacheFactory.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AuxiliaryCacheFactory.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/AuxiliaryCacheFactory.java Sat Feb 6 17:39:19 2016 @@ -30,7 +30,7 @@ public interface AuxiliaryCacheFactory { /** * Creates an auxiliary using the supplied attributes. Adds it to the composite cache manager. - * <p> + * * @param attr * @param cacheMgr This allows auxiliaries to reference the manager without assuming that it is * a singleton. This will allow JCS to be a non-singleton. Also, it makes it easier to @@ -57,14 +57,14 @@ public interface AuxiliaryCacheFactory /** * Sets the name attribute of the AuxiliaryCacheFactory object - * <p> + * * @param s The new name value */ void setName( String s ); /** * Gets the name attribute of the AuxiliaryCacheFactory object - * <p> + * * @return The name value */ String getName(); Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/AbstractDiskCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/AbstractDiskCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/AbstractDiskCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/AbstractDiskCache.java Sat Feb 6 17:39:19 2016 @@ -47,11 +47,11 @@ import org.apache.commons.logging.LogFac /** * Abstract class providing a base implementation of a disk cache, which can be easily extended to * implement a disk cache for a specific persistence mechanism. - * <p> + * * When implementing the abstract methods note that while this base class handles most things, it * does not acquire or release any locks. Implementations should do so as necessary. This is mainly * done to minimize the time spent in critical sections. - * <p> + * * Error handling in this class needs to be addressed. Currently if an exception is thrown by the * persistence mechanism, this class destroys the event queue. Should it also destroy purgatory? * Should it dispose itself? @@ -69,7 +69,7 @@ public abstract class AbstractDiskCache< * Map where elements are stored between being added to this cache and actually spooled to disk. * This allows puts to the disk cache to return quickly, and the more expensive operation of * serializing the elements to persistent storage queued for later. - * <p> + * * If the elements are pulled into the memory cache while the are still in purgatory, writing to * disk can be canceled. */ @@ -104,7 +104,7 @@ public abstract class AbstractDiskCache< /** * Construct the abstract disk cache, create event queues and purgatory. Child classes should * set the alive flag to true after they are initialized. - * <p> + * * @param attr */ protected AbstractDiskCache( IDiskCacheAttributes attr ) @@ -141,7 +141,7 @@ public abstract class AbstractDiskCache< /** * Purgatory size of -1 means to use a HashMap with no size limit. Anything greater will use an * LRU map of some sort. - * <p> + * * TODO Currently setting this to 0 will cause nothing to be put to disk, since it will assume * that if an item is not in purgatory, then it must have been plucked. We should make 0 * work, a way to not use purgatory. @@ -177,10 +177,10 @@ public abstract class AbstractDiskCache< /** * Adds the provided element to the cache. Element will be added to purgatory, and then queued * for later writing to the serialized storage mechanism. - * <p> + * * An update results in a put event being created. The put event will call the handlePut method * defined here. The handlePut method calls the implemented doPut on the child. - * <p> + * * @param cacheElement * @throws IOException * @see org.apache.commons.jcs.engine.behavior.ICache#update @@ -224,9 +224,9 @@ public abstract class AbstractDiskCache< /** * Check to see if the item is in purgatory. If so, return it. If not, check to see if we have * it on disk. - * <p> + * * @param key - * @return ICacheElement<K, V> or null + * @return ICacheElement<K, V> or null * @see AuxiliaryCache#get */ @Override @@ -302,14 +302,14 @@ public abstract class AbstractDiskCache< /** * Gets items from the cache matching the given pattern. Items from memory will replace those * from remote sources. - * <p> + * * This only works with string keys. It's too expensive to do a toString on every key. - * <p> + * * Auxiliaries will do their best to handle simple expressions. For instance, the JDBC disk * cache will convert * to % and . to _ - * <p> + * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data matching the pattern. * @throws IOException */ @@ -341,9 +341,9 @@ public abstract class AbstractDiskCache< /** * Gets multiple items from the cache based on the given set of keys. - * <p> + * * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys */ @Override @@ -369,7 +369,7 @@ public abstract class AbstractDiskCache< /** * The keys in the cache. - * <p> + * * @see org.apache.commons.jcs.auxiliary.AuxiliaryCache#getKeySet() */ @Override @@ -377,7 +377,7 @@ public abstract class AbstractDiskCache< /** * Removes are not queued. A call to remove is immediate. - * <p> + * * @param key * @return whether the item was present to be removed. * @throws IOException @@ -449,14 +449,14 @@ public abstract class AbstractDiskCache< /** * Adds a dispose request to the disk cache. - * <p> + * * Disposal proceeds in several steps. * <ol> * <li>Prior to this call the Composite cache dumped the memory into the disk cache. If it is - * large then we need to wait for the event queue to finish. + * large then we need to wait for the event queue to finish.</li> * <li>Wait until the event queue is empty of until the configured ShutdownSpoolTimeLimit is - * reached. - * <li>Call doDispose on the concrete impl. + * reached.</li> + * <li>Call doDispose on the concrete impl.</li> * </ol> * @throws IOException */ @@ -524,7 +524,7 @@ public abstract class AbstractDiskCache< /** * Gets basic stats for the abstract disk cache. - * <p> + * * @return String */ @Override @@ -535,7 +535,7 @@ public abstract class AbstractDiskCache< /** * Returns semi-structured data. - * <p> + * * @see org.apache.commons.jcs.auxiliary.AuxiliaryCache#getStatistics() */ @Override @@ -571,7 +571,7 @@ public abstract class AbstractDiskCache< /** * Size cannot be determined without knowledge of the cache implementation, so subclasses will * need to implement this method. - * <p> + * * @return the number of items. * @see ICache#getSize */ @@ -761,17 +761,17 @@ public abstract class AbstractDiskCache< * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *WithEventLogging method on the super. The *WithEventLogging methods call * the abstract process* methods. The children implement the process methods. - * <p> + * * ex. doGet calls getWithEventLogging, which calls processGet */ /** * Get a value from the persistent store. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @param key Key to locate value for. * @return An object matching key, or null. * @throws IOException @@ -784,11 +784,11 @@ public abstract class AbstractDiskCache< /** * Get a value from the persistent store. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @param pattern Used to match keys. * @return A map of matches.. * @throws IOException @@ -801,11 +801,11 @@ public abstract class AbstractDiskCache< /** * Add a cache element to the persistent store. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @param cacheElement * @throws IOException */ @@ -817,11 +817,11 @@ public abstract class AbstractDiskCache< /** * Remove an object from the persistent store if found. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @param key Key of object to remove. * @return whether or no the item was present when removed * @throws IOException @@ -834,11 +834,11 @@ public abstract class AbstractDiskCache< /** * Remove all objects from the persistent store. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @throws IOException */ protected final void doRemoveAll() @@ -850,11 +850,11 @@ public abstract class AbstractDiskCache< /** * Dispose of the persistent store. Note that disposal of purgatory and setting alive to false * does NOT need to be done by this method. - * <p> + * * Before the event logging layer, the subclasses implemented the do* methods. Now the do* * methods call the *EventLogging method on the super. The *WithEventLogging methods call the * abstract process* methods. The children implement the process methods. - * <p> + * * @throws IOException */ protected final void doDispose() @@ -865,7 +865,7 @@ public abstract class AbstractDiskCache< /** * Gets the extra info for the event log. - * <p> + * * @return disk location */ @Override @@ -876,7 +876,7 @@ public abstract class AbstractDiskCache< /** * This is used by the event logging. - * <p> + * * @return the location of the disk, either path or ip. */ protected abstract String getDiskLocation(); Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/PurgatoryElement.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/PurgatoryElement.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/PurgatoryElement.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/PurgatoryElement.java Sat Feb 6 17:39:19 2016 @@ -25,7 +25,7 @@ import org.apache.commons.jcs.engine.beh /** * Implementation of cache elements in purgatory. - * <p> + * * Elements are stored in purgatory when they are spooled to the auxiliary cache, but have not yet * been written to disk. */ @@ -42,8 +42,8 @@ public class PurgatoryElement<K, V> private ICacheElement<K, V> cacheElement; /** - * Constructor for the PurgatoryElement<K, V> object - * <p> + * Constructor for the PurgatoryElement<K, V> object + * * @param cacheElement CacheElement */ public PurgatoryElement( ICacheElement<K, V> cacheElement ) @@ -56,7 +56,7 @@ public class PurgatoryElement<K, V> /** * Gets the spoolable property. - * <p> + * * @return The spoolable value */ public boolean isSpoolable() @@ -66,7 +66,7 @@ public class PurgatoryElement<K, V> /** * Sets the spoolable property. - * <p> + * * @param spoolable The new spoolable value */ public void setSpoolable( boolean spoolable ) @@ -76,7 +76,7 @@ public class PurgatoryElement<K, V> /** * Get the wrapped cache element. - * <p> + * * @return ICacheElement */ public ICacheElement<K, V> getCacheElement() Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/block/BlockDiskCache.java Sat Feb 6 17:39:19 2016 @@ -254,7 +254,7 @@ public class BlockDiskCache<K, V> * Gets matching items from the cache. * <p> * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching keys */ @Override @@ -300,7 +300,7 @@ public class BlockDiskCache<K, V> } /** - * Gets the ICacheElement<K, V> for the key if it is in the cache. The program flow is as follows: + * Gets the ICacheElement<K, V> for the key if it is in the cache. The program flow is as follows: * <ol> * <li>Make sure the disk cache is alive.</li> <li>Get a read lock.</li> <li>See if the key is * in the key store.</li> <li>If we found a key, ask the BlockDisk for the object at the Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/indexed/IndexedDiskCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/indexed/IndexedDiskCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/indexed/IndexedDiskCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/indexed/IndexedDiskCache.java Sat Feb 6 17:39:19 2016 @@ -496,7 +496,7 @@ public class IndexedDiskCache<K, V> exte * <p> * * @param ce - * The ICacheElement<K, V> to put to disk. + * The ICacheElement<K, V> to put to disk. */ @Override protected void processUpdate(ICacheElement<K, V> ce) @@ -611,7 +611,7 @@ public class IndexedDiskCache<K, V> exte * <p> * * @param key - * @return ICacheElement<K, V> or null + * @return ICacheElement<K, V> or null * @see AbstractDiskCache#doGet */ @Override @@ -663,7 +663,7 @@ public class IndexedDiskCache<K, V> exte * <p> * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching keys */ @Override Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/JDBCDiskCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/JDBCDiskCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/JDBCDiskCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/JDBCDiskCache.java Sat Feb 6 17:39:19 2016 @@ -71,7 +71,7 @@ import org.apache.commons.logging.LogFac * ); * </pre> * <p> - * The cleanup thread will delete non eternal items where (now - create time) > max life seconds * + * The cleanup thread will delete non eternal items where (now - create time) > max life seconds * * 1000 * <p> * To speed up the deletion the SYSTEM_EXPIRE_TIME_SECONDS is used instead. It is recommended that @@ -807,7 +807,7 @@ public class JDBCDiskCache<K, V> } /** - * Removed the expired. (now - create time) > max life seconds * 1000 + * Removed the expired. (now - create time) > max life seconds * 1000 * <p> * @return the number deleted */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/mysql/MySQLDiskCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/mysql/MySQLDiskCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/mysql/MySQLDiskCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/disk/jdbc/mysql/MySQLDiskCache.java Sat Feb 6 17:39:19 2016 @@ -148,7 +148,7 @@ public class MySQLDiskCache<K, V> } /** - * Removed the expired. (now - create time) > max life seconds * 1000 + * Removed the expired. (now - create time) > max life seconds * 1000 * <p> * If we are currently optimizing, then this method will balk and do nothing. * <p> Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCache.java Sat Feb 6 17:39:19 2016 @@ -118,7 +118,7 @@ public class LateralCache<K, V> * The performance costs are too great. It is not recommended that you enable lateral gets. * <p> * @param key - * @return ICacheElement<K, V> or null + * @return ICacheElement<K, V> or null * @throws IOException */ @Override @@ -145,7 +145,7 @@ public class LateralCache<K, V> /** * @param pattern - * @return A map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return A map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -173,7 +173,7 @@ public class LateralCache<K, V> * Gets multiple items from the cache based on the given set of keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWait.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWait.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWait.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWait.java Sat Feb 6 17:39:19 2016 @@ -124,7 +124,7 @@ public class LateralCacheNoWait<K, V> * Synchronously reads from the lateral cache. * <p> * @param key - * @return ICacheElement<K, V> if found, else null + * @return ICacheElement<K, V> if found, else null */ @Override public ICacheElement<K, V> get( K key ) @@ -161,7 +161,7 @@ public class LateralCacheNoWait<K, V> * Gets multiple items from the cache based on the given set of keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys */ @Override @@ -189,7 +189,7 @@ public class LateralCacheNoWait<K, V> * Synchronously reads from the lateral cache. * <p> * @param pattern - * @return ICacheElement<K, V> if found, else empty + * @return ICacheElement<K, V> if found, else empty */ @Override public Map<K, ICacheElement<K, V>> getMatching(String pattern) Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWaitFacade.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWaitFacade.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWaitFacade.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralCacheNoWaitFacade.java Sat Feb 6 17:39:19 2016 @@ -241,7 +241,7 @@ public class LateralCacheNoWaitFacade<K, * Gets multiple items from the cache based on the given set of keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys */ @Override Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralElementDescriptor.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralElementDescriptor.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralElementDescriptor.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/LateralElementDescriptor.java Sat Feb 6 17:39:19 2016 @@ -60,7 +60,7 @@ public class LateralElementDescriptor<K, /** * Constructor for the LateralElementDescriptor object * <p> - * @param ce ICacheElement<K, V> payload + * @param ce ICacheElement<K, V> payload */ public LateralElementDescriptor( ICacheElement<K, V> ce ) { Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java Sat Feb 6 17:39:19 2016 @@ -226,7 +226,7 @@ public class LateralTCPCacheFactory * <p> * @param lca configuration for the creation of a new service instance * - * @return ICacheServiceNonLocal<K, V> + * @return ICacheServiceNonLocal<K, V> */ // Need to cast because of common map for all cache services @SuppressWarnings("unchecked") Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPDiscoveryListener.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPDiscoveryListener.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPDiscoveryListener.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPDiscoveryListener.java Sat Feb 6 17:39:19 2016 @@ -88,7 +88,7 @@ public class LateralTCPDiscoveryListener * not configured to use the lateral cache, and no facade will be created. * <p> * @param cacheName - the region name - * @param facade - facade (for region) => multiple lateral clients. + * @param facade - facade (for region) => multiple lateral clients. * @return true if the facade was not already registered. */ public synchronized boolean addNoWaitFacade( String cacheName, LateralCacheNoWaitFacade<?, ?> facade ) Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPService.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPService.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPService.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/lateral/socket/tcp/LateralTCPService.java Sat Feb 6 17:39:19 2016 @@ -204,7 +204,7 @@ public class LateralTCPService<K, V> /** * @param cacheName * @param key - * @return ICacheElement<K, V> if found. + * @return ICacheElement<K, V> if found. * @throws IOException */ @Override @@ -220,7 +220,7 @@ public class LateralTCPService<K, V> * @param cacheName * @param key * @param requesterId - * @return ICacheElement<K, V> if found. + * @return ICacheElement<K, V> if found. * @throws IOException */ @Override @@ -254,7 +254,7 @@ public class LateralTCPService<K, V> * <p> * @param cacheName * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */ @@ -271,7 +271,7 @@ public class LateralTCPService<K, V> * @param cacheName * @param pattern * @param requesterId - our identity - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */ @@ -307,7 +307,7 @@ public class LateralTCPService<K, V> * <p> * @param cacheName * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -326,7 +326,7 @@ public class LateralTCPService<K, V> * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteAuxiliaryCache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteAuxiliaryCache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteAuxiliaryCache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteAuxiliaryCache.java Sat Feb 6 17:39:19 2016 @@ -316,7 +316,7 @@ public abstract class AbstractRemoteAuxi * Gets multiple items from the cache based on the given set of keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheListener.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheListener.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheListener.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheListener.java Sat Feb 6 17:39:19 2016 @@ -127,7 +127,8 @@ public abstract class AbstractRemoteCach } /** - * Gets the remoteType attribute of the RemoteCacheListener object <p. + * Gets the remoteType attribute of the RemoteCacheListener object + * <p> * @return The remoteType value * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheNoWaitFacade.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheNoWaitFacade.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheNoWaitFacade.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/AbstractRemoteCacheNoWaitFacade.java Sat Feb 6 17:39:19 2016 @@ -142,7 +142,7 @@ public abstract class AbstractRemoteCach * Synchronously reads from the remote cache. * <p> * @param key - * @return Either an ICacheElement<K, V> or null if it is not found. + * @return Either an ICacheElement<K, V> or null if it is not found. */ @Override public ICacheElement<K, V> get( K key ) @@ -195,7 +195,7 @@ public abstract class AbstractRemoteCach * Gets multiple items from the cache based on the given set of keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys */ @Override Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/RemoteCacheNoWait.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/RemoteCacheNoWait.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/RemoteCacheNoWait.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/RemoteCacheNoWait.java Sat Feb 6 17:39:19 2016 @@ -233,7 +233,7 @@ public class RemoteCacheNoWait<K, V> * request on to the server rather than looping through the requested keys. * <p> * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/client/RemoteHttpCacheClient.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/client/RemoteHttpCacheClient.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/client/RemoteHttpCacheClient.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/client/RemoteHttpCacheClient.java Sat Feb 6 17:39:19 2016 @@ -143,7 +143,7 @@ public class RemoteHttpCacheClient<K, V> * <p> * @param cacheName * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */ @@ -160,7 +160,7 @@ public class RemoteHttpCacheClient<K, V> * @param cacheName * @param pattern * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */ @@ -194,7 +194,7 @@ public class RemoteHttpCacheClient<K, V> * <p> * @param cacheName * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -211,7 +211,7 @@ public class RemoteHttpCacheClient<K, V> * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/server/AbstractRemoteCacheService.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/server/AbstractRemoteCacheService.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/server/AbstractRemoteCacheService.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/http/server/AbstractRemoteCacheService.java Sat Feb 6 17:39:19 2016 @@ -256,7 +256,7 @@ public abstract class AbstractRemoteCach * <p> * @param cacheName * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -275,7 +275,7 @@ public abstract class AbstractRemoteCach * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -301,7 +301,7 @@ public abstract class AbstractRemoteCach * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheServer.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheServer.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheServer.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheServer.java Sat Feb 6 17:39:19 2016 @@ -204,8 +204,8 @@ public class RemoteCacheServer<K, V> /** * Puts a cache bean to the remote cache and notifies all listeners which <br> * <ol> - * <li>have a different listener id than the originating host; <li>are currently subscribed to - * the related cache. + * <li>have a different listener id than the originating host;</li> + * <li>are currently subscribed to the related cache.</li> * </ol> * <p> * @param item @@ -679,7 +679,7 @@ public class RemoteCacheServer<K, V> * <p> * @param cacheName * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -698,7 +698,7 @@ public class RemoteCacheServer<K, V> * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -724,7 +724,7 @@ public class RemoteCacheServer<K, V> * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys */ private Map<K, ICacheElement<K, V>> processGetMultiple( String cacheName, Set<K> keys, long requesterId ) Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheStartupServlet.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheStartupServlet.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheStartupServlet.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/server/RemoteCacheStartupServlet.java Sat Feb 6 17:39:19 2016 @@ -40,19 +40,19 @@ import java.util.Properties; * in a tomcat base. This give you an easy way to monitor its activity. * <p> * <code> - * <servlet> - <servlet-name>JCSRemoteCacheStartupServlet</servlet-name> - <servlet-class> + * servlet> + <servlet-name>JCSRemoteCacheStartupServlet</servlet-name> + <servlet-class> org.apache.commons.jcs.auxiliary.remote.server.RemoteCacheStartupServlet - </servlet-class> - <load-on-startup>1</load-on-startup> - </servlet> + </servlet-class> + <load-on-startup>1</load-on-startup> + </servlet> - <servlet-mapping> - <servlet-name>JCSRemoteCacheStartupServlet</servlet-name> - <url-pattern>/jcs</url-pattern> - </servlet-mapping> + <servlet-mapping> + <servlet-name>JCSRemoteCacheStartupServlet</servlet-name> + <url-pattern>/jcs</url-pattern> + </servlet-mapping> * </code> * @author Aaron Smuts */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/value/RemoteCacheResponse.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/value/RemoteCacheResponse.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/value/RemoteCacheResponse.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/auxiliary/remote/value/RemoteCacheResponse.java Sat Feb 6 17:39:19 2016 @@ -38,7 +38,7 @@ public class RemoteCacheResponse<T> private String errorMessage; /** - * The payload. Typically a key / ICacheElement<K, V> map. A normal get will return a map with one + * The payload. Typically a key / ICacheElement<K, V> map. A normal get will return a map with one * record. */ private T payload; Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICache.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICache.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICache.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICache.java Sat Feb 6 17:39:19 2016 @@ -29,7 +29,7 @@ import java.util.Set; /** * This is the top level interface for all cache like structures. It defines the methods used * internally by JCS to access, modify, and instrument such structures. - * <p> + * * This allows for a suite of reusable components for accessing such structures, for example * asynchronous access via an event queue. */ @@ -38,7 +38,7 @@ public interface ICache<K, V> { /** * Puts an item to the cache. - * <p> + * * @param element * @throws IOException */ @@ -47,7 +47,7 @@ public interface ICache<K, V> /** * Gets an item from the cache. - * <p> + * * @param key * @return a cache element, or null if there is no data in cache for this key * @throws IOException @@ -57,9 +57,9 @@ public interface ICache<K, V> /** * Gets multiple items from the cache based on the given set of keys. - * <p> + * * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no data in cache for any of these keys + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no data in cache for any of these keys * @throws IOException */ Map<K, ICacheElement<K, V>> getMultiple(Set<K> keys) @@ -67,13 +67,13 @@ public interface ICache<K, V> /** * Gets items from the cache matching the given pattern. Items from memory will replace those from remote sources. - * <p> + * * This only works with string keys. It's too expensive to do a toString on every key. - * <p> + * * Auxiliaries will do their best to handle simple expressions. For instance, the JDBC disk cache will convert * to % and . to _ - * <p> + * * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no data matching the pattern. + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no data matching the pattern. * @throws IOException */ Map<K, ICacheElement<K, V>> getMatching(String pattern) @@ -81,7 +81,7 @@ public interface ICache<K, V> /** * Removes an item from the cache. - * <p> + * * @param key * @return false if there was an error in removal * @throws IOException @@ -91,7 +91,7 @@ public interface ICache<K, V> /** * Removes all cached items from the cache. - * <p> + * * @throws IOException */ void removeAll() @@ -106,35 +106,35 @@ public interface ICache<K, V> /** * Returns the current cache size in number of elements. - * <p> + * * @return number of elements */ int getSize(); /** * Returns the cache status. - * <p> + * * @return Alive or Error */ CacheStatus getStatus(); /** * Returns the cache stats. - * <p> + * * @return String of important historical information. */ String getStats(); /** * Returns the cache name. - * <p> + * * @return usually the region name. */ String getCacheName(); /** * Sets the key matcher used by get matching. - * <p> + * * @param keyMatcher */ void setKeyMatcher( IKeyMatcher<K> keyMatcher ); Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElement.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElement.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElement.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElement.java Sat Feb 6 17:39:19 2016 @@ -36,7 +36,7 @@ public interface ICacheElement<K, V> { /** - * Gets the cacheName attribute of the ICacheElement<K, V> object. The cacheName + * Gets the cacheName attribute of the ICacheElement<K, V> object. The cacheName * is also known as the region name. * * @return The cacheName value @@ -44,28 +44,28 @@ public interface ICacheElement<K, V> String getCacheName(); /** - * Gets the key attribute of the ICacheElement<K, V> object + * Gets the key attribute of the ICacheElement<K, V> object * * @return The key value */ K getKey(); /** - * Gets the val attribute of the ICacheElement<K, V> object + * Gets the val attribute of the ICacheElement<K, V> object * * @return The val value */ V getVal(); /** - * Gets the attributes attribute of the ICacheElement<K, V> object + * Gets the attributes attribute of the ICacheElement<K, V> object * * @return The attributes value */ IElementAttributes getElementAttributes(); /** - * Sets the attributes attribute of the ICacheElement<K, V> object + * Sets the attributes attribute of the ICacheElement<K, V> object * * @param attr * The new attributes value Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElementSerialized.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElementSerialized.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElementSerialized.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheElementSerialized.java Sat Feb 6 17:39:19 2016 @@ -24,7 +24,7 @@ package org.apache.commons.jcs.engine.be * <p> * The value is stored as a byte array. This should allow for a variety of serialization mechanisms. * <p> - * This currently extends ICacheElement<K, V> for backward compatibility. + * This currently extends ICacheElement<K, V> for backward compatibility. *<p> * @author Aaron Smuts */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheEventQueue.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheEventQueue.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheEventQueue.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheEventQueue.java Sat Feb 6 17:39:19 2016 @@ -40,7 +40,7 @@ public interface ICacheEventQueue<K, V> /** * Initializes the queue. - * <,p> + * <p> * @param listener * @param listenerId * @param cacheName Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheService.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheService.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheService.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheService.java Sat Feb 6 17:39:19 2016 @@ -49,7 +49,7 @@ public interface ICacheService<K, V> * <p> * @param cacheName * @param key - * @return the ICacheElement<K, V> or null if not found + * @return the ICacheElement<K, V> or null if not found * @throws ObjectNotFoundException * @throws IOException */ @@ -61,7 +61,7 @@ public interface ICacheService<K, V> * <p> * @param cacheName * @param keys - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws ObjectNotFoundException * @throws IOException @@ -74,7 +74,7 @@ public interface ICacheService<K, V> * <p> * @param cacheName * @param pattern - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */ Modified: commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheServiceNonLocal.java URL: http://svn.apache.org/viewvc/commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheServiceNonLocal.java?rev=1728857&r1=1728856&r2=1728857&view=diff ============================================================================== --- commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheServiceNonLocal.java (original) +++ commons/proper/jcs/trunk/commons-jcs-core/src/main/java/org/apache/commons/jcs/engine/behavior/ICacheServiceNonLocal.java Sat Feb 6 17:39:19 2016 @@ -85,7 +85,7 @@ public interface ICacheServiceNonLocal<K * @param cacheName * @param keys * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache for any of these keys * @throws IOException */ @@ -98,7 +98,7 @@ public interface ICacheServiceNonLocal<K * @param cacheName * @param pattern * @param requesterId - * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no + * @return a map of K key to ICacheElement<K, V> element, or an empty map if there is no * data in cache matching the pattern. * @throws IOException */