From 2b6036cba2ec84a76464e42989b5ff59ce58f153 Mon Sep 17 00:00:00 2001 From: gil Date: Jun 18 2015 12:30:34 +0000 Subject: disable doclint in javadoc --- diff --git a/ehcache-core-2.6.7-java8doc.patch b/ehcache-core-2.6.7-java8doc.patch deleted file mode 100644 index 1d34802..0000000 --- a/ehcache-core-2.6.7-java8doc.patch +++ /dev/null @@ -1,6109 +0,0 @@ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/CacheEntry.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/CacheEntry.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/CacheEntry.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/CacheEntry.java 2015-06-17 11:42:51.352340551 +0200 -@@ -18,7 +18,7 @@ - - /** - * Helper class to tie a key to an element. -- *

-+ * - * This is used for operations that are identified by a key but that could benefit from additional information that's - * available in an element when it can be found in the cache. If the element isn't available, it will be {@code null}. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/CacheException.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/CacheException.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/CacheException.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/CacheException.java 2015-06-17 11:43:24.703738748 +0200 -@@ -19,11 +19,11 @@ - - /** - * A runtime Cache Exception. -- *

-+ * - * These exceptions may be handled by a CacheExceptionHandler registered with a Cache. - * The handler provides a key if it is available. A convention that should be followed in exception messages is - * to include in the message "key keyValue" e.g. "key 1234" so that keys can be parsed out of exception messages. -- *

-+ * - * Updated in version 1.5 to remove getInitialCause which was a left over from the pre-JDK1.4 - * days. It breaks JAXB. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Cache.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Cache.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Cache.java 2013-03-05 17:58:11.000000000 +0100 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Cache.java 2015-06-17 11:22:04.842759306 +0200 -@@ -143,16 +143,16 @@ - * Cache is the central class in ehcache. Caches have {@link Element}s and are managed - * by the {@link CacheManager}. The Cache performs logical actions. It delegates physical - * implementations to its {@link net.sf.ehcache.store.Store}s. -- *

-+ * - * A reference to a Cache can be obtained through the {@link CacheManager}. A Cache thus obtained - * is guaranteed to have status {@link Status#STATUS_ALIVE}. This status is checked for any method which - * throws {@link IllegalStateException} and the same thrown if it is not alive. This would normally - * happen if a call is made after {@link CacheManager#shutdown} is invoked. -- *

-+ * - * Cache is threadsafe. -- *

-+ * - * Statistics on cache usage are collected and made available through the {@link #getStatistics()} methods. -- *

-+ * - * Various decorators are available for Cache, such as BlockingCache, SelfPopulatingCache and the dynamic proxy - * ExceptionHandlingDynamicCacheProxy. See each class for details. - * -@@ -170,9 +170,9 @@ - - /** - * System Property based method of disabling ehcache. If disabled no elements will be added to a cache. -- *

-+ * - * Set the property "net.sf.ehcache.disabled=true" to disable ehcache. -- *

-+ * - * This can easily be done using java -Dnet.sf.ehcache.disabled=true in the command line. - */ - public static final String NET_SF_EHCACHE_DISABLED = "net.sf.ehcache.disabled"; -@@ -180,10 +180,10 @@ - /** - * System Property based method of selecting the LruMemoryStore in use up to ehcache 1.5. This is provided - * for ease of migration. -- *

-+ * - * Set the property "net.sf.ehcache.use.classic.lru=true" to use the older LruMemoryStore implementation - * when LRU is selected as the eviction policy. -- *

-+ * - * This can easily be done using java -Dnet.sf.ehcache.use.classic.lru=true in the command line. - */ - public static final String NET_SF_EHCACHE_USE_CLASSIC_LRU = "net.sf.ehcache.use.classic.lru"; -@@ -259,14 +259,14 @@ - - /** - * A ThreadPoolExecutor which uses a thread pool to schedule loads in the order in which they are requested. -- *

-+ * - * Each cache has its own one of these, if required. Because the Core Thread Pool is zero, no threads - * are used until actually needed. Threads are added to the pool up to a maximum of 10. The keep alive - * time is 60 seconds, after which, if they are not required they will be stopped and collected. -- *

-+ * - * The executorService is only used for cache loading, and is created lazily on demand to avoid unnecessary resource - * usage. -- *

-+ * - * Use {@link #getExecutorService()} to ensure that it is initialised. - */ - private volatile ExecutorService executorService; -@@ -289,12 +289,12 @@ - - /** - * 2.0 and higher Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param cacheConfiguration the configuration that should be used to create the cache with -@@ -305,14 +305,14 @@ - - /** - * 2.0 and higher Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} - * and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} - * object into {@link CacheManager#addCache} to specify parameters other - * than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param cacheConfiguration the configuration that should be used to create the cache with -@@ -361,16 +361,16 @@ - - /** - * 1.0 Constructor. -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. -- *

-+ * - * This constructor creates disk stores, if specified, that do not persist between restarts. -- *

-+ * - * The default expiry thread interval of 120 seconds is used. This is the interval between runs - * of the expiry thread, where it checks the disk store for expired elements. It is not the - * the timeToLiveSeconds. -@@ -398,12 +398,12 @@ - - /** - * 1.1 Constructor. -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -444,12 +444,12 @@ - - /** - * 1.2 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -496,12 +496,12 @@ - - /** - * 1.2.1 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -548,12 +548,12 @@ - - /** - * 1.2.4 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -603,12 +603,12 @@ - - /** - * 1.3 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -661,12 +661,12 @@ - - /** - * 1.6.0 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -722,12 +722,12 @@ - - /** - * 1.7.0 Constructor -- *

-+ * - * The {@link net.sf.ehcache.config.ConfigurationFactory} and clients can create these. -- *

-+ * - * A client can specify their own settings here and pass the {@link Cache} object - * into {@link CacheManager#addCache} to specify parameters other than the defaults. -- *

-+ * - * Only the CacheManager can initialise them. - * - * @param name the name of the cache. Note that "default" is a reserved name for the defaultCache. -@@ -985,7 +985,7 @@ - - /** - * Newly created caches do not have a {@link net.sf.ehcache.store.Store}. -- *

-+ * - * This method creates the store and makes the cache ready to accept elements - */ - public void initialise() { -@@ -1243,7 +1243,7 @@ - - /** - * The CacheWriterManager's initialisation can be deferred until an actual CacheWriter has been registered. -- *

-+ * - * This allows users to register a cache through XML in the cache manager and still specify the CacheWriter manually through Java code, possibly referencing local resources. - * - * @param imperative indicates whether it's imperative for the cache writer manager to be initialised before operations can continue -@@ -1324,17 +1324,17 @@ - - /** - * Put an element in the cache. -- *

-+ * - * Resets the access statistics on the element, which would be the case if it has previously been - * gotten from a cache, and is now being put back. -- *

-+ * - * Also notifies the CacheEventListener that: - *

-- *

-+ * - * Caches which use synchronous replication can throw RemoteCacheException here if the replication to the cluster fails. - * This exception should be caught in those circumstances. - * -@@ -1358,10 +1358,10 @@ - - /** - * Put an element in the cache. -- *

-+ * - * Resets the access statistics on the element, which would be the case if it has previously been - * gotten from a cache, and is now being put back. -- *

-+ * - * Also notifies the CacheEventListener that: - *

-- *

-+ * - * NOTE: null is a legal return here as well indicating that this attribute will not be available for the given element - * - * @param element the cache element to inspect -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/attribute/DynamicAttributesExtractor.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/attribute/DynamicAttributesExtractor.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/attribute/DynamicAttributesExtractor.java 2013-01-17 08:54:30.000000000 +0100 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/attribute/DynamicAttributesExtractor.java 2015-06-17 13:58:42.023921308 +0200 -@@ -26,7 +26,7 @@ - public interface DynamicAttributesExtractor { - /** - * Given a particular cache element, returns a map from attribute names, to their respective values to use for indexing. -- * This method will be called once for every {@link Ehcache#put(Element)} and {@link Ehcache#replace(Element)} call. -+ * This method will be called once for every Ehcache#put(Element) and Ehcache#replace(Element) call. - * @param element - * @return - */ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/expression/ILike.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/expression/ILike.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/expression/ILike.java 2012-10-04 02:59:11.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/expression/ILike.java 2015-06-17 15:01:53.924444466 +0200 -@@ -37,7 +37,7 @@ - * The supported wildcard characters can be escaped with a backslash '\', and a literal backslash can be included with '\\'
- *
- * WARN: Expressions starting with a leading wildcard character are potentially very expensive (ie. full scan) for indexed caches -- *

-+ * - * - * @author teck - */ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/expression/InCollection.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/expression/InCollection.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/expression/InCollection.java 2012-10-04 02:59:11.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/expression/InCollection.java 2015-06-17 13:50:53.231067370 +0200 -@@ -70,7 +70,7 @@ - /** - * Return values. - * -- * @return Collection values -+ * @return Collection<?> values - */ - public Collection values() { - return Collections.unmodifiableCollection(this.values); -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Query.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Query.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Query.java 2012-05-15 00:06:07.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Query.java 2015-06-17 13:46:57.553703645 +0200 -@@ -22,26 +22,26 @@ - - /** - * Creates queries for performing cache searches. -- *

-+ * - * Queries are created using our search DSL implemented using Java. -- *

-+ * - * A fluent interface provides a compact and yet easy-to-read representation. Fluent interfaces are implemented using method chaining. - * Static factory methods and imports are a great aid in creating a compact, yet readable DSL. -- *

-+ * - * Out API has the following features: -- *

-+ * - * Method Chaining - we return this. -- *

-- *

-+ * -+ * - * See http://www.infoq.com/articles/internal-dsls-java for a description of these conventions. -- *

-+ * - * A query can be executed and then modified and re-executed. If {@link #end} is called the query is made immutable. -- *

-+ * - * Both Element keys and attributes of Element can be queried. Attributes must be pre-defined for a cache. They are populated by extraction - * from an Element's value using an {@link net.sf.ehcache.search.attribute.AttributeExtractor} . -- *

-+ * - * Search results can either be Element keys (the default), values, or the result of an {@link Aggregator} function. -- *

-+ * - * A {@link Query} instance can be used by multiple threads - * - * @author teck -@@ -81,7 +81,7 @@ - * Request that the given attribute(s) should be present in the result for - * this query. This call can be made multiple times to add to the set of - * selected attributes. -- *

-+ * - * Note that in a distributed cache attributes may need to come over the network. To prevent very large network transfers, consider - * limiting the results size with {@link #maxResults(int)} or by using {@link Results#range} rathern than {@link Results#all()} - * -@@ -92,7 +92,7 @@ - - /** - * Request this query to aggregate the results by the given Aggregator(s) -- *

-+ * - * This method may be called multiple times to request multiple aggregations - * - * @param aggregators -@@ -124,7 +124,7 @@ - - /** - * Restrict the number of results returned from the search. -- *

-+ * - * By default an unlimited number of results can be returned. This could cause an OutOfMemoryError to be thrown. It is therefore - * recommended to add an maxResults clause to your query to limit the size. - * -@@ -141,7 +141,7 @@ - /** - * Execute this query. Every call to this method will re-execute the query - * and return a distinct results object. -- *

-+ * - * An empty results object will be returned (on timeout) for non-stop enabled caches with {@link net.sf.ehcache.config.TimeoutBehaviorConfiguration.TimeoutBehaviorType#NOOP} and - * {@link net.sf.ehcache.config.TimeoutBehaviorConfiguration.TimeoutBehaviorType#LOCAL_READS} behavior - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Result.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Result.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Result.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Result.java 2015-06-17 13:47:17.672710294 +0200 -@@ -20,7 +20,7 @@ - - /** - * Represents a single cache entry that has been selected by a cache query. -- *

-+ * - * - * @author teck - * @author Greg Luck -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Results.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Results.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/search/Results.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/search/Results.java 2015-06-17 13:46:39.566591736 +0200 -@@ -31,7 +31,7 @@ - * Discard this query result. This call is not mandatory but is recommended after - * the caller is done with results. It can allow the cache, which may be distributed, - * to immediately free any resources associated with this result. -- *

-+ * - * Multiple calls are ignored. Attempting to read results from this instance after this method has been called will produce - * {@link SearchException} - */ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/CacheUsageListener.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/CacheUsageListener.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/CacheUsageListener.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/CacheUsageListener.java 2015-06-17 12:20:22.080623264 +0200 -@@ -19,10 +19,10 @@ - * Interface for listeners to any change in usage statistics of an - * Ehcache. - * -- *

-+ * - * Implementations of this interface should implement the {@link Object#equals(Object)} and the {@link Object#hashCode()} as registering and - * removing listeners depends on these -- *

-+ * - * - * @author Abhishek Sanoujam - * @since 1.7 -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/LiveCacheStatistics.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/LiveCacheStatistics.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/LiveCacheStatistics.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/LiveCacheStatistics.java 2015-06-17 12:20:55.970021682 +0200 -@@ -18,11 +18,11 @@ - /** - * Interface for usage statistics of a Cache. - * -- *

-+ * - * Implementations of this interface is different from {@link net.sf.ehcache.Statistics} in the way that values returned from this interface - * implementations will reflect the current state of the cache and not a snapshot of the cache when the api's were called (which is the - * behavior of {@link net.sf.ehcache.Statistics}) -- *

-+ * - * - * @author Abhishek Sanoujam - * @since 1.7 -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/LiveCacheStatisticsWrapper.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/LiveCacheStatisticsWrapper.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/LiveCacheStatisticsWrapper.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/LiveCacheStatisticsWrapper.java 2015-06-17 12:22:22.091951640 +0200 -@@ -24,7 +24,7 @@ - * An implementation of {@link LiveCacheStatistics} and also implements {@link LiveCacheStatisticsData}. Uses separate delegates depending - * on whether - * statistics is enabled or not. -- *

-+ * - * To collect statistics element put/update/remove/expired data, instances of this class must be registered as a CacheEventListener to a - * Cache - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/NullSampledCacheStatistics.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/NullSampledCacheStatistics.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/NullSampledCacheStatistics.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/NullSampledCacheStatistics.java 2015-06-17 12:22:59.669175776 +0200 -@@ -21,7 +21,7 @@ - - /** - * A no-op implementation of {@link SampledCacheStatistics} -- *

-+ * - * - * @author Abhishek Sanoujam - * @since 1.7 -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsImpl.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsImpl.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsImpl.java 2012-10-16 20:29:13.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsImpl.java 2015-06-17 12:24:03.827143730 +0200 -@@ -35,7 +35,7 @@ - * the notification - * received from - * these to update the stats -- *

-+ * - * - * @author Abhishek Sanoujam - * @since 1.7 -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatistics.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatistics.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatistics.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatistics.java 2015-06-17 12:23:25.915935378 +0200 -@@ -18,7 +18,7 @@ - /** - * Interface for sampled usage statistics of a Cache - * -- *

-+ * - * - * @author Abhishek Sanoujam - * @since 1.7 -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsWrapper.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsWrapper.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsWrapper.java 2012-06-28 20:50:53.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/statistics/sampled/SampledCacheStatisticsWrapper.java 2015-06-17 13:59:30.073548918 +0200 -@@ -28,7 +28,7 @@ - * received from - * these to update the stats. Uses separate delegates depending on whether - * sampled statistics is enabled or not. -- *

-+ *

- * To collect statistics data, instances of this class should be registered as a {@link CacheUsageListener} to a Cache - * - * @author Abhishek Sanoujam -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Statistics.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Statistics.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Statistics.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Statistics.java 2015-06-17 11:47:03.743218711 +0200 -@@ -20,17 +20,17 @@ - - /** - * An immutable Cache statistics implementation -- *

-+ * - * This is like a value object, with the added ability to clear cache statistics on the cache. - * That ability does not survive any Serialization of this class. On deserialization the cache - * can be considered disconnected. -- *

-+ * - * The accuracy of these statistics are determined by the value of {@link Cache#getStatisticsAccuracy()} - * at the time the statistic was computed. This can be changed by setting {@link Cache#setStatisticsAccuracy}. -- *

-+ * - * Because this class maintains a reference to an Ehcache, any references held to this class will prevent the Ehcache - * from getting garbage collected. -- *

-+ * - * todo Add missCountExpired. Request from user. - * - * @author Greg Luck -@@ -222,28 +222,28 @@ - * this method will return three different values, depending on the statistics accuracy setting. - *

Best Effort Size

- * This result is returned when the statistics accuracy setting is {@link Statistics#STATISTICS_ACCURACY_BEST_EFFORT}. -- *

-+ * - * The size is the number of {@link Element}s in the {@link net.sf.ehcache.store.MemoryStore} plus - * the number of {@link Element}s in the {@link net.sf.ehcache.store.disk.DiskStore}. -- *

-+ * - * This number is the actual number of elements, including expired elements that have - * not been removed. Any duplicates between stores are accounted for. -- *

-+ * - * Expired elements are removed from the the memory store when - * getting an expired element, or when attempting to spool an expired element to - * disk. -- *

-+ * - * Expired elements are removed from the disk store when getting an expired element, - * or when the expiry thread runs, which is once every five minutes. -- *

-+ * - *

Guaranteed Accuracy Size

- * This result is returned when the statistics accuracy setting is {@link Statistics#STATISTICS_ACCURACY_GUARANTEED}. -- *

-+ * - * This method accounts for elements which might be expired or duplicated between stores. It take approximately - * 200ms per 1000 elements to execute. - *

Fast but non-accurate Size

- * This result is returned when the statistics accuracy setting is {@link #STATISTICS_ACCURACY_NONE}. -- *

-+ * - * The number given may contain expired elements. In addition if the DiskStore is used it may contain some double - * counting of elements. It takes 6ms for 1000 elements to execute. Time to execute is O(log n). 50,000 elements take - * 36ms. -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Status.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Status.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/Status.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/Status.java 2015-06-17 11:47:26.083145768 +0200 -@@ -20,7 +20,7 @@ - - /** - * A pre JDK1.5 compatible enum class to indicate the status of a {@link CacheManager} or {@link Cache}. -- *

-+ * - * ehcache historically used int values for status. This is unsuitable for third party use thus this class. - * Methods are provided to convert from the int status values to enum values and vice versa. - * -@@ -62,7 +62,7 @@ - * be a concise but informative representation that is easy for a - * person to read. - * It is recommended that all subclasses override this method. -- *

-+ * - * The toString method for class Object - * returns a string consisting of the name of the class of which the - * object is an instance, the at-sign character `@', and -@@ -102,7 +102,7 @@ - - /** - * Indicates whether some other object is "equal to" this one. -- *

-+ * - * The equals method implements an equivalence relation - * on non-null object references: - *

    -@@ -127,14 +127,14 @@ - *
  • For any non-null reference value x, - * x.equals(null) should return false. - *
-- *

-+ * - * The equals method for class Object implements - * the most discriminating possible equivalence relation on objects; - * that is, for any non-null reference values x and - * y, this method returns true if and only - * if x and y refer to the same object - * (x == y has the value true). -- *

-+ * - * Note that it is generally necessary to override the hashCode - * method whenever this method is overridden, so as to maintain the - * general contract for the hashCode method, which states -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/ImmutableValueElementCopyStrategy.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/ImmutableValueElementCopyStrategy.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/ImmutableValueElementCopyStrategy.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/ImmutableValueElementCopyStrategy.java 2015-06-17 12:16:46.856794541 +0200 -@@ -26,7 +26,7 @@ - private final ReadWriteSerializationCopyStrategy copyStrategy = new ReadWriteSerializationCopyStrategy(); - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForWrite(Element value) { - if (value == null) { -@@ -36,7 +36,7 @@ - } - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForRead(Element storedValue) { - if (storedValue == null) { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/ReadWriteSerializationCopyStrategy.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/ReadWriteSerializationCopyStrategy.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/ReadWriteSerializationCopyStrategy.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/ReadWriteSerializationCopyStrategy.java 2015-06-17 12:17:38.014376882 +0200 -@@ -34,7 +34,7 @@ - public class ReadWriteSerializationCopyStrategy implements ReadWriteCopyStrategy { - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForWrite(Element value) { - if (value == null) { -@@ -67,7 +67,7 @@ - } - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForRead(Element storedValue) { - if (storedValue == null) { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/SerializationCopyStrategy.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/SerializationCopyStrategy.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/compound/SerializationCopyStrategy.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/compound/SerializationCopyStrategy.java 2015-06-17 12:17:59.654354196 +0200 -@@ -29,14 +29,14 @@ - private final ReadWriteSerializationCopyStrategy copyStrategy = new ReadWriteSerializationCopyStrategy(); - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForWrite(Element value) { - return copyStrategy.copyForRead(copyStrategy.copyForWrite(value)); - } - - /** -- * @inheritDoc -+ * {@inheritDoc} - */ - public Element copyForRead(Element storedValue) { - return copyStrategy.copyForRead(copyStrategy.copyForWrite(storedValue)); -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/LegacyStoreWrapper.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/LegacyStoreWrapper.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/LegacyStoreWrapper.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/LegacyStoreWrapper.java 2015-06-17 12:09:13.217233124 +0200 -@@ -326,7 +326,7 @@ - - /** - * {@inheritDoc} -- *

-+ * - * The size is the number of {@link Element}s in the memory store - * plus the number of {@link Element}s in the disk store. - */ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/LruMemoryStore.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/LruMemoryStore.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/LruMemoryStore.java 2012-07-09 21:49:09.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/LruMemoryStore.java 2015-06-17 12:10:47.507777041 +0200 -@@ -40,7 +40,7 @@ - - /** - * An implementation of a LruMemoryStore. -- *

-+ * - * This uses {@link java.util.LinkedHashMap} as its backing map. It uses the {@link java.util.LinkedHashMap} LRU - * feature. LRU for this implementation means least recently accessed. - * -@@ -176,7 +176,7 @@ - - /** - * Gets an item from the cache. -- *

-+ * - * The last access time in {@link net.sf.ehcache.Element} is updated. - * - * @param key the cache key -@@ -275,7 +275,7 @@ - - /** - * Spools all elements to disk, in preparation for shutdown. -- *

-+ * - * This revised implementation is a little slower but avoids using increased memory during the method. - */ - protected final void spoolAllToDisk() { -@@ -303,7 +303,7 @@ - /** - * Puts the element in the DiskStore. - * Should only be called if isOverflowToDisk is true -- *

-+ * - * Relies on being called from a synchronized method - * - * @param element The Element -@@ -324,7 +324,7 @@ - - /** - * Gets an Array of the keys for all elements in the memory cache. -- *

-+ * - * Does not check for expired entries - * - * @return An Object[] -@@ -366,7 +366,7 @@ - - /** - * Measures the size of the memory store by using the sizeof engine. -- *

-+ * - * Warning: This method can be very expensive to run. Allow approximately 1 second - * per 1MB of entries. Running this method could create liveness problems - * because the object lock is held for a long period -@@ -393,7 +393,7 @@ - - /** - * Evict the Element. -- *

-+ * - * Evict means that the Element is: - *

    - *
  • if, the store is diskPersistent, the Element is spooled to the DiskStore -@@ -440,7 +440,7 @@ - - /** - * Expire all elsments. -- *

    -+ * - * This is a default implementation which does nothing. Expiry on demand is only - * implemented for disk stores. - */ -@@ -473,7 +473,7 @@ - /** - * An extension of LinkedHashMap which overrides {@link #removeEldestEntry} - * to persist cache entries to the auxiliary cache before they are removed. -- *

    -+ * - * This implementation also provides LRU by access order. - */ - public final class SpoolingLinkedHashMap extends java.util.LinkedHashMap { -@@ -522,7 +522,7 @@ - * with the opportunity to remove the eldest entry each time a new one - * is added. This is useful if the map represents a cache: it allows - * the map to reduce memory consumption by deleting stale entries. -- *

    -+ * - * Will return true if: - *

      - *
    1. the element has expired -@@ -539,7 +539,7 @@ - * inserted; in other words, if the map contains a single - * entry, the eldest entry is also the newest. - * @return true if the eldest entry should be removed -- * from the map; false if it should be retained. -+ * from the map; false if it should be retained. - */ - @Override - protected final boolean removeEldestEntry(Map.Entry eldest) { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/MemoryStore.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/MemoryStore.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/MemoryStore.java 2013-04-10 19:49:29.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/MemoryStore.java 2015-06-17 12:11:52.416709505 +0200 -@@ -290,7 +290,7 @@ - - /** - * Gets an item from the cache. -- *

      -+ * - * The last access time in {@link net.sf.ehcache.Element} is updated. - * - * @param key the key of the Element -@@ -390,7 +390,7 @@ - - /** - * Expire all elements. -- *

      -+ * - * This is a default implementation which does nothing. Expiration on demand is only implemented for disk stores. - */ - public void expireElements() { -@@ -462,7 +462,7 @@ - - /** - * Gets an Array of the keys for all elements in the memory cache. -- *

      -+ * - * Does not check for expired entries - * - * @return An List -@@ -610,7 +610,7 @@ - - /** - * Uses random numbers to sample the entire map. -- *

      -+ * - * This implemenation uses a key array. - * - * @param keyHint a key used as a hint indicating where the just added element is -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/Policy.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/Policy.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/Policy.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/Policy.java 2015-06-17 12:12:20.999358716 +0200 -@@ -20,7 +20,7 @@ - - /** - * An eviction policy. -- *

      -+ * - * The Cache will use a policy at startup. There are three policy implementations provided in ehcache: - * LRU, LFU and FIFO. However many other policies are possible. That the policy - * has access to the whole element enables policies based on the key, value, metadata, statistics, or a combination of -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/Store.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/Store.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/Store.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/Store.java 2015-06-17 12:08:12.564099534 +0200 -@@ -137,7 +137,7 @@ - - /** - * Remove all of the elements from the store. -- *

      -+ * - * If there are registered CacheEventListeners they are notified of the expiry or removal - * of the Element as each is removed. - */ -@@ -225,7 +225,7 @@ - - /** - * Gets the size of the in-memory portion of the store, in bytes. -- *

      -+ * - * This method may be expensive to run, depending on implementation. Implementers may choose to return - * an approximate size. - * -@@ -350,7 +350,7 @@ - - /** - * Returns true if the cache is in coherent mode cluster-wide. Returns false otherwise. -- *

      -+ * - * It applies to coherent clustering mechanisms only e.g. Terracotta - * - * @return true if the cache is in coherent mode cluster-wide, false otherwise -@@ -360,7 +360,7 @@ - - /** - * Returns true if the cache is in coherent mode for the current node. Returns false otherwise. -- *

      -+ * - * It applies to coherent clustering mechanisms only e.g. Terracotta - * - * @return true if the cache is in coherent mode cluster-wide, false otherwise -@@ -372,7 +372,7 @@ - * Sets the cache in coherent or incoherent mode for the current node depending on the parameter. - * Calling {@code setNodeCoherent(true)} when the cache is already in coherent mode or - * calling {@code setNodeCoherent(false)} when already in incoherent mode will be a no-op. -- *

      -+ * - * It applies to coherent clustering mechanisms only e.g. Terracotta - * - * @param coherent -@@ -385,7 +385,7 @@ - /** - * This method waits until the cache is in coherent mode in all the connected nodes. If the cache is already in coherent mode it returns - * immediately -- *

      -+ * - * It applies to coherent clustering mechanisms only e.g. Terracotta - * @throws UnsupportedOperationException if this store does not support cache coherence, like RMI replication - * @throws InterruptedException -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/TerracottaStore.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/TerracottaStore.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/store/TerracottaStore.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/store/TerracottaStore.java 2015-06-17 12:13:03.526348930 +0200 -@@ -32,7 +32,7 @@ - /** - * Returns the local value associated with the key. Local value means that the object mapped to the key is present in the VM locally. In - * case its not, will return null. Note that even when returning null, the value may be present in the Terracotta server array. -- *

      -+ * - * This operation does not acquire any locks when doing the operation and may return stale values. - * - * @param key -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/transaction/TransactionIDSerializedForm.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/transaction/TransactionIDSerializedForm.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/transaction/TransactionIDSerializedForm.java 2012-06-28 18:49:32.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/transaction/TransactionIDSerializedForm.java 2015-06-17 13:19:00.254013343 +0200 -@@ -23,7 +23,7 @@ - * A replacement serialized form for transaction IDs. It can be used by transaction ID factories - * to create IDs that serialize to this form (using writeReplace()) if they don't want or cannot - * provide directly serializable IDs. -- *

      -+ * - * During deserialization, objects of this class will be replaced by the result of the - * CacheManager.restoreTransactionID() call. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/transaction/XidTransactionIDSerializedForm.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/transaction/XidTransactionIDSerializedForm.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/transaction/XidTransactionIDSerializedForm.java 2012-06-28 18:49:32.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/transaction/XidTransactionIDSerializedForm.java 2015-06-17 13:19:16.684221074 +0200 -@@ -25,7 +25,7 @@ - * A replacement serialized form for XID transaction IDs. It can be used by transaction ID factories - * to create XID-based IDs that serialize to this form (using writeReplace()) if they don't want or - * cannot provide directly serializable IDs. -- *

      -+ * - * During deserialization, objects of this class will be replaced by the result of the - * CacheManager.restoreXidTransactionID() call. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/TransactionController.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/TransactionController.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/TransactionController.java 2012-06-28 18:49:32.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/TransactionController.java 2015-06-17 11:51:58.669037622 +0200 -@@ -70,7 +70,7 @@ - } - - /** -- * Set the default transaction timeout in seconds, it must be > 0 -+ * Set the default transaction timeout in seconds, it must be > 0 - * @param defaultTransactionTimeoutSeconds the default transaction timeout - */ - public void setDefaultTransactionTimeout(int defaultTransactionTimeoutSeconds) { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/FailSafeTimer.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/FailSafeTimer.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/FailSafeTimer.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/FailSafeTimer.java 2015-06-17 12:25:09.491041759 +0200 -@@ -26,7 +26,7 @@ - * scheduled will run at least once (inline when they are scheduled) if creating - * threads is not allowed. - * For example, Google App Engine does not allow creation of new threads. -- *

      -+ * - * Clients should not use this as a general purpose timing service. To do so could - * interfere with the running of the Cache. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/lang/VicariousThreadLocal.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/lang/VicariousThreadLocal.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/lang/VicariousThreadLocal.java 2011-05-19 14:04:15.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/lang/VicariousThreadLocal.java 2015-06-17 12:31:18.705663999 +0200 -@@ -23,7 +23,7 @@ - * A drop-in replacement {@code ThreadLocal} implementation that does not leak - * when thread-local values reference the {@code ThreadLocal} object. - * The code is optimised to cope with frequently changing values. -- *

      -+ * - * In comparison to plain {@code ThreadLocal}, this implementation:

        - *
      • from the point of view of a single thread, - * each thread-local -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/LargeCollection.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/LargeCollection.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/LargeCollection.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/LargeCollection.java 2015-06-17 12:26:44.286580034 +0200 -@@ -86,7 +86,7 @@ - - /** - * Iterator for addSet. -- * @return Iterator < E > -+ * @return Iterator < E > - */ - private Iterator < E > additionalIterator() { - return addSet.iterator(); -@@ -111,7 +111,7 @@ - - /** - * Iterator of initial set of entries. -- * @return Iterator < E > -+ * @return Iterator < E > - */ - public abstract Iterator < E > sourceIterator(); - -@@ -121,4 +121,4 @@ - */ - public abstract int sourceSize(); - --} -+} -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/ProductInfo.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/ProductInfo.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/ProductInfo.java 2012-09-11 20:01:31.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/ProductInfo.java 2015-06-17 12:28:15.366293201 +0200 -@@ -58,7 +58,7 @@ - * Construct product info object from a resource input stream - * - * @param resource -- * @throws java.io.IOException -+ * throws java.io.IOException - */ - public ProductInfo(InputStream resource) { - try { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/Timestamper.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/Timestamper.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/Timestamper.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/Timestamper.java 2015-06-17 12:29:39.238345610 +0200 -@@ -55,7 +55,7 @@ - * with some additional reserved space for a counter. - * - * @see net.sf.ehcache.util.Timestamper#BIN_DIGITS -- * @return uniquely & increasing value -+ * return uniquely & increasing value - */ - public static long next() { - int runs = 0; -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/TimeUtil.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/TimeUtil.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/util/TimeUtil.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/util/TimeUtil.java 2015-06-17 12:30:37.837587530 +0200 -@@ -52,7 +52,7 @@ - * Converts a long seconds value to an int seconds value and takes into account overflow - * from the downcast by switching to Integer.MAX_VALUE. - * @param seconds Long value -- * @return Same int value unless long > Integer.MAX_VALUE in which case MAX_VALUE is returned -+ * @return Same int value unless long > Integer.MAX_VALUE in which case MAX_VALUE is returned - */ - public static int convertTimeToInt(long seconds) { - if (seconds > Integer.MAX_VALUE) { -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/AbstractCacheWriter.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/AbstractCacheWriter.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/AbstractCacheWriter.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/AbstractCacheWriter.java 2015-06-17 14:32:15.546732210 +0200 -@@ -25,7 +25,7 @@ - - /** - * A convenience abstract base class that implements all {@code CacheWriter} methods. -- *

        -+ *

        - * The {@link #write}, {@link #writeAll}, {@link #delete} and {@link #deleteAll} methods throw - * {@code UnsupportedOperationException} unless they're overridden by the class that is extending - * {@code AbstractCacheWriter}. Classes that are extending this abstract base class should make sure that the -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriterFactory.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriterFactory.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriterFactory.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriterFactory.java 2015-06-17 14:32:38.913618929 +0200 -@@ -23,7 +23,7 @@ - /** - * An abstract factory for creating cache writers. Implementers should provide their own - * concrete factory extending this factory. -- *

        -+ *

        - * Note that Ehcache API also allows the CacheWriter to be set programmatically. - * - * @author Greg Luck -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriter.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriter.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriter.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriter.java 2015-06-17 14:31:39.624443676 +0200 -@@ -25,34 +25,34 @@ - - /** - * A CacheWriter is an interface used for write-through and write-behind caching to a underlying resource. -- *

        -+ *

        - * If configured for a cache, CacheWriter's methods will be called on a cache operation. A cache put will cause a CacheWriter write - * and a cache remove will cause a writer delete. -- *

        -+ *

        - * Implementers should create an implementation which handles storing and deleting to an underlying resource. -- *

        -- *

        Write-Through

        -+ *

        -+ *

        Write-Through

        - * In write-through mode, the cache operation will occur and the writer operation will occur before CacheEventListeners are notified. If - * the write operation fails an exception will be thrown. This can result in a cache which is inconsistent with the underlying resource. - * To avoid this, the cache and the underlying resource should be configured to participate in a transaction. In the event of a failure - * a rollback can return all components to a consistent state. -- *

        -- *

        Write-Behind

        -+ *

        -+ *

        Write-Behind

        - * In write-behind mode, writes are written to a write-behind queue. They are written by a separate execution thread in a configurable - * way. When used with Terracotta Server Array, the queue is highly available. In addition any node in the cluster may perform the - * write-behind operations. -- *

        -+ *

        - * It's important to note that the operations that are handled by the {@code CacheWriter} don't have any guaranteed ordering in write-behind mode. - * The processing ordering can be different than the scheduling ordering, so your application needs to be written with this - * in mind. More information in the CacheWriter chapter of the documentation. -- *

        -- *

        Creation and Configuration

        -+ *

        -+ *

        Creation and Configuration

        - * CacheWriters can be created using the CacheWriterFactory or explicitly by instantiating them through Java code, giving - * you access to local resources. -- *

        -+ *

        - * The manner upon which a CacheWriter is actually called is determined by the {@link net.sf.ehcache.config.CacheWriterConfiguration} that is set up for cache - * that is using the CacheWriter. -- *

        -+ *

        - * See the CacheWriter chapter in the documentation for more information on how to use writers. - * - * @author Greg Luck -@@ -64,7 +64,7 @@ - /** - * Creates a clone of this writer. This method will only be called by ehcache before a - * cache is initialized. -- *

        -+ *

        - * Implementations should throw CloneNotSupportedException if they do not support clone - * but that will stop them from being used with defaultCache. - * -@@ -76,12 +76,12 @@ - - /** - * Notifies writer to initialise themselves. -- *

        -+ *

        - * This method is called during the Cache's initialise method after it has changed it's - * status to alive. Cache operations are legal in this method. If you register a cache writer - * manually after a cache has been initialised already, this method will be called on the - * cache writer as soon as it has been registered. -- *

        -+ *

        - * Note that if you reuse cache writer instances or create a factory that returns the - * same cache writer instance as a singleton, your init method should be able - * to handle that situation. Unless you perform this multiple usage of a cache writer yourself, -@@ -95,7 +95,7 @@ - /** - * Providers may be doing all sorts of exotic things and need to be able to clean up on - * dispose. -- *

        -+ *

        - * Cache operations are illegal when this method is called. The cache itself is partly - * disposed when this method is called. - */ -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriterManager.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriterManager.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/CacheWriterManager.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/CacheWriterManager.java 2015-06-17 14:32:53.102942899 +0200 -@@ -22,7 +22,7 @@ - - /** - * A {@code CacheWriterManager} coordinates how element are written to a back-end store. -- *

        -+ *

        - * The {@code CacheWriterManager} will in its turn call the {@code CacheWriter} that belongs to the relevant cache to perform - * the actual write logic as it's implemented by the user. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperation.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperation.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperation.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperation.java 2015-06-17 14:33:36.994851732 +0200 -@@ -35,7 +35,7 @@ - - /** - * Creates a batch operation that corresponds to the operation type of this single operation. -- *

        -+ *

        - * This batch operation will not be stored in the queue anymore and is solely used for structuring. - * The data from the single operation will already be processed in the final form that will be expected by the - * {@code CacheWriter} that will be used to execute the batch operation. -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperationType.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperationType.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperationType.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/operations/SingleOperationType.java 2015-06-17 14:33:45.534444876 +0200 -@@ -17,7 +17,7 @@ - - /** - * Enum class to provide distinct operation types for each single operation. -- *

        -+ *

        - * The order of the entries in the enum is important since it is used to determine the order of execution of - * batched operations. - * -diff -Nru ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/WriteBehind.java ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/WriteBehind.java ---- ehcache-core-2.6.7/src/main/java/net/sf/ehcache/writer/writebehind/WriteBehind.java 2012-05-10 10:31:33.000000000 +0200 -+++ ehcache-core-2.6.7.javadoc/src/main/java/net/sf/ehcache/writer/writebehind/WriteBehind.java 2015-06-17 14:33:15.711865729 +0200 -@@ -58,7 +58,7 @@ - - /** - * Stop the coordinator and all the internal data structures. -- *

        -+ *

        - * This stops as quickly as possible without losing any previously added items. However, no guarantees are made - * towards the processing of these items. It's highly likely that items are still inside the internal data structures - * and not processed. diff --git a/ehcache-core.spec b/ehcache-core.spec index faae255..f279f07 100644 --- a/ehcache-core.spec +++ b/ehcache-core.spec @@ -1,6 +1,6 @@ Name: ehcache-core Version: 2.6.7 -Release: 8%{?dist} +Release: 9%{?dist} Summary: Easy Hibernate Cache License: ASL 2.0 URL: http://ehcache.org/ @@ -12,7 +12,6 @@ URL: http://ehcache.org/ # tar czf ehcache-core-2.6.7-clean-src-svn.tar.gz ehcache-core-2.6.7 Source0: %{name}-%{version}-clean-src-svn.tar.gz Patch0: %{name}-2.6.7-java8.patch -Patch1: %{name}-2.6.7-java8doc.patch BuildRequires: maven-local BuildRequires: mvn(javax.servlet:javax.servlet-api) @@ -59,7 +58,6 @@ This package contains javadoc for %{name}. %prep %setup -q %patch0 -p0 -%patch1 -p1 %pom_remove_plugin org.codehaus.gmaven:gmaven-plugin %pom_remove_plugin org.eclipse.m2e:lifecycle-mapping @@ -90,6 +88,9 @@ This package contains javadoc for %{name}. # disable embedded ehcache-sizeof-agent.jar copy %pom_remove_plugin :maven-dependency-plugin +# disable doclint in javadoc +%pom_remove_plugin :maven-javadoc-plugin + %mvn_file :%{name} %{name} %mvn_alias :%{name} net.sf.ehcache:ehcache @@ -108,6 +109,9 @@ This package contains javadoc for %{name}. %license src/assemble/EHCACHE-CORE-LICENSE.txt %changelog +* Thu Jun 18 2015 gil cattaneo 2.6.7-9 +- disable doclint in javadoc + * Wed Jun 17 2015 Fedora Release Engineering - 2.6.7-8 - Rebuilt for https://fedoraproject.org/wiki/Fedora_23_Mass_Rebuild