Debian Codegraph @

src/changes/changes.xml

raw
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <document>
3 <body>
4 <release version="2.6.0" date="2012-06" description="Major Release">
5 <action dev="" type="New Feature" issue="">
6 Fast Restartibility - Standalone Ehcache now has support for full fault tolerance using new Fast Restartability (from disk). This allows for continuous accessibility of previously cached data after a planned or unplanned shutdown.
7 </action>
8 <action dev="" type="New Feature" issue="">
9 Terracotta Managment Console for Ehcache - A new web-based monitoring and administration tool for standalone Ehcache applications. This replaces Ehcache Monitor and provides an enhanced user interface focused on ease of use in managing your Ehcache deployments.
10 </action>
11 </release>
12 <release version="2.6.1" date="2012-09" description="Supporting Release for BigMemory Go 3.7.1">
13 <action dev="" type="New Feature" issue="">
14 In-memory data storage - BigMemory Go comes with 32GB of free storage capacity per JVM
15 </action>
16 <action dev="" type="New Feature" issue="">
17 Fast Search - BigMemory Go provides powerful search APIs for searching in-memory data in a predictable manner with extremely low latencies.
18 </action>
19 </release>
20 <release version="2.6.2" date="2012-11" description="Bug Fix Release">
21 <action dev="" type="Bug Fix" issue="">
22 8308 - NPE on local transaction commit
23 8234 - Resolve issue with ConfigurationUtil.generateCacheManagerConfigurationText not producing nonstop element
24 8212 - Fix to handle a frequently empty object manager
25 8203 - Duplicate keys returned by method getKeys() of class Cache
26 EHC-976 - Search fails when copyOnRead and copyOnWrite are both set
27 EHC-973 - Failure while decoding key java.nio.HeapByteBuffer
28 EHC-962 - JavaDoc of Element.getValue() is wrong for non-Serializable values
29 </action>
30 </release>
31 <release version="2.6.3" date="2013-01" description="Bug Fix Release">
32 <action dev="" type="Bug Fix" issue="">
33 8194 - Write Behind config for writeBatchSize set w/o writeBatching enabled to true, gives no exception/warning that it's still not a BatchProcess enabled
34 </action>
35 </release>
36
37 <release version="2.5.2" date="2012-04" description="Bug Fix Release">
38 <action dev="" type="update" issue="EHC-898">
39 net.sf.ehcache.configurationResourceName is ignored
40 </action>
41 <action dev="" type="update" issue="EHC-905">
42 Eviction count always comes as zero
43 </action>
44 <action dev="" type="update" issue="EHC-909">
45 Can probably add the java.lang.Class type to the built-in ignore list
46 </action>
47 <action dev="" type="update" issue="EHC-918">
48 Transient attributes are not ignored in ObjectGraphWalker, causing Ehcache to not work with Groovy
49 </action>
50 <action dev="" type="update" issue="EHC-937">
51 Possible memory leak in xa_strict mode
52 </action>
53 </release>
54 <release version="2.5.1" date="2012-01" description="Bug Fix Release">
55 <action dev="Alex Snaps" type="update" issue="EHC-882">
56 Make @IgnoreSizeOf inheritable by users
57 </action>
58 <action dev="Chris Dennis" type="update" issue="EHC-900">
59 SizeOfPolicy cannot be set/add if TransactionManagerLookup was previously set/add
60 </action>
61 <action dev="Chris Dennis" type="update" issue="EHC-903">
62 Not release lock in SelectableConcurrentHashMap
63 </action>
64 <action dev="Chris Dennis" type="update" issue="EHC-909">
65 Can probably add the java.lang.Class type to the built-in ignore list
66 </action>
67 <action dev="Alex Snaps" type="update" issue="EHC-910">
68 Agent shouldn't put in System props by default
69 </action>
70 </release>
71 <release version="2.5.0" date="2011-11" description="New Release">
72 <action dev="Ludovic Orban" type="update" issue="EHC-849">
73 transactionalMode setting via code has no effect
74 </action>
75 <action dev="Ludovic Orban" type="update" issue="EHC-867">
76 Transactional cache with short TTI / TTL can provoke deadlocks
77 </action>
78 <action dev="Alex Snaps" type="update" issue="EHC-858">
79 ManagementService does not check for both class type of caches "Ehcache" and "Cache" which causes an NullPointerException if you attempt to use BlockingCache
80 </action>
81 <action dev="Alex Snaps" type="update" issue="EHC-440">
82 absolute memory configuration
83 </action>
84 <action dev="Chris Dennis" type="update" issue="EHC-868">
85 Misleading AssertionError in DiskPersistentStorageFactory.loadIndex
86 </action>
87 <action dev="Chris Dennis" type="update" issue="EHC-847">
88 Expose the Java property user.name for use in setting up the Disk Store
89 </action>
90 <action dev="Chris Dennis" type="update" issue="EHC-820">
91 Use region.contains() in ReadOnlyEhcacheEntityRegionAccessStrategy
92 </action>
93 <action dev="Hung Huynh" type="update" issue="EHC-856">
94 Ehcache core now compatible with Maven3
95 </action>
96 <action dev="James House" type="update" issue="EHC-837">
97 putIfAbsent does not work as intended with synchronous RMI distributed caches
98 </action>
99 </release>
100 <release version="2.4.6" date="2011-10" description="Bug fixes">
101 <action dev="Ludovic Orban" type="update" issue="EHC-852">
102 NotSerializableException when Ehcache tries overflow data to disk in XA Mode
103 </action>
104 <action dev="Tim Eck" type="update" issue="EHC-879">
105 ReadWriteSerializationCopyStrategy does not use TCCL for resolving classes
106 </action>
107 </release>
108 <release version="2.4.5" date="2011-08" description="Bug fixes">
109 <action dev="Raghvendra Singh" type="update" issue="6129">
110 NonStopCache causing application to hang when it is shutdown (normal shutdown not kill command)
111 </action>
112 <action dev="Ludovic Orban" type="update" issue="6157">
113 Cache.replace(oldElement, newElement) with local cache and big memory throws ClassCastException
114 </action>
115 </release>
116 <release version="2.4.4" date="2011-08" description="Bug fixes">
117 <action dev="Tim Eck" type="update" issue="CDV-1593">
118 Replicated cache events on TC clustered caches may not work in all configurations </action>
119 <action dev="James House" type="update" issue="5993">
120 Update default timeout in rejoin
121 </action>
122 </release>
123 <release version="2.4.3" date="2011-07" description="Bug fixes">
124 <action dev="Ludovic Orban" type="update" issue="EHC-853">
125 NotSerializableException when Ehcache tries overflow data to disk in XA Mode
126 </action>
127 <action dev="Alex Snaps" type="update" issue="EHC-853">
128 Timestamper.next() can loop a billion times or more
129 </action>
130 <action dev="Tim Eck" type="update" issue="EHC-846">
131 Give access to attribute name within the Extractor classes in search
132 </action>
133 <action dev="Tim Eck" type="update" issue="EHC-848">
134 Pass properties when constructing attribute extractors instances
135 </action>
136 </release>
137 <release version="2.4.2" date="2011-04" description="Bug fixes">
138 <action dev="Chris Dennis" type="fix" issue="EHC-845">
139 CompoundStore.putWithWriter doesn't follow contract regarding return value
140 </action>
141 </release>
142 <release version="2.4.1" date="2011-03-25" description="Bug fixes">
143 <action dev="Chris Dennis" type="fix" issue="EHC-840">
144 Disallow a cache from being configured for overflowToOffHeap and terracottaClustered
145 </action>
146 <action dev="Gary Keim" type="fix" issue="EHC-830">
147 JMX interface needs to translate InvalidConfigurationException throw by SampledCacheMBean.setCoherent(true) to plain RuntimeException
148 </action>
149 <action dev="Tim Eck" type="fix" issue="EHC-838">
150 Create improved toString method on ResultImpl
151 </action>
152 </release>
153 <release version="2.4.0" date="2011-02-15" description="Major release">
154 <action dev="Tim Eck" type="add">
155 Search. Caches can now be indexed and searched by key, value or attribute extracted from values.
156 This is a major new API and feature for Ehcache.
157 </action>
158 <action dev="Ludovic Orban" type="add">
159 Transactions support rework. Introduced 'local' and 'xa' modes, renamed old 'xa' mode into 'xa_strict'.
160 </action>
161 <action dev="Alex Snaps" type="fix" issue="EHC-773">
162 SelfPopulatingCache will always release the lock on failure during the CacheEntryFactory.createEntry
163 </action>
164 <action dev="Hung Huynh" type="add">
165 Update slf4j to 1.6.1
166 </action>
167 <action dev="Abhishek Sanoujam" type="add">
168 Add new consistency modes - strong and eventual. Deprecated old coherent settings ("true", "false")
169 for Terracotta distributed caches.
170 </action>
171 <action dev="Abhishek Sanoujam" type="add">
172 Add rejoin feature for Terracotta distributed caches.
173 </action>
174 <action dev="Abhishek Sanoujam" type="add">
175 Move nonstop functionality from a decorator to ehcache-core.
176 </action>
177 <action dev="Abhishek Sanoujam" type="add">
178 Add explicit-locking API to Ehcache.
179 </action>
180 </release>
181 <release version="2.3.2" date="2011-02-15" description="Bug fixes">
182 <action dev="Chris Dennis" type="fix" issue="EHC-805">
183 Blocking cache can create several StripedReadWriteLockSync
184 </action>
185 </release>
186 <release version="2.3.1" date="??" description="Bug fixes">
187 <action dev="Ludovic Orban" type="add">
188 Introduced ElementValueComparator to make element value comparison used in replace() and remove()
189 atomic methods pluggable.
190 </action>
191 </release>
192 <release version="2.3.0" date="2010-10-15" description="Major release with new features">
193 <action dev="Gary Keim" type="add">
194 Additional statistics that break out missNotFound into missInMemory, missOffHeap, and
195 missOnDisk.
196 </action>
197 <action dev="Chris Dennis" type="add">
198 Extend Ehcache existing in-memory and on-disk concepts to include off-heap as an additional
199 possible location.
200 </action>
201 <action dev="Chris Dennis" type="add">
202 Add the ability for store implementations to return a store specific MBean implementation
203 that is exposed in the same manner as the existing Ehcache MBeans.
204 </action>
205 <action dev="Chris Dennis" type="add" issue="EHC-778">
206 Restore support for the disk access stripes configuration property in the disk store
207 implementation.
208 </action>
209 <action dev="Greg Luck" type="fix">
210 EHC-740. Pick up "Read timed out" in RMI UnmarshalException.
211 </action>
212 <action dev="Greg Luck" type="fix">
213 Throw an InvalidConfigurationException when a cache is created from CacheConfiguration
214 without specifying a name.
215 </action>
216 <action dev="Greg Luck" type="update">
217 Add support for JMX registration of ManagedCacheManagerPeerProviders.
218 Thanks to Eric Dalquist for this contribution.
219 </action>
220 <action dev="Chris Dennis" type="fix" issue="EHC-754">
221 Fix MemoryEfficientByteArrayOutputStream to return a correctly sized byte array to prevent
222 network/disk wastage in ehcache-server/disk stores respectively.
223 </action>
224 <action dev="Ludovic Orban" type="add" issue="EHC-764">
225 Added timeout to cache.getWithLoader.
226 </action>
227 <action dev="Greg Luck" type="fix" issue="EHC-763">
228 Fix exception message to do with Element.getValue(). Thanks to Ken Dombeck for reporting this.
229 </action>
230 <action dev="Greg Luck" type="fix" issue="EHC-538">
231 Monitoring solutions (Ganglia, Advent Manage Engine, Hyperic) typically allow a JMX property
232 to be polled and graphs produced, using percentages. Add basic percentages for cache statistics.
233 </action>
234 <action dev="Abhishek Sanoujam" type="add" issue="EHC-729">
235 Added support for cacheDecorators in defaultCache.
236 </action>
237 <action dev="Abhishek Sanoujam" type="add">
238 Added support for cacheDecorators replacing the original cache when decorated cache has same name
239 as the cache. For use-cases like Hibernate where it helps to replace the original cache declared
240 in the config with the decorated cache. This can be used by making the CacheDecoratorFactory return
241 the decorated cache with same name as the cache.
242 </action>
243 </release>
244 <release version="2.2.1" date="2010-10-11" description="Bug fixes">
245 <action dev="Alex Snaps" date="2010-10-04" type="fix">
246 Ehcache evictor not clearing objects as expected
247 </action>
248 </release>
249 <release version="2.2.0" date="2010-07-16" description="Bug fixes">
250 <action dev="Geert Bevin" type="fix">
251 Renamed TerracottaConfigConfiguration to TerracottaClientConfiguration.
252 </action>
253 <action dev="Geert Bevin" type="fix" issue="EHC-736">
254 Creating a new cache manager ready to talk to terracotta is way too verbose
255 </action>
256 <action dev="Geert Bevin" type="fix" issue="EHC-742">
257 The CacheWriter init method is only called when it was declared through config since
258 that code triggers when the CacheManager inits the cache
259 </action>
260 <action dev="Geert Bevin" type="fix" issue="EHC-733">
261 Support getCurrentNode and waitUntilNodeJoins in Ehcache cluster API
262 </action>
263 <action dev="Abhishek Sanoujam" type="add">
264 Added new attribute "storageStrategy" for Terracotta Clustered Caches. This attribute is optional with default
265 value "classic". The other allowed value is "DCV2" and only available for enterprise users.
266 storageStrategy=DCV2 provides far greater scale and throughput.
267 </action>
268 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-713">
269 Cleaned up Configuration Generator, accessible using cacheManager.get[Active/Original]ConfigurationText method(s).
270 Can be used independently giving greater control over output format - indentation, newlines, suppressing
271 default values etc.
272 </action>
273 <action dev="Abhishek Sanoujam" type="fix">
274 Better exception message when adding a decorated cache/already initialized cache to CacheManager
275 </action>
276 <action dev="Abhishek Sanoujam" type="add">
277 Added new attribute "concurrency" for Terracotta Clustered Caches. Its a non-negative integer that can be used
278 to specify the number of segments that will be used by the map underneath the Terracotta Store. Its optional
279 and has default value of 0 - which means will use default values based on the internal Map being used
280 underneath the store (based on storageStrategy).
281 </action>
282 </release>
283
284 <release version="2.1.0" date="2010-05-19" description="Major release with new features">
285 <action dev="Geert Bevin" type="fix" issue="EHC-701">
286 closing a chache the WriteBehindManager attached to the queue does not by default finish flushing
287 </action>
288 <action dev="Geert Bevin" type="fix" issue="EHC-641">
289 Properly register MBeans for Terracotta clustered caches when they're added programmatically as the first
290 clustered caches for a cache manager.
291 </action>
292 <action dev="Abhishek Sanoujam" type="add">
293 Cache decorators can now be configured through config using "cacheDecoratorFactory" tag inside the "cache" tag.
294 </action>
295 <action dev="Fiona O'Shea" type="update" issue="EHC-693">
296 Ehcache 2.1.0 JTA support with Atomikos requires Atomikos 3.6.5.
297 </action>
298 <action dev="Greg Luck" type="update" issue="EHC-621">
299 A meaningful log message, rather than an NPE is emitted if you configure RMI replication without
300 configuring a net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory in ehcache.xml. This is
301 apparently a relatively common configuration error.
302 </action>
303 </release>
304
305 <release version="2.1.0-beta" date="2010-04-21" description="Beta for 2.1.0 a major release with new features">
306 <action dev="Chris Dennis" type="fix" issue="EHC-450">
307 Change the internal store structures to be fully coherent.
308 This allows for the addition of concurrent map like methods
309 (e.g. putIfAbsent) and also for JTA caching in unclustered
310 caches.
311 </action>
312 <action dev="Chris Dennis" type="update" issue="EHC-621">
313 Change the ehcache-core Hibernate dependency to the newly
314 released 3.5.0-Final.
315 </action>
316 <action dev="Chris Dennis" type="fix" issue="EHC-633">
317 Change CacheLockProvider lock method to support reentrant acquires.
318 Add a lock state query method, and update BlockingCache accordingly.
319 </action>
320 <action dev="Chris Dennis" type="change" issue="EHC-673">
321 Change caches to have statistics disabled by default.
322 </action>
323 <action dev="Chris Dennis" type="fix" issue="EHC-674">
324 Allow Elements in clustered caches to be serialized, and hence
325 enable replication of clustered caches.
326 </action>
327 <action dev="Alex Snaps" type="add" issue="EHC-668">
328 Caches can now be configured to be copyOnRead and copyOnWrite, with user provided copy strategy or the default
329 serialization one. Configuration on the Terracotta config is now deprecated...
330 </action>
331 <action dev="Alex Snaps" type="fix" issue="EHC-650">
332 XA transactional Caches now automatically set copyOnRead on terracotta clustered stores properly
333 </action>
334 <action dev="Alex Snaps" type="add" issue="EHC-628">
335 Actual copyOnRead and copyOnWrite implementation
336 </action>
337 <action dev="Chris Dennis, Alex Snaps" type="add" issue="EHC-368">
338 Added putIfAbsent(Element), replace(Element), replace(Element, Element) and removeElement(Element) methods to Cache
339 </action>
340 <action dev="Alex Snaps" type="add" issue="EHC-234">
341 Added addCacheIfAbsent method to CacheManager, implied removing races in managing Cache's and Ehcache's in
342 the CacheManager's implementation.
343 </action>
344 <action dev="Alex Snaps" type="add">
345 XA Transactional caches are now also supported with non clustered caches.
346 </action>
347 <action dev="Alex Snaps" type="fix">
348 Fixed issue to support BTM and Atomikos TransactionManager's suspend/resume cycles
349 </action>
350 <action dev="Alex Snaps" type="fix" issue="EHC-687">
351 Fixed NPE when no DefaultCache is provided at CacheManager's instantiation
352 </action>
353 <action dev="Alex Snaps" type="fix" issue="EHC-686">
354 Updated to latest slf4j 1.5.11
355 </action>
356 </release>
357 <release version="2.0.1" date="2010-04-05" description="Bug fixes">
358 <action dev="Geert Bevin" type="fix" issue="EHC-653">
359 RegisteredEventListeners.unregisterListener(CacheEventListener
360 cacheEventListener) throws java.lang.UnsupportedOperationException
361 </action>
362 <action dev="Chris Dennis" type="fix" issue="EHC-647">
363 Clustered Ehcache Hibernate caches are not set to minimalPut=true by default
364 </action>
365 <action dev="Ludovic Orban" type="fix" issue="EHC-658">
366 Interleaving txn not support in EhcacheXAResource when the TM is Atomiko
367 </action>
368 <action dev="Alex Snaps" type="fix" issue="EHC-657">
369 Fix JTA version system
370 </action>
371 <action dev="Alex Snaps" type="fix" issue="EHC-645">
372 JTA prepared transaction for which keys are to be inserted (previously
373 absent) aren't unlocked when rolled
374 </action>
375 <action dev="Alex Snaps" type="fix" issue="EHC-644">
376 Fix JTA Deadlock
377 </action>
378 <action dev="Alex Snaps" type="fix" issue="EHC-642">
379 EhcacheXAResourceImpl.equals is only based on Cache's name
380 </action>
381 <action dev="Greg Luck" type="fix" issue="EHC-665">
382 Default constructor for CacheConfiguration was removed in 2.0. Put back.
383 </action>
384 <action dev="Alex Snaps" type="fix" issue="EHC-660">
385 Enabled loading the Ehcache config file in EhCacheRegionFactory from an URL
386 </action>
387 </release>
388 <release version="2.0.0" date="2010-3-4"
389 description="Major release with new features">
390 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-625">
391 Changed Store.put() to return boolean instead of void. cache.put() can be
392 more efficient by relying
393 on this return value instead of doing a separate containsKey() check for
394 each cache.put().
395 </action>
396 <action dev="Geert Bevin" type="add" issue="EHC-632">
397 Added AbstractCacheWriter class for convenience.
398 </action>
399 <action dev="Geert Bevin" type="fix">
400 Changed delete and deleteAll CacheWriter methods to take a newly introduced
401 CacheEntry type that contains
402 a key and possibly the element that belongs to it.
403 </action>
404 <action dev="Geert Bevin" type="add">
405 Added support for cluster topology event listeners.
406 </action>
407 <action dev="Geert Bevin" type="add">
408 Added support for cluster topology information retrieval to Cache.
409 </action>
410 <action dev="Geert Bevin" type="add">
411 Added distributed cache events for clustered Terracotta caches through
412 TerracottaCacheEventReplicationFactory and
413 TerracottaCacheEventReplication.
414 </action>
415 <action dev="Geert Bevin" type="add">
416 Added support for local and remote filtering for the cache event listeners.
417 </action>
418 <action dev="Geert Bevin" type="add">
419 Implemented rate limiting support for write-behind.
420 </action>
421 <action dev="Geert Bevin" type="add">
422 Made batch operation type ordering predictable, ie. writes always happen
423 before deletes.
424 </action>
425 <action dev="Chris Dennis" type="add">
426 Added statistics cache attribute. If set to false, statistics overhead is
427 avoided
428 giving a significant performance improvement in standalone ehcache. By
429 default
430 statistics are on.
431 </action>
432 <action dev="Chris Dennis" type="fix" issue="EHC-419">
433 Fixed performance regression which occurred in 1.7.0 when sampling
434 statistics was added.
435 For maximum performance statistics can now be turned off in config and
436 during
437 cache construction.
438 </action>
439 <action dev="Chris Dennis" type="fix" issue="EHC-610">
440 Changed meaning of maxElementsInMemory=0 for MemoryStore to be unlimited.
441 This puts it
442 in-line with DiskStore and ClusteredStore. This also means that a cache
443 configuration
444 defining no in-memory capacity limit gets a functioning but unlimited
445 capacity cache.
446 This is not expected to cause practical problems because in previous
447 versions, when
448 0 meant 0, a warning was issued and performance was halved.
449 </action>
450 <action dev="Chris Dennis" type="add" issue="EHC-620">
451 Add necessary methods to make the Hibernate RegionFactory implementations
452 forward
453 compatible with the upcoming Hibernate 3.5 release.
454 </action>
455 <action dev="Chris Dennis" type="fix" issue="EHC-622">
456 Switch to using millisecond precision for access timestamps in unclustered
457 Ehcache elements.
458 </action>
459 <action dev="James Abley, Chris Dennis" type="fix" issue="EHC-537">
460 Modified DiskStore to be configurable to use multiple RandomAccessFile
461 instances to read
462 the data file. Reduced the scope of synchronization on reading from the
463 DiskStore.
464 </action>
465 <action dev="Alex Snaps" type="fix" issue="EHC-554">
466 Blocking now allows for concurrent reads on the same key (i.e. same striped
467 lock).
468 </action>
469 </release>
470
471 <release version="2.0.0-beta" date="2010-1-29"
472 description="Major release with new features">
473 <action dev="Geert Bevin" type="add">
474 Refactored Cache constructors to allow the use of a fluent interface instead
475 of a series of
476 constructor arguments. Existing constructors remain exactly the same for
477 backward compatibility.
478 </action>
479 <action dev="Geert Bevin" type="add">
480 Added support for CacheWriters with write-through and write-behind modes.
481 </action>
482 <action dev="Abhishek Sanoujam" type="add">
483 Added support for fast bulk-loading with incoherent mode when clustered with
484 Terracotta. Turning on
485 incoherent mode with cache.setCoherent(false) improves performance for bulk
486 loading.
487 </action>
488 <action dev="Abhishek Sanoujam" type="add">
489 New attribute for Terracotta clustered-caches, synchronousWrites=true|false
490 -- support for Terracotta's
491 Synchronous Write locking level in cache. Synchronous Write locking level
492 gives greater guarantees, but
493 comes at high cost in terms of scale/latency.
494 </action>
495 <action dev="Alex Snaps" type="add">
496 Added XA transaction, using JTA API. Configured through the
497 transactionalMode attribute of a cache in your
498 configuration xml file. Currently only supported on caches clustered using
499 Terracotta's serialized value mode.
500 </action>
501 <action dev="Chris Dennis" type="fix" issue="EHC-573">
502 Implemented correct cluster wide locking for Terracotta clustered Ehcache
503 Hibernate caches.
504 </action>
505 <action dev="Chris Dennis" type="add" issue="EHC-570">
506 Added dynamic configuration support for Terracotta clustered and unclustered
507 Ehcache instances. TTI, TTL,
508 and maximum in-memory and on-disk capacities can be modified at runtime by
509 accessing and mutating the Cache
510 object's CacheConfiguration.
511 </action>
512 <action dev="Chris Dennis" type="add" issue="EHC-560">
513 Added Hibernate 3.3+ API cache region factories supporting both singleton
514 and non-singleton cache managers.
515 The new API provides for concurrency improvements that were not possible
516 with the pre-3.3 provider API.
517 </action>
518 <action dev="Chris Dennis" type="add" issue="EHC-584">
519 Add support for all tim-distributed-cache configuration options to the
520 terracotta ehcache configuration element.
521 </action>
522 <action dev="Chris Dennis" type="fix" issue="EHC-569">
523 Rewrite of MemoryStore to prevent bugs whereby the parallel key data
524 structure became inconsistent with the
525 underlying map, and therefore caused errors during capacity eviction.
526 </action>
527 <action dev="Chris Dennis" type="fix" issue="EHC-576">
528 Disabled caches now return null on get rather than returning a potential
529 stale value. This is important now
530 that caches can be disabled at runtime when they may not be empty.
531 </action>
532 <action dev="Tim Eck" type="add">
533 Added "copyOnRead" setting for terracotta clustered caches. At a high level
534 this setting will return distinct
535 value objects upon every get() to a cache. The main driver for this feature
536 is to support caches that are
537 accessed by disparate OSGi bundles
538 </action>
539 </release>
540
541 <release version="1.7.2" date="2010-1-11" description="Maintenance and bug fixes">
542 <action dev="Chris Dennis" type="fix" issue="EHC-435">
543 Replaced single threaded use of StringBuffer with StringBuilder. Switched to
544 using
545 valueOf methods for creative primitive wrapper instances instead of new'ing
546 them.
547 </action>
548 <action dev="Chris Dennis" type="fix" issue="EHC-513">
549 Added a non-transient cache name field to the Statistics class so that cache
550 names
551 persist after passing through serialization.
552 </action>
553 <action dev="Alex Snaps" type="fix" issue="EHC-518">
554 Added the Exception causing the issue to the CacheException. The message now
555 includes the key,
556 rather than null.
557 </action>
558 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-549">
559 Made "stopped" variable volatile in
560 MulticastKeepaliveHeartbeatSender/Receiver to make it thread-safe
561 </action>
562 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-561">
563 Make ExecutorService's use custom ThreadFactory so that pool threads have
564 meaningful names.
565 </action>
566 <action dev="Greg Luck" type="fix" issue="EHC-434">
567 Use UUID rather than RMI's UID which does not work in GAE.
568 </action>
569 <action dev="Alex Snaps" type="add" issue="EHC-242">
570 Added CacheManager.clearAllStartingWith(String): void that clears all Caches
571 associated with the cache
572 manager, if the cache name matches the prefix profided
573 </action>
574 </release>
575
576 <release version="1.7.1" date="2009-11-30"
577 description="Maintenance and enablement of modularisation">
578
579 <action dev="Greg Luck" type="update">
580 Enable cache loaders to work with Google App Engine.
581 </action>
582 <action dev="Greg Luck" type="fix" issue="EHC-???">
583 Fixed Cache.toString() bug introduced in 1.7.0.
584 </action>
585 <action dev="Alex Miller" type="fix" issue="EHC-342">
586 Fixed ttl bug introduced in 1.7.0. TTL or TTI values &gt; Integer.MAX_VALUE
587 were incorrectly
588 downcast causing negative values. Most commonly, setting a TTI or TTL of
589 Long.MAX_VALUE
590 caused an exception to be thrown.
591 </action>
592 <action dev="Alex Miller" type="fix" issue="EHC-449">
593 Fixed memory visiblity issues with fields in MemoryStore. Made maximumSize
594 and useKeySample
595 final as they never change. Made status and policy volatile as they change
596 but weren't
597 guaranteeing visibility.
598 </action>
599 <action dev="Alex Miller" type="fix" issue="EHC-427">
600 Fixed a race that can cause an NPE when evicting with key samples during
601 put. This
602 can happen if there is a concurrent clear() that wipes the map as the
603 keyArray is
604 not updated under the same lock. This happens in tests a lot but is probably
605 less
606 common in actual user code.
607 </action>
608 <action dev="Chris Dennis" type="fix" issue="EHC-443">
609 Fixed a number of latent visibility bugs in the Cache class.
610 </action>
611 <action dev="Chris Dennis" type="fix" issue="EHC-445">
612 Fixed a number of latent visibility bugs in the Element class. Notably
613 updates to
614 the hitCount field are now coherent across multiple threads through the use
615 of an
616 AtomicLongFieldUpdater.
617 </action>
618 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-424">
619 Fixed bug to avoid any limit on the number of caches that can be configured
620 for replication.
621 Earlier there was a limit on the number of caches that can be configured for
622 replication as
623 the heartbeat size was exceeding the MTU when the number of caches were high
624 and/or the caches had
625 long names. Fixed to break up into multiple payloads in case the heartbeat
626 size exceeds the MTU.
627 </action>
628 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-446">
629 Fixed MemoryStore to use sufficient initial capacity for the internal
630 ConcurrentHashMap so that it
631 can accommodate the maximumSize of the store.
632 </action>
633 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-415">
634 Allow Terracotta clustered caches to be added programmatically even when the
635 CacheManager was created
636 initially without any Terracotta clustered caches. e.g. Adding a terracotta
637 clustered cache programmatically
638 to the default singleton CacheManager when there is no ehcache.xml present
639 in the classpath.
640 </action>
641 <action dev="Greg Luck" type="fix" issue="EHC-462">
642 cache.isKeyInCache(null) causes an NPE. Fixed.
643 </action>
644 <action dev="Greg Luck" type="fix" issue="EHC-437">
645 Fixed an issue with disk store when an abrupt JVM termination leaves a
646 persistent disk store
647 in a corrupt state. This problem was introduced in 1.6.
648 </action>
649 <action dev="Greg Luck" type="update" issue="EHC-544">
650 In Ehcache 1.6 the web package was broken out into the ehcache-web module.
651 However the ShutdownListener
652 is useful even if you are not using web caching - you use it to shutdown a
653 CacheManager in a web app,
654 when the servlet container shuts down. For that reason it should be in core.
655 Putting it back.
656 </action>
657 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-533">
658 Added null check to avoid NPE.
659 </action>
660 <action dev="Abhishek Sanoujam" type="fix" issue="EHC-556">
661 Fix for making ehcache work in Google App Engine runtime. JMX classes won't
662 be used when monitoring="off"
663 </action>
664 </release>
665
666
667 <release version="1.7.0" date="2009-10-5"
668 description="This is a beta release of Ehcache 1.7.">
669
670 <action dev="Greg Luck" type="update">
671 ehcache now becomes a composite modules which includes ehcache-core,
672 ehcache-terracotta
673 and may include other commonly used modules in the future like
674 ehcache-jcache.
675 </action>
676 <action dev="Terracotta Team" type="add">
677 ehcache-terracotta module, which provides seamless integration to the
678 Terracotta Server for
679 Terracotta based clustering.
680 </action>
681 <action dev="Terracotta Team" type="bug" issue="EHC-395">
682 Reduce iterator crossover from 100 to 5 to solve suspected CPU load issue in
683 small caches.
684 </action>
685 <action dev="Greg Luck" type="bug" issue="EHC-396">
686 Take puts into account for recent use in the eviction algorithms. Fixes an
687 algorithm regression from
688 1.5.
689 </action>
690 <action dev="Terracotta Team" type="bug" issue="EHC-357">
691 Statistics reporting incorrectly in Hibernate in 1.6.2.
692 </action>
693 <action dev="Greg Luck" type="update">
694 Replaced Mutex with higher concurrency strategy (ReadWriteLock based) for
695 both BlockingCache and
696 SelfPopulatingCache
697 </action>
698 </release>
699
700
701 <release version="1.6.2" date="2009-8-23"
702 description="This is a maintenance release to Ehcache 1.6.0">
703
704 <action dev="Greg Luck" type="remove">
705 Remove AsynchronousCommandExecutor. This is not used by anyone that I know
706 of and is obsolete
707 as j.u.c. provides a similar mechanism.
708 </action>
709 <action dev="Greg Luck" type="fix" issue="2840648">
710 1.6.1 cannot read older versions' persistent stores. Thanks to Matt Passell
711 for the patch.
712 </action>
713 <action dev="Greg Luck" type="fix" issue="2831089">
714 Fix retry serialize not working. Thanks to Vitaliy Garnashevich for the
715 patch.
716 </action>
717 <action dev="Greg Luck" type="fix" issue="2831182">
718 Fix statistics counters. Change them to AtomicLong as they now need to be
719 thread-safe to be accurate.
720 </action>
721 <action dev="Greg Luck" type="fix" issue="2831486">
722 Fix to 1.6 where clearOnFlush may now be false and were getting double
723 notification of a remove
724 or expiry if it happened after a flush. Thanks to both Kevin Conaway and
725 Jonathan Barbero.
726 </action>
727 <action dev="Greg Luck" type="update" issue="2831089">
728 Always close open files. Thanks to Vitaliy Garnashevich for the patch.
729 </action>
730 <action dev="Greg Luck" type="fix" issue="2835670">
731 Iterating through ALL_CACHE_MANAGERS sometimes causes
732 ArrayOutOfBoundsException. Bug introduced
733 in 1.6. Fixed. Thanks to Chris Hyzer for reporting.
734 </action>
735 <action dev="Greg Luck" type="update" issue="2830920">
736 Current implementation stops after at least one loader loaded at least one
737 Element. This patch continues to poll other loaders if more keys left to
738 load. Thanks to Vitaliy Garnashevich for the patch.
739 </action>
740 </release>
741
742
743 <release version="1.6.1" date="2009-7-27"
744 description="This is a maintenance release to Ehcache 1.6.0.">
745
746 <action dev="Greg Luck" type="fix">
747 Fixed ConcurrentModificationException when using DiskStore. This issue would
748 log an exception
749 and those elements waiting to be spooled would be discarded. The DiskStore
750 and cache would
751 continue to run unaffected. 1.6 issue.
752 </action>
753 <action dev="Greg Luck" type="fix">
754 Fixed regression in 1.6.0. When an Element is not Serializable, but it's key
755 is, then replications
756 via invalidate should still work as only the key needs to be Serializable.
757 1.6 issue.
758 </action>
759 <action dev="Greg Luck" type="update">
760 Clarified and made consistent removeQuiet and getQuiet. Both do not update
761 statistics nor call
762 listeners.
763 </action>
764 <action dev="Greg Luck" type="update">
765 Allow the network interface to be specified on multi-homed machines for
766 MulticastRMICacheManagerPeerProvider.
767 This can now be done by specifying hostName=&lt;hostname or IP of network
768 interface&gt; in the
769 properties.
770 The default interface is used if this is not specified as it has been in
771 past versions.
772 </action>
773 <action dev="Greg Luck" type="fix" issue="2823211">
774 Improved incrementer in MemoryStore to avoid rare overwrites in the key
775 sampling. Thanks to
776 Michael Maraist for this fix. 1.6 issue.
777 </action>
778 <action dev="Greg Luck" type="fix" issue="2823281">
779 Improve performance of memory store eviction.
780 </action>
781 <action dev="Greg Luck" type="add">
782 Delete directories that were created with auto_created which are meant for
783 one time only use.
784 </action>
785 <action dev="Greg Luck" type="fix" issue="2824181">
786 Fix consistency problem where, with very fast updates to a Cache, gets were
787 returning old versions.
788 Thanks to Marcin Sciesinski for a very clear test case which showed the
789 issue.
790 </action>
791 </release>
792
793 <release version="1.6.0" date="2009-6-17"
794 description="This release introduces a new high performance cache core, which is two orders of magnitude faster.">
795
796 <action dev="Greg Luck" type="add">
797 Added compatibility for Google App Engine. To get started read
798 http://ehcache.sourceforge.net/documentation/googleappengine.html for more
799 details.
800 </action>
801 <action dev="Greg Luck" type="update">
802 Removed slf4j, which was causing ClassNotFoundException for some users.
803 You can still log via SL4J using the SLF4JBridgeHandler. See
804 {{http://www.slf4j.org/legacy.html}}
805 See the http://ehcache.sourceforge.net/documentation/logging.html for more
806 details.
807 </action>
808 </release>
809
810
811 <release version="1.6.0-rc1" date="2009-6-12"
812 description="This release introduces a new high performance cache core, which is two orders of magnitude faster.">
813 <action dev="Greg Luck" type="fix">
814 Preserve \ and $ when in ehcache.xml.
815 </action>
816 <action dev="Greg Luck" type="fix" issue="2791732">
817 Fix to an issue introduced in 1.6.0-beta5.
818 It was possible for the probabilistic eviction algorithm to return null,
819 which could cause a slow
820 memory leak. Fixed. If this happens on an eviction we do a further selection
821 via iteration
822 which is guaranteed not to return null.
823 </action>
824 <action dev="Greg Luck" type="fix" issue="2804387">
825 Fix Bug in RMIAsynchronousCacheReplicator.clone introduced in the 1.6 beta
826 series.
827 </action>
828 <action dev="Greg Luck" type="fix" issue="2790350">
829 UpdatingSelfPopulatingCache had not been converted to work with
830 non-Serializable objects. Fixed.
831 </action>
832 <action dev="Greg Luck" type="fix" issue="2008055">
833 Fixed rare ConcurrentModificationException when calling cache.flush() to
834 persist to the disk store
835 during cache operation. cache.flush() is now asynchronous as a result.
836 </action>
837 <action dev="Greg Luck" type="add">
838 added clearOnFlush cache parameter. It determines whether the MemoryStore
839 should be cleared when flush()
840 is called on the cache. By default, the MemoryStore is cleared. Useful is
841 you want to back up a cache
842 to the file system without clearing the MemoryStore. Thanks to Matt Passell
843 for the patch.
844 </action>
845 <action dev="Greg Luck" type="update">
846 / used to be an illegal character in ehcache cache names. However JBoss 5
847 uses / in its JPA cache names.
848 / is now a legal character so as to interoperate with JBoss 5.
849 </action>
850 <action dev="Greg Luck" type="update">
851 Brought back the LruMemoryStore from ehcache-1.5 and prior. This can be
852 switched in for LRU eviction
853 algorithm cache using set java -Dnet.sf.ehcache.use.classic.lru=true
854 By default the new, high performance MemoryStore is used for all eviction
855 algorithms.
856 </action>
857 <action dev="Greg Luck" type="update">
858 Added slf4j, replacing java.util.logging. I succumbed to the logic that a
859 library should use an abstract
860 logging interface. This _may_ be replaced by configurable logging in
861 ehcache.xml, which will then
862 remove the dependency on sl4j while still permitting its and other logging
863 frameworks use.
864 </action>
865 </release>
866
867
868 <release version="1.6.0-beta5" date="2009-5-10"
869 description="This release introduces new high perforamnce cache core, which is two orders of magnitude faster.">
870 <action dev="Greg Luck" type="add">
871 Make MemoryStore eviction policies injectable.
872 </action>
873 <action dev="Greg Luck" type="fix" issue="2740073">
874 Fix NPE on cache operations during cache.dispose();
875 </action>
876 <action dev="Greg Luck" type="fix" issue="2750578">
877 Fix DiskStore recovery after dirty shutdown bug introduced in beta4.
878 </action>
879 <action dev="Greg Luck" type="fix">
880 Fix MemoryStore concurrency issue introduced in beta4.
881 </action>
882 </release>
883
884 <release version="1.6.0-beta4" date="2009-4-7"
885 description="This release introduces new high perforamnce cache core, which is two orders of magnitude
886 faster.">
887
888 <!-- Feature Changes -->
889 <action dev="Greg Luck" type="update">
890 Remove many uses of synchronize and replace with new concurrency techniques
891 available in Java 5.
892 A concurrent test with 70 threads doing a realistic mix of operations gets
893 are 92.5 times faster,
894 puts are 30 times faster, removes are 48 times faster, removeAlls are 80
895 times faster,
896 and keySet is 30 times faster.
897 </action>
898
899 <action dev="Greg Luck" type="add" issue="2684466">
900 Add replicatePutsViaCopy to the RMI replicator. This determines whether the
901 new elements are
902 copied to other caches (true), or whether a remove message is sent. Defaults
903 to true.
904
905 A replicateUpdatesViaCopy property was already there.
906
907 With these two properties, fine-grained control is available to ensure
908 distributed cache
909 coherency is maintained.
910 </action>
911 <action dev="Greg Luck" type="update" issue="2003322">
912 Don't automatically delete the DiskStore index on startup.
913 </action>
914
915 <!-- Bug Fixes -->
916 <action dev="Greg Luck" type="fix" issue="2540579">
917 Fix documentation: missing parentheses from samples.html.
918 </action>
919 <action dev="Greg Luck" type="fix" issue="2026586">
920 The isSerializable() method on Element was too narrowly defined. Adjusted to
921 allow Elements with
922 null values to be Serialized. This change affects DiskStore and replication.
923 Null objects of any class will serialize. Also recorded as 2153609.
924 </action>
925 <action dev="Greg Luck" type="fix" issue="2018964">
926 Made the synchronous RMI replicator log exceptions as SEVERE rather than
927 throwing them, to make this
928 consistent with the asynchronous replicator. The change means that you
929 cannot detect that replication
930 has not occured to a given peer. Given that we are not transactional, this
931 probably does not matter.
932 </action>
933 <action dev="Greg Luck" type="fix" issue="2725134">
934 Notifications happening on removeQuiet when they should not.
935 </action>
936 <action dev="Greg Luck" type="fix" issue="2492568">
937 Extra logging around RMICachePeer. Add the cacheName to the FINE log output.
938 </action>
939 <action dev="Greg Luck" type="fix" issue="2584798">
940 Added support for UTF8 file encoding of ehcache.xml. This makes it possible
941 to specify cache names
942 in non Western languages.
943 </action>
944 <action dev="Greg Luck" type="fix" issue="2035287">
945 Updated provided scope dependency of Hibernate to 3.2.6GA to pick up a
946 signature change in
947 CacheException to Throwable.
948 </action>
949
950 </release>
951
952 <release version="1.6.0-beta3" date="2009-1-28"
953 description="This release breaks JCache into its own ehcache-jcache module and removes all
954 dependencies other than the JDK.">
955
956 <!-- Feature Changes -->
957 <action dev="Greg Luck" type="update">
958 Remove all of JSR107 JCACHE into its own module called ehcache-jcache, which
959 will have its own
960 release cycle. The jsr107cache dependency is thus no longer required.
961 </action>
962 </release>
963 <release version="1.6.0-beta2" date="2008-12-24"
964 description="The focus of this release is enabling multiple replication schemes in the same configuration.">
965
966 <!-- Feature Changes -->
967 <action dev="Greg Luck" type="update">
968 Allow multiple replication schemes to be used within the same CacheManager.
969 i.e. use JMS for some
970 caches and RMI for others.
971 </action>
972 <action dev="Greg Luck" type="add">
973 Add a reference to Ehcache from CacheStatistics. Request 2128129
974 </action>
975 <action dev="Greg Luck" type="add">
976 Add FINE level LOG statement for Hibernate EhCache provider puts. This
977 enables puts to be debugged
978 with LOG statement. Request 2061030.
979 </action>
980 <action dev="Greg Luck" type="update">
981 Removed cacheManager.getCachePeerProvider() in favour of
982 cacheManager.getCacheManagerPeerProvider("scheme")
983 where scheme is the replication scheme. Each replicator type can then call
984 its own scheme provider,
985 allowing multiple replication schemes to be used within the same
986 CacheManager.
987 </action>
988 </release>
989 <release version="1.6.0-beta1" date="2008-10-19"
990 description="The 1.6 release is a cleanup release which sets the foundation for future development.
991 It updates the required Java version to 1.5, removes consequently redundant libraries and
992 removes long deprecated methods. It also fine tunes some of the newer API behaviours.">
993
994 <!-- Feature Changes -->
995 <action dev="Greg Luck" type="remove">
996 Removed commons-collections. The LRUHashMap was only being used by early
997 versions of Terracotta
998 integration
999 and is not longer required to support Terracotta.
1000 </action>
1001 <action dev="Greg Luck" type="remove" issue="1987750">
1002 Removed dependency on backport concurrent. java.util.concurrency is now
1003 used.
1004 </action>
1005 <action dev="Greg Luck" type="remove">
1006 Removed dependency on commons-logging. Ehcache now uses java.util.logging at
1007 the request of many users.
1008 </action>
1009 <action dev="Greg Luck" type="update">
1010 Java 1.5 is now the minimum version for ehcache 1.6. Java 1.4 will continue
1011 to be supported on the
1012 ehcache
1013 1.5 branch. Ehcache can reduce its dependency list for the core and
1014 therefore occupy a smaller footprint
1015 in new applications.
1016 </action>
1017 <action dev="Greg Luck" type="update">
1018 Add the ability for the MBean classes to be used in remote JMX clients, in
1019 addition to the current
1020 mechanism which uses standard JDK types. The ehcache classpath
1021 should be added to the client for this to work. e.g. jconsole
1022 -J-Djava.class.path=ehcache.jar
1023 </action>
1024 <action dev="Greg Luck" type="update">
1025 Due to requests for more sophisticated features and end user experience with
1026 the CacheLoader interface
1027 the following changes have been made:
1028
1029 - A Cache may now have a list of CacheLoaders. If the first loader returns
1030 null, the next in the list
1031 is attempted until a non-null result occurs or the chain of loaders ends.
1032 - If a loader does not load, no element is put in the cache, rather than an
1033 element with a null value.
1034 This is more consistent with the rest of the API anyway and has been
1035 requested by users.
1036 - Loaders now have a maxLoadTimeMillis property which sets the maximum
1037 amount of time for the loader
1038 to wait for the load.
1039 - To support sophisticated loaders like the JMSCacheLoader, the CacheLoader
1040 interface adds lifecycle
1041 methods, so that it can be bound into a cache's lifecyle. Also there is a
1042 new factory method for loaders
1043 to bring them into line with extensions such that a back-reference to the
1044 owning Cache is injected
1045 at configuration time.
1046
1047 The upshot of these changes is that implementers of CacheLoader will need to
1048 update their
1049 implementations
1050 for these changes.
1051
1052 The setter and getter for CacheLoader has been removed because it now a
1053 list, not a scalar.
1054 New registerCacheLoader and unregisterCacheLoader methods have been added
1055 for programmatic
1056 configuration.
1057 The getCacheLoader method has been removed.
1058 </action>
1059 <action dev="Greg Luck" type="remove">
1060 Cache configuration individual methods have been deprecated for several
1061 years. In this version, the
1062 deprecated methods are removed. Use cache.getCacheConfiguration() to get the
1063 configuration object
1064 and then get individual properties.
1065 </action>
1066 <action dev="Greg Luck" type="remove">
1067 Cache statistics individual methods have been deprecated for several years.
1068 In this version, the
1069 deprecated methods are removed. Use cache.getStatistics() to get the
1070 Statistics object
1071 and then get individual statistics.
1072 </action>
1073 </release>
1074
1075
1076 <release version="1.5.0" date="2008-07-12" description="1.5.0 Maintenance release">
1077 <!--Bug Fixes-->
1078 <action dev="Greg Luck" type="fix" issue="1977481">
1079 Fix loading of net.sf.ehcache.hibernate.EhCacheProvider from multiple class
1080 loaders. The insistence
1081 that a leading slash be at the front of the
1082 "net.sf.ehcache.configurationResourceName" property has been
1083 removed.
1084 If this fix causes anyone an issue, add the "/" to the front of your path.
1085 </action>
1086 <action dev="Greg Luck" type="fix" issue="1990091">
1087 Updated the BlockingCache.get() JavaDoc to clarify the contract when a
1088 RuntimeException is thrown.
1089 </action>
1090 <action dev="Greg Luck" type="fix" issue="2002319">
1091 Added a more meaningful LOG message when a null element is encountered from
1092 a replication. The only
1093 reason
1094 that an element can be null is because a SoftRefernence has been reclaimed
1095 by the JVM. The log message
1096 recommends either increasing heap or setting -Xms to be the same as -Xmx as
1097 the Sun JDK will reclaim
1098 SoftReferences
1099 in preference to increasing heap.
1100 </action>
1101 <!--Changes-->
1102 <action dev="Greg Luck" type="update">
1103 The remote debugger has had many improvements. It is now packaged in its own
1104 tarball available from the
1105 downloads
1106 page, and also continues to be published as a maven module. It is not in the
1107 core tarball so that more
1108 focus
1109 can be given to it.
1110 </action>
1111 </release>
1112 <release version="1.5.0-beta2" date="2008-06-7"
1113 description="Second beta of 1.5.0 Maintenance release">
1114 <!--Bug Fixes-->
1115 <action dev="Greg Luck" type="fix">
1116 Fixes to changes made in 1.5.0-beta1: token replacement in ehcache.xml
1117 parsing and Cache.get() not
1118 searching
1119 the DiskStore.
1120 </action>
1121 </release>
1122 <release version="1.5.0-beta1" date="2008-05-13" description="Maintenance release">
1123 <!-- Features and Enhancements -->
1124 <action dev="Greg Luck" type="add" issue="1730405">
1125 Added JGroups Implementation. Thanks to Pierre Monestie for the patch(es)
1126 for this. Though new to the
1127 core distribution
1128 JGroups replication has been in production use in a large cluster for the
1129 last 10 months.
1130 Applied through patches 1730405 and 1912931.
1131 </action>
1132 <action dev="Greg Luck" type="update" issue="1812267">
1133 CachingFilter changed to use BufferedOutputStream rather than OutputStream.
1134 This is a performance
1135 improvement.
1136 Thanks to Vitaly Baranovsky for the patch.
1137 </action>
1138 <action dev="Greg Luck" type="update" issue="1748591">
1139 Removed setThreadName usage to increase performance.
1140 </action>
1141 <action dev="Greg Luck" type="add" issue="1795131">
1142 JCache interface improvement. if we want preload for this cache, and we
1143 probably don't know all
1144 the keys at the system startup time. We may want to have new interface:
1145 loadAll()
1146 This will not be added to ehcache until it gets added to the JCACHE spec.
1147 </action>
1148 <action dev="Greg Luck" type="update" issue="1795131">
1149 Clarified JavaDoc and behaviour so that Cache.getQuiet does not update
1150 Element statistics but also
1151 cache statistics.
1152 </action>
1153 <action dev="Greg Luck" type="update" issue="1909427">
1154 Enhanced behaviour of diskPersistent so that it will work for MemoryStore
1155 only caches. On shutdown
1156 the memory store will be written to disk and on startup loaded up into
1157 memory. But DiskStore itself
1158 will not be used during cache operation.
1159 </action>
1160 <action dev="Greg Luck" type="update" issue="1728061">
1161 The diskStore element in ehcache.xml is now optional. If all caches use only
1162 MemoryStores, then
1163 there is no need to worry about configuring diskStore. This will simplify
1164 configurations particularly
1165 where multiple CacheManagers are being used.
1166
1167 If one or more caches requires a DiskStore, and none is configured,
1168 java.io.tmpdir will be used and
1169 a warning message will be logged to encourage explicity configuration of the
1170 diskStore path.
1171
1172 Thanks to Robert Watkins for suggesting this one.
1173 </action>
1174 <action dev="Greg Luck" type="add" issue="1887683">
1175 By default RMI will assign a random listener port to a new Remote object
1176 which prevents its operation
1177 through firewalls. Added a new property remoteListenerPort to
1178 RMICacheManagerPeerListenerFactory
1179 to enable it to be specified.
1180 </action>
1181 <action dev="Greg Luck" type="add" issue="1958670">
1182 Made ManagementService accessible from IoC containers by providing a
1183 constructor.
1184 </action>
1185 <action dev="Greg Luck" type="add" issue="1898239">
1186 Added a new system property expansion token "ehcache.disk.store.dir" to
1187 DiskStore configuration which
1188 can be
1189 used to specify the DiskStore directory on the command line or in an
1190 environment variable.
1191
1192 e.g. java -Dehcache.disk.store.dir=/u01/myapp/diskdir ...
1193
1194 Thanks to Brian Chan and others for suggesting this one.
1195 </action>
1196 <action dev="Greg Luck" type="add" issue="1743082">
1197 Add the ability to specify system property tokens using ${tokenname} in
1198 ehcache.xml which are then
1199 replaced when the
1200 configuration is loaded.
1201 </action>
1202 <action dev="Greg Luck" type="update" issue="1912953">
1203 Updated the remote debugger with enhanced reporting and better documentation
1204 (See Logging page in
1205 the documentation).
1206
1207 The new version prints a list of caches with replication configured, prints
1208 notifications as they
1209 happen, and periodically prints the cache name, size and total events
1210 received.
1211 </action>
1212
1213
1214 <!--Bug Fixes-->
1215 <action dev="Greg Luck" type="fix" issue="812270">
1216 SimplePageCachingFilter returns same content for GET and HEAD. This one is
1217 an edge case that can happen.
1218 Thanks to Vitaly Baranovsky for the patch.
1219 </action>
1220 <action dev="Greg Luck" type="fix" issue="1890915">
1221 Change CachingFilter to use setHeader rather than addHeader which was
1222 duplicating some headers.
1223 </action>
1224 <action dev="Greg Luck" type="fix" issue="1936731">
1225 Updated the JavaDoc to clarify the meaning of the constant SHORT_DELAY.
1226 </action>
1227 <action dev="Greg Luck" type="fix" issue="1888993">
1228 Fixed inefficient shutdown of cache when the cache is not diskPersistent.
1229 </action>
1230 <action dev="Greg Luck" type="fix" issue="1938744">
1231 Corrected ehcache.xsd so that minOccurs of cache can be 0. This makes
1232 ehcache-default.xml legal.
1233 Thanks to Andreas Sahlbach for reporting this.
1234 </action>
1235 <action dev="Greg Luck" type="fix" issue="1901094">
1236 Fixed Cache destroy exception where Hibernate and Spring are both shutting
1237 down during
1238 undeploying application.
1239 </action>
1240
1241 </release>
1242
1243 <release version="1.4.1" date="2008-02-21" description="Maintenance release">
1244 <!--Bug Fixes-->
1245 <action dev="Greg Luck" type="fix" issue="1895147">
1246 ehcache-failsafe.xml was not being included in the maven package. Moved it
1247 to resources so that now it
1248 is.
1249 </action>
1250 <action dev="Greg Luck" type="fix" issue="1831823">
1251 JCache.getAll wraps values in Element. One place was missed in the fix for
1252 this in 1.4.0. Now all
1253 correct.
1254 </action>
1255 <action dev="Greg Luck" type="fix" issue="1887638">
1256 Fixed error in Cache.remove/Ehcache.remove JavaDoc
1257 </action>
1258 </release>
1259
1260
1261 <release version="1.4.0" date="2008-1-31" description="1.4 release">
1262 <!--Bug Fixes-->
1263 <action dev="Greg Luck" type="fix" issue="1819841">
1264 Update backport-concurrent version to 3.1. This version is available for all
1265 versions of Java including
1266 6.
1267 </action>
1268 <action dev="Greg Luck" type="fix" issue="1880042">
1269 Tuned a few unit tests use of Thread.sleep due to the Windows timing service
1270 of inaccurate aperture.
1271 Some tests that used an added 10ms to allow for Windows now allow for 20ms,
1272 based on research published
1273 in this bug report.
1274 </action>
1275 <action dev="Greg Luck" type="fix" issue="1880042">
1276 Removed one last thread renaming method. The others were removed in 1831446.
1277 Thanks to Diogo Quintela
1278 for pointing this out.
1279 </action>
1280 </release>
1281
1282 <release version="1.4.0-beta2" date="2008-01-01" description="1.4.0 beta2 release">
1283 <!--Bug Fixes-->
1284 <action dev="Greg Luck" type="fix" issue="1819841">
1285 NPE in MulticastKeepaliveHeartbeatReceiver when accessing
1286 processingThreadPool during startup.
1287 </action>
1288 <action dev="Greg Luck" type="fix" issue="1816084">
1289 RMIAsynchronousCacheReplicator flushReplicationQueue change to speed it up
1290 and remove pausing. Thanks to
1291 Kyle Sampson for this one.
1292 </action>
1293 <action dev="Greg Luck" type="fix" issue="1811875">
1294 RegisteredEventListeners is not thread-safe where listeners are being added
1295 and removed during
1296 operation.
1297 Fixed. Thanks to Geoffrey Arnold for pointing this out. Also removed final
1298 from class.
1299 </action>
1300 <action dev="Greg Luck" type="fix" issue="1828351">
1301 CacheStatistics causes a NPE if used for fresh caches. Fixed.
1302 </action>
1303 <action dev="Greg Luck" type="fix" issue="1831446">
1304 Dropped thread renaming in SelfPopulating cache. A debug feature that has
1305 probably outlived its
1306 usefulness.
1307 </action>
1308 <action dev="Greg Luck" type="fix" issue="1831817">
1309 cache.getAllWithLoader should use a loadAll method for any keys not present
1310 in the cache rather than
1311 loading
1312 individually. This is a performance optimisation. Fixed.
1313 </action>
1314 <action dev="Greg Luck" type="fix" issue="1846461">
1315 Division by zero in RMIBootstrapCacheLoader.java where elements are non-null
1316 but empty, which causes
1317 bootstrap to fail, although gracefully. Fixed.
1318 </action>
1319 <action dev="Greg Luck" type="fix" issue="1831755">
1320 Style issue. Abuse of Exceptions. Fixed.
1321 </action>
1322 <action dev="Greg Luck" type="fix" issue="1831823">
1323 JCache.getAll wraps values in Element. Fixed.
1324 </action>
1325 <action dev="Greg Luck" type="fix" issue="1802513">
1326 Replication Thread of Default Cache not disposed. Fixed.
1327 </action>
1328 </release>
1329
1330
1331 <release version="1.4.0-beta" date="2007-08-26" description="1.4 beta release">
1332
1333 <!--Features-->
1334 <action dev="Greg Luck" type="add">
1335 Add CacheLoaders to ehcache configuration and core classes.
1336 </action>
1337 <action dev="Greg Luck" type="add">
1338 Add CacheExceptionHandlers. The enable an exception handler to be registered
1339 with a cache so that it is
1340 called
1341 on exception rather than the exception being thrown.
1342 </action>
1343 <action dev="Greg Luck" type="add">
1344 Add CacheExtensions. This is a generic facility which holds a reference to a
1345 cache and is bound to the
1346 cache lifecycle,
1347 making possible a wide variety of extensions to behaviour.
1348 </action>
1349 <action dev="Greg Luck" type="update" issue="1737269">
1350 Add a version number to the ehcache jar manifest as is the Apache
1351 convention.
1352 </action>
1353 <action dev="Greg Luck" type="update" issue="1752251">
1354 Include all required libraries in the Sourceforge tarball download.
1355 </action>
1356 <action dev="Greg Luck" type="update" issue="1756338">
1357 Updated FAQ and Dependency chapters in the documentation and the Release
1358 Notes to point out that
1359 backport-concurrent
1360 for Java 5 is not compatible with Java 6, but the Java 4 version is.
1361 </action>
1362
1363 <!--Bug Fixes-->
1364 <action dev="Greg Luck" type="fix" issue="1744643">
1365 LfuMemoryStore did not support Non-Serializable objects.
1366 </action>
1367 <action dev="Greg Luck" type="fix" issue="1755263">
1368 Excessive CPU and (debug) logging when multicast send fails. Added a sleep
1369 to reduce the log spam
1370 when multicast is being blocked by a firewall. Continuous log messages
1371 obscure the network configuration
1372 issue. Thanks to Ronald Tschal for the bug report and patch.
1373 </action>
1374 <action dev="Greg Luck" type="fix" issue="1759740">
1375 NPE during CacheManager shutdown with persistent disk cache only where the
1376 maxElementsOnDisk=1.
1377 Thanks to James Shaw for the bug report.
1378 </action>
1379 <action dev="Greg Luck" type="fix" issue="1753349">
1380 i18n issue in the PageFragmentCachingFilter. Thanks to David Sheldon for the
1381 bug report and fix.
1382 </action>
1383 <action dev="Greg Luck" type="fix" issue="1739612">
1384 ManualRMICacheManagerPeerProvider.listRemoteCachePeers lists no peers if one
1385 node is down. The manually
1386 configured
1387 cluster should list those peers that are available so that the cluster can
1388 continue until the missing
1389 node is restored.
1390 </action>
1391
1392 </release>
1393
1394 <release version="1.3.0" date="2007-06-11" description="1.3 release">
1395
1396 <action dev="Greg Luck" type="fix" issue="1728071">
1397 Where the Hibernate EhCacheProvider or SingletonEhCacheProvider is being
1398 used with a
1399 configurationResourceName to
1400 load an ehcache configuration other than default, when it is not found in
1401 the classpath, no warning or
1402 other failure
1403 occurs. Ehcache will instead load itself from defaults.
1404 Added a warning message to indicate that a configurationResourceName was
1405 specified but could not be
1406 found.
1407 This should simplify debugging. Thanks to Robert Watkins for raising this
1408 issue.
1409 </action>
1410 <action dev="Greg Luck" type="fix" issue="1728780">
1411 RMIRegistry is now stopped if it was started by ehcache. This fixes a
1412 classloader memory leak on
1413 redeploy
1414 and reload in app servers. Thanks to Stefan Fleiter for supplying a patch.
1415 </action>
1416 <action dev="Greg Luck" type="fix" issue="1728950">
1417 Tweak to bootstrap to check for expired elements. It will skip expired
1418 elements rather than failing the
1419 bootstrap.
1420 Thanks to Stefan Fleiter for supplying a patch.
1421 </action>
1422 <action dev="Greg Luck" type="fix" issue="1732424">
1423 PropertyUtil.parseProperties using a JDK 1.5+ only feature. This issue was
1424 introduced in 1.3.0-beta3.
1425 Thanks to Ben Piper for pointing this out.
1426 </action>
1427 <action dev="Greg Luck" type="fix" issue="1730999">
1428 DiskStore trace message for put back ups should only log when the DiskStore
1429 is backed up.
1430 Thanks to Stefan Fleiter for this one.
1431 </action>
1432
1433 </release>
1434
1435 <release version="1.3.0-beta3" date="2007-05-27"
1436 description="Beta 3 for 1.3 release">
1437
1438 <!-- Feature Changes -->
1439 <action dev="Greg Luck" type="add">
1440 Add the ability to specify the property separator for the properties element
1441 in factory configurations.
1442 This is a new attribute propertySeparator that can be used in ehcache.xml
1443 configuration files.
1444 </action>
1445 <action dev="Greg Luck" type="update">
1446 Enable the DiskStore to be programmtically pluggable in the Store hierarchy.
1447 Thanks to Matt Magoffin for the patch.
1448 </action>
1449 <action dev="Greg Luck" type="update" fix="1725911">
1450 Applied minor patch to Element to allow it to be easily persisted using
1451 mechanisms other than Java
1452 Serialization.
1453 Thanks to Matt Magoffin for the patch.
1454 </action>
1455 <action dev="Greg Luck" type="fix" issue="1715492">
1456 Problems when peer lookup fails when receiving heartbeats because heartbeat
1457 receiving is
1458 single-threaded. This issue
1459 affects dirty or misconfigured networks or clusters. It hardens ehcache so
1460 that valid peers can still
1461 form a cluster
1462 in the presence of Naming.lookup() problems with one or more peers. Thanks
1463 to Daniel Weill and Fredrik
1464 Bertilson for
1465 reporting this and Daniel for supplying a patch. The patch changes the
1466 heartbeat receiving
1467 implementation to be
1468 multi-threaded
1469 so that one bad peer cannot bring the others down.
1470 </action>
1471 <action dev="Greg Luck" type="update" issue="1720152">
1472 Ehcache does asynchronous puts to the DiskStore. In previous version the
1473 amount of memory that could be
1474 used for spool
1475 buffering was
1476 unlimited. In very high load situations with limited memory this could cause
1477 OutOfMemory erros. This
1478 version introduces a
1479 diskSpoolBufferSizeMB
1480 configured per cache with a default of 30MB. Set this value to control the
1481 maximum amount of memory each
1482 cache DiskStore
1483 spool can consume.
1484 The default of 30MB should work well for backward compatibility. If you
1485 notice your DiskStore
1486 performance is affected
1487 negatively,
1488 increase diskSpoolBufferSizeMB.
1489 </action>
1490 </release>
1491
1492 <release version="1.3.0-beta2" date="2007-5-1" description="Beta 2 for 1.3 release">
1493
1494 <action dev="Greg Luck" type="fix">
1495 Fix issue reported by Fredrik Bertilsson regarding peers entering and
1496 leaving a cluster, where the
1497 reentered peer would
1498 never get
1499 updates.
1500 </action>
1501 <action dev="Greg Luck" type="fix" issue="1703340">
1502 Fixed RMICachePeer.getElements so that it does not allow null elements.
1503 </action>
1504 <action dev="Greg Luck" type="fix" issue="1681308">
1505 DiskStore SpoolThread is too slow under Java 1.6. The Spooling Thread was
1506 set to 2, on a scale of 1 to
1507 10
1508 from lowest to highest priority. Under JDK 1.6, this setting did not
1509 allocate enough CPU to enable the
1510 spool to be cleared in a given situation, whereas under JDK1.5 it did. This
1511 seems to be a bug in JDK6.
1512 The priority is now set to Thread.NORMAL_PRIORITY, which is 5.
1513 </action>
1514 <action dev="Greg Luck" type="update" issue="1684223">
1515 Distributed cache - flushing replicationQueue on dispose. We should flush
1516 the replication queue rather
1517 than
1518 clear it on dispose.
1519 </action>
1520 <action dev="Greg Luck" type="fix" issue="1704257">
1521 Fix clone problem introduced in 1.3-beta. This affects caches created from
1522 the default cache.
1523 Thanks to Erik Voorbraak for reporting this.
1524 </action>
1525 <action dev="Greg Luck" type="fix" issue="1694609">
1526 Add note to sample ehcache.xml and documentation about the reserved cache
1527 name "default".
1528 </action>
1529 <action dev="Greg Luck" type="update">
1530 The shutdown hook is now turned off by default. Set the system property
1531 net.sf.ehcache.enableShutdownHook=true to turn it
1532 on.
1533 </action>
1534 <action dev="Greg Luck" type="fix" issue="1706854">
1535 Document known issue with Tomcat. The presence of multiple &lt;Host&gt;
1536 entries in Tomcat's server.xml
1537 prevents
1538 replication from occuring. Thanks to David Patton for reporting this.
1539 </action>
1540 <action dev="Greg Luck" type="fix" issue="1680964">
1541 Make clear in the JavaDoc documentation in Cache that RemoteCacheException
1542 can be thrown by calls to
1543 put, remove and removeAll when the cache replication policy is synchronous
1544 and a remote peer is
1545 unavailable.
1546 Thanks to Christopher G. Stach II for reporting this issue.
1547 </action>
1548 </release>
1549
1550 <release version="1.3-beta1" date="2007-3-9" description="Beta for 1.3 release">
1551
1552 <!-- Feature Changes -->
1553 <action dev="Greg Luck" type="add">
1554 Added a net.sf.ehcache.jcache package, which is an implementation of JSR107,
1555 backed by ehcache.
1556 </action>
1557 <action dev="Greg Luck" type="add">
1558 Added a net.sf.ehcache.management package, which contains full JMX
1559 instrumentation for ehcache.
1560 </action>
1561
1562 <action dev="Tony Voss" issue="1588796" type="fix">
1563 Statistics Variables Need to be Longs. Changed internal representation to
1564 long in Cache, kept the
1565 direct getters for backwards compatible and changed the new Statistics class
1566 to be long based. Use
1567 getStatistics() to access the longs with out loss of precision.
1568 Reapplied. Somehow this got lost from 1.2.4.
1569 </action>
1570 <action dev="Chris Ryan" type="fix">
1571 Filter was rethrowing IOException as ServletException. The spec is clear
1572 that IOException is thrown
1573 as well. Catching these and rethrowing them as ServletException causes these
1574 IllegalStateException
1575 in Glassfish.
1576 </action>
1577 <action dev="Greg Luck" issue="1616492" type="fix">
1578 JBoss, Spring and some other applications have shutdown hooks. A race
1579 condition existed in
1580 CacheManager#shutdown() such that multiple shutdown hook threads could
1581 attempt to shutdown
1582 the CacheManager at the same time. Added class synchronization to prevent
1583 this and also
1584 added a check for the system property
1585 net.sf.ehcache.disableShutdownHook=true which will disable
1586 addition of the shutdown hook. Reported by various people.
1587
1588 Note: In ehcache-1.3-beta2 and higher the shutdown hook is off by default.
1589 The above property has
1590 no effect. Set the system property net.sf.ehcache.enableShutdownHook=true to
1591 enable it.
1592 </action>
1593 <action dev="Greg Luck" issue="1618798" type="fix">
1594 Element#equals(Object) causes ClassCastException when the comparison object
1595 is not an Element. Fixed.
1596 </action>
1597 <action dev="Greg Luck" issue="1636876" type="fix">
1598 GzipFilter corrupts UTF-8 encoded non-Latin characters. Fixed. Thanks to
1599 Matt Raible and Konstantin
1600 Kolinko for the bug report and Kolodin for the patch. This issue also
1601 affected the CachingFilter.
1602 </action>
1603 <action dev="Greg Luck" issue="1664030" type="fix">
1604 Fix bug in RMIBootstrapCacheLoader.doLoad. If the first element in the
1605 remote cache is null, no
1606 bootstrapping
1607 will take place. Fixed. Thanks to Ben Piper for reporting this one and the
1608 fix.
1609 </action>
1610 <action dev="Greg Luck" type="fix">
1611 Fix issue reported by Fredrik Bertilsson regarding peers entering and
1612 leaving a cluster, where the
1613 reentered peer would
1614 never get
1615 updates.
1616 </action>
1617 <action dev="Greg Luck" issue="1661328" type="fix">
1618 Fix bug for the combination of Automatic Peer Discovery and synchronous
1619 bootstrapping.
1620 </action>
1621 <action dev="Greg Luck" type="remove">
1622 Removed the JNDI manual listener and peer provider. This was proving
1623 difficult to maintain. Custom
1624 listeners and providers are pluggable and can be added as an extension to
1625 ehcache.
1626 </action>
1627 </release>
1628
1629 <release version="1.2.4" date="2006-12-31" description="Final 1.2.4 release">
1630
1631 <!-- Feature Changes -->
1632 <action dev="Greg Luck" type="update">
1633 Consolidate shutdown hooks to one on each CacheManager instance.
1634 </action>
1635 </release>
1636
1637 <release version="1.2.4RC" date="2006-11-26" description="Minor release">
1638
1639 <!-- Feature Changes -->
1640 <action dev="Greg Luck" type="remove">
1641 Dropped support for JDK1.3. Resulting changes are proper chained exceptions,
1642 and no longer requiring commons-collections. This enables some
1643 simplifications
1644 in the code base and eases maintenance.
1645 </action>
1646 <action dev="Greg Luck/Jody Brownell" type="add">
1647 Added a maxElementsOnDiskStore attribute to cache. This lets disk stores be
1648 bounded. ehcacheLFU eviction is used to decide which element to evict.
1649 </action>
1650 <action dev="Greg Luck/Jody Brownell" type="add">
1651 Combined the DiskStore's expiry and spool threads. They were competing for
1652 the
1653 same locks anyway. This reduces the maximum number of threads used from 2 to
1654 1 per
1655 DiskStorwe.
1656 </action>
1657 <action dev="Tony Voss" issue="1588976" type="add">
1658 Enable the timeToLive to be set on the cacheManagerPeerProviderFactory. This
1659 enables
1660 the spread of multicast packets to be controlled from a single host to the
1661 Internet.
1662 The default is 1, which is the same as the Java default so the default
1663 behavior will not
1664 change for existing users.
1665 </action>
1666
1667 <!-- Reported Bug fixes -->
1668 <action dev="Greg Luck" issue="1574735" type="fix">
1669 Fix typo in lock timeout log message in BlockingCache. Thanks to Matt
1670 Magoffin
1671 for reporting this bug.
1672 </action>
1673 <action dev="Greg Luck" issue="1579761" type="fix">
1674 Fix issue where it is not possible to specify a DiskStore path consistently
1675 on all operating systems. This is a workaround to a JDK bug. Always create
1676 paths like "java.io.tmpdir/cache". Any trailing characters to java.io.tmpdir
1677 added for windows and solaris will be removed and placed with a single file
1678 separator.
1679 </action>
1680 <action dev="Greg Luck" issue="1563017" type="fix">
1681 Fixed NullPointerException on Cache.evictExpiredElements() and added some
1682 other NPE
1683 guards to Cache.
1684 </action>
1685 <action dev="Greg Luck" issue="1585015" type="fix">
1686 Synchronous bootstrap and manual peer discovery combination does not work
1687 because
1688 the first cache to start always fails. This is normal and the CacheManager
1689 should
1690 cope with it. Added a catch and log a message when this happens. Thanks to
1691 Patrick
1692 Galley for the bug report.
1693 </action>
1694 <action dev="Greg Luck" issue="1589004" type="fix">
1695 ehcache.xsd diskStore path defined as xs:NCName
1696 </action>
1697 <action dev="Greg Luck" issue="1589451" type="fix">
1698 Fix documentation error: Ehcache provider package inconsistent
1699 </action>
1700
1701 <!-- Unreported Bug fixes -->
1702 <action dev="Greg Luck" issue="1593099" type="fix">
1703 Fixed NPE when both DiskStore path is not configured and DiskStorePath is
1704 not being used.
1705 Thanks to mdillon for the patch. This was also reported under the above bug
1706 number.
1707 </action>
1708
1709 <action dev="Greg Luck" type="fix">
1710 CachingFilter and its subclasses now work when upstream filters or servlets
1711 return
1712 404 or 302, 301.
1713 </action>
1714
1715 <!-- Patches -->
1716 <action dev="Greg Luck" issue="1584776" type="fix">
1717 Fixed rare ConcurrentModificationException in getBoundCachePeers. Thanks to
1718 Tony Voss
1719 </action>
1720 <action dev="Greg Luck" issue="1583996" type="fix">
1721 Harden heartbeat sender for IOExceptions and large peer sizes. Thanks to
1722 Tony Voss
1723 for the patch.
1724 </action>
1725 <action dev="Greg Luck" issue="1584041" type="fix">
1726 Reduce network utilisation for distributed caching through the optimisation
1727 of only
1728 doing a Naming.lookup(url) when the url has not been seen before.
1729 </action>
1730 <action dev="Greg Luck" type="fix">
1731 Various fixes to web package to make filters work on Sun Application Server
1732 9 and Tomcat
1733 in addition to Orion. Add support for errors and redirects passing through
1734 filters.
1735 </action>
1736 <action dev="Tony Voss" issue="1592324" type="fix">
1737 Multiple multicast packets sends multiple heartbeats
1738 </action>
1739 <action dev="dguist" issue="1591711" type="fix">
1740 Infinite recursion in BlockingCache.getKeysNoDuplicateCheck
1741 </action>
1742 <action dev="Tony Voss" issue="1588796" type="fix">
1743 Statistics Variables Need to be Longs. Changed internal representation to
1744 long in Cache, kept the
1745 direct getters for backwards compatible and changed the new Statistics class
1746 to be long based. Use
1747 getStatistics() to access the longs with out loss of precision.
1748 </action>
1749 </release>
1750
1751 <release version="1.2.3" date="2006-9-2" description="Maintenance release">
1752
1753 <!-- Feature Changes -->
1754 <action dev="Greg Luck" issue="1524597" type="add">
1755 Cache.remove doesn't fire listeners if element didn't exist. This stopped
1756 cluster
1757 removes from working where the local cache does not have the element cached.
1758 Thanks
1759 to Elijah Epifanov for reporting this one and arguing the case for this
1760 behaviour
1761 </action>
1762 <action dev="Greg Luck" issue="1540653" type="add">
1763 Allow references to ehcache.xsd in ehcache XML files. All of the ehcache.xml
1764 files
1765 have had the schema reference added. This allows easy validation of
1766 ehcache.xml
1767 configuration files using tools like Eclipse and IntelliJ. Thanks to Gabriel
1768 Klein
1769 for suggesting this.
1770 </action>
1771 <action dev="Greg Luck" issue="1540657" type="add">
1772 Added a new property asynchronousReplicationIntervalMillis to the
1773 RMICacheReplicator factory
1774 configuration to control the interval at which it runs. The default is
1775 1000ms,
1776 which
1777 is the value it was hardcoded too in earlier versions.
1778 </action>
1779 <action dev="Greg Luck" type="add">
1780 Added a new notifyRemoveAll cache event notification as requested by users.
1781 Called during Ehcache#removeAll() to
1782 indicate that the all elements have been removed from the cache in a bulk
1783 operation. The usual
1784 notifyElementRemoved is not called.
1785 This notification exists because clearing a cache is a special case. It is
1786 often
1787 not practical to serially process notifications where potentially millions
1788 of
1789 elements
1790 have been bulk deleted.
1791 </action>
1792 <action dev="Greg Luck" type="add">
1793 Added a new notifyElementEvicted cache event notification as requested by
1794 users.
1795 Called immediately after an element is evicted from the cache. Evicted in
1796 this
1797 sense
1798 means evicted from one store and not moved to another, so that it exists
1799 nowhere in the local cache. In a sense the Element has been removed
1800 from the cache, but it is different,
1801 thus the separate notification. The usual notifyElementRemoved is not
1802 called.
1803 </action>
1804 <action dev="Greg Luck" issue="1523915" type="update">
1805 Asynchronous replication / soft references.
1806 There is a trade off between OutOfMemory risk and replication correctness.
1807 Change the RMIAsynchronousCacheReplicator so that Elements are
1808 SoftReference,
1809 not
1810 all EventMessages. The result is that put and update via copy may be
1811 SoftReference
1812 collected, but remove and update via remove will always go through.
1813 </action>
1814 <action dev="Greg Luck" type="update">
1815 Change Cache#getQuiet so that cache statistics are not updated. This is a
1816 sensible
1817 API change and probably always should have worked this way.
1818 </action>
1819 <action dev="Greg Luck" type="update">
1820 Open up some classes by removing final keyword and changing the constructors
1821 to
1822 public.
1823 </action>
1824
1825 <!-- Reported Bug fixes -->
1826 <action dev="Greg Luck" issue="1532610" type="fix">
1827 Fix isssue where a distributed cache can take up to a minute to shutdown.
1828 This
1829 issue
1830 affected web container and application server shutdowns.
1831 The fix is to unbind RMICachePeers before unexporting them. Thanks to
1832 Lennard
1833 Fuller
1834 and Peter Chiang for finding and fixing this hard one.
1835 </action>
1836 <action dev="Greg Luck" issue="1529506" type="fix">
1837 Fixed a few broken links and inconsistencies in the documentation.
1838 </action>
1839 <action dev="Greg Luck" issue="1542696" type="fix">
1840 Bad dependency scopes in Maven2 POM. Most dependencies are required only at
1841 test time.
1842 Changed the pom to reflect this.
1843 </action>
1844 <action dev="Greg Luck" issue="1540322" type="fix">
1845 Synchronous replicators in a cluster can deadlock trying to replicate to
1846 each
1847 other.
1848 The deadlock gets resolved by a SocketTimeoutException depending on what you
1849 set it
1850 too. Reduce synchronization around gets, puts and removes so that listener
1851 notification
1852 is not synchronized, which resolves this problem.
1853 </action>
1854 <action dev="Greg Luck" issue="1550043" type="fix">
1855 Fixed a bug where in BlockingCache and SelfPopulatingCache where
1856 setTimeoutMillis
1857 was set to a non zero value.
1858 </action>
1859 <action dev="Greg Luck" issue="1548314" type="fix">
1860 Large TTL values cause expire time to be incorrect in Element. Changed
1861 ONE_SECOND from
1862 an int to a long which fixes the issue.
1863 </action>
1864
1865
1866 </release>
1867
1868 <release version="1.2.2" date="2006-7-17"
1869 description="Maintenance release to ehcache-1.2.1">
1870
1871 <!-- Feature Changes -->
1872 <action dev="Daniel Wiell" issue="1521843" type="add">
1873 Added a ShutdownListener which implements ServletContextListener for
1874 shutting
1875 down all CacheManagers in a web application.
1876 </action>
1877
1878 <!-- Reported Bug fixes -->
1879 <action dev="Greg Luck" issue="1516447" type="fix">
1880 If you put an Element with overridden TTL and TTI values and then replace it
1881 with an Element with defaults, the new Element lives forever. putQuiet is
1882 not
1883 affected by this bug. Thanks to Pete at Goodtech for finding this one.
1884 Note that a symptom of this bug for caches that overflow to disk is an
1885 endlessly
1886 growing .data file for the Cache.
1887 </action>
1888 <action dev="Greg Luck" type="fix">
1889 Reduce the memory used by flushSpool() in DiskStore.
1890 See http://gregluck.com/blog/archives/2006/07/tuning_memory_u.html for
1891 details.
1892 </action>
1893 <action dev="Greg Luck" issue="1521699" type="fix">
1894 Cache names with slashes cause problems. Tightened the validation code
1895 around
1896 setting a cache
1897 name. Now throw IllegalArgumentException if a cache name is null or contains
1898 '/'. Thanks to Daniel
1899 Wiell for repoting this one and suggesting the fix.
1900 </action>
1901 <action dev="Greg Luck" issue="1517565" type="fix">
1902 Loading an element from the disk store fails in some circumstances due to
1903 classloading
1904 issues. This issue was created by a patch to fix 1324221 back in October
1905 2005.
1906 Resolved
1907 by trying the new way and then, if a ClassNotFoundException is thrown, doing
1908 it
1909 the old way.
1910 </action>
1911 <action dev="Greg Luck" issue="1513436" type="fix">
1912 CachingFilter should not change Thread name. Now sets it back to the
1913 original
1914 when done.
1915 </action>
1916 </release>
1917
1918 <release version="1.2.1" date="2006-7-2" description="ehcache-1.2.1">
1919 <!-- Feature Changes over 1.2.1RC -->
1920 <action dev="Greg Luck" issue="1492900" type="add">
1921 Change Blocking cache to use a lock striping technique for its Mutexes. This
1922 limits the number
1923 of Mutexes to 100, rather than a number equalling the number of keys, while
1924 preserving excellent
1925 liveness and safety. Thanks to Olaf Krische for reporting this and Brian
1926 Goetz
1927 for assisting with
1928 a solution.
1929 </action>
1930 <action dev="Greg Luck" type="add">
1931 Change BlockingCache and SelfPopulatingCache to act as decorators for
1932 Ehcache.
1933 Remove now redundant
1934 BlockingCacheManager and SelfPopulatingCacheManager. Change signatures of
1935 these
1936 caches from Serializable
1937 to Object. This change is not backward compatible but no libraries use
1938 these,
1939 so developers can change
1940 over on their own projects.
1941 </action>
1942
1943 <!-- Reported Bug fixes -->
1944 <action dev="Greg Luck" issue="1190614" type="fix">
1945 This was reported by Victor Volle and is a duplicate of 1492900. Fixed.
1946 </action>
1947 <action dev="Greg Luck" issue="1506399" type="fix">
1948 Changing all classloading to the context classloader is sometimes
1949 inconvenient.
1950 Fallback to
1951 ClassLoaderUtil.class.getClassLoader() if
1952 Thread.currentThread().getContextClassLoader()
1953 fails. Thanks to Robert Watkins for reporting this one.
1954 </action>
1955 <action dev="Greg Luck" issue="1508623" type="fix">
1956 Debug messages generate excess String objects. Added logging level guards
1957 around about 6 debug log statements.
1958 Thanks to Derek Hulley for pointing this one out.
1959 </action>
1960 <action dev="Greg Luck" type="fix">
1961 Harden all ehcache threads so that RuntimeExceptions and Errors do not stop
1962 them. This change, on its own, has been
1963 backported to a separate release, ehcache-1.2.0_01.
1964 </action>
1965 <action dev="Greg Luck" type="update">
1966 Change spooling mechanism to use less memory, so as to avoid memory spikes.
1967 </action>
1968 </release>
1969
1970
1971 <release version="1.2.1RC" date="2006-6-4" description="ehcache-1.2.1RC">
1972 <!-- Feature Changes over 1.2 -->
1973 <action dev="Greg Luck" type="add">
1974 Added the constructs package which was previously a separate module. The
1975 constructs package adds
1976 valuable functionality and given that the 1.2 jar size is large, can be
1977 added
1978 with only a small
1979 increase in jar size.
1980 </action>
1981 <action dev="Greg Luck" issue="1483735" type="add">
1982 Allow zeroconf of RMICacheManagerPeerListenerFactory. A configuration
1983 &lt;cacheManagerPeerListenerFactory
1984 class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"/&gt;
1985 will now work. The listener port will be automatically assigned a free port.
1986 </action>
1987 <action dev="Greg Luck" type="add">
1988 New SingletonEhCacheProvider for use by Hibernate in situations where code
1989 has
1990 been written which relies
1991 on the singleton behaviour of ehcache-1.1 and earlier. Most code bases using
1992 Hibernate should not
1993 require this.
1994 </action>
1995 <action dev="Greg Luck" type="add">
1996 Allow cacheEventListenerFactory elements to be added to defaultCache in
1997 ehcache.xml. This allows
1998 caches created with CacheManager.addCache(String cacheName) to receive
1999 events.
2000 This can be used for
2001 example to set default replication settings in defaultCache.
2002 </action>
2003 <action dev="Greg Luck" type="add">
2004 To complement full support foe default cache (above), added support for
2005 programmatic addition of caches
2006 which include CacheReplicators. Also support for removal of these caches
2007 with
2008 CacheManager.remove(String cacheName).
2009 </action>
2010 <action dev="Greg Luck" type="add">
2011 Andy McNutt's JNDI-based manual RMI replication added. See ehcache.xml
2012 example
2013 for how to use.
2014 </action>
2015 <action dev="Greg Luck" type="add">
2016 Support tomcat 5.5 for the servlet filters. Tomcat integration testing, in
2017 addition to the Orion one, is also
2018 added to the full JUnit test process. Tomcat relies on Servlet 2.4
2019 dispatcher
2020 INCLUDE and FORWARD directives
2021 for page fragment caching.
2022 </action>
2023 <action dev="Greg Luck" type="add">
2024 Support runtime setting of individual Element time to lives, time to idles
2025 and
2026 eternal overrides.
2027 If an override is set, the Element expiry ignores the Cache default.
2028 </action>
2029 <action dev="Greg Luck" type="add">
2030 Add a cache bootstrap mechanism. This is used to populate a cache when it is
2031 first initialized. An
2032 abstract factory, BootstrapCacheLoaderFactory has been defined along with an
2033 interface BootstrapCacheLoader.
2034 The initial concrete implementations are for RMI, so that a new cache
2035 entering
2036 a cluster gets bootstrapped
2037 from a randomly chosen peer.
2038 </action>
2039 <action dev="Greg Luck" type="add">
2040 Allow CacheManager instances to use the same ehcache.xml configuration.
2041 Automatically resolve conflicts
2042 for DiskStore and CacheManagerPeerListener. Log a warning that the conflict
2043 existed and what was done to
2044 resolve it along with a suggestion to either use ehcache in singleton mode
2045 or
2046 specify separate ehcache.xml
2047 configurations for each CacheManager instance.
2048 </action>
2049
2050 <!-- Reported Bug fixes -->
2051 <action dev="Greg Luck" issue="1480442" type="fix">
2052 Theoretically possible NPE if a MulticastRMICacheManagerPeerProvider is
2053 started
2054 and then stopped
2055 before a multicast socket connection can be established. Added guard for
2056 NPE.
2057 Thanks to Roman Kurmanowytsch
2058 for reporting the issue and a fix.
2059 </action>
2060 <action dev="Greg Luck" issue="1485765" type="fix">
2061 Add shutdown hook to RMICacheManagerPeerListener so that, even if
2062 CacheManager.shutdown() is not called,
2063 processes still exit cleanly. This is a bug rather than a feature request
2064 because Cache has a shutdown
2065 hook to always cleanly shut down disk store, and ehcache should be
2066 consistent
2067 in supporting shutdown hooks.
2068 </action>
2069 <action dev="Greg Luck" issue="1486858" type="fix">
2070 In GzipFilter and CachingFilter Gzipping an empty response body creates 20
2071 byte
2072 responses. Fixed so that
2073 this situation is detected and a zero bytes gzipped body, with a content
2074 length
2075 also of 0 is returned. Can
2076 occur in 204 and 304 responses.
2077 </action>
2078 <action dev="Greg Luck" issue="1488853" type="fix">
2079 Changed localhost lookup to a static in Cache, to avoid a potential
2080 bottleneck
2081 when creating and destroying
2082 large numbers of caches rapidly. Thanks to Derek Hully for the bug report
2083 and
2084 suggested fix.
2085 </action>
2086 </release>
2087
2088
2089 <release version="1.2" date="2006-4-25" description="ehcache-1.2. ehcache-1.2 represents the addition of many new features while remaining
2090 backward compatible with 1.1.">
2091 <!-- Feature Changes over RC1-->
2092 <!-- Bug fixes -->
2093 <action dev="Greg Luck" issue="1473833" type="fix">
2094 Changing the API to Object from Serializable breaks projects. Leave the
2095 existing Serializable
2096 API in place and add new constructors and methods for Object. Add
2097 getObjectValue and getObjectKey to
2098 Element.
2099 </action>
2100 <action dev="Greg Luck" issue="1474363" type="fix">
2101 Closing Cache does not remove reference from DiskStore, preventing Garbage
2102 Collection of DiskStore and
2103 Cache
2104 on dispose of a cache. Fixed to set Cache reference to null on dispose.
2105 Thanks
2106 to Felix Meschberger for
2107 the patch.
2108 </action>
2109 <action dev="Greg Luck" issue="1474360" type="fix">
2110 Closing Cache does not remove shutdown hook, preventing Garbage Collection
2111 of a
2112 Cache with a persistent
2113 DiskStore on dispose of a cache. Fixed to remove the shutdown thread after
2114 dispose.
2115 Thanks to Felix Meschberger for the patch.
2116 </action>
2117 </release>
2118
2119
2120 <release version="1.2rc1" date="2006-4-17" description="ehcache-1.2 release candidate 1. ehcache-1.2 represents the addition of many new features while remaining
2121 backward compatible with 1.1.">
2122 <!-- Feature Changes -->
2123 <action dev="Greg Luck" type="update">
2124 License updated to Apache 2.0.
2125 </action>
2126 <action dev="Greg Luck" type="update">
2127 Following many requests, ehcache no longer requires that Elements contain
2128 Serializable keys and values.
2129 Ehcache will gracefully degrade for those operations which require
2130 Serialization. In particular the
2131 MemoryStore and event listeners can be used with Non Serializable elements.
2132 WARNING error messages are
2133 logged when an operation cannot be completed because the key or value is not
2134 Serializable.
2135 </action>
2136 <action dev="Greg Luck" type="update">
2137 Feature Request 1458049 Wrap original exceptions during configuration.
2138 Added an intial cause Throwable field to CacheException to facilitate easier
2139 reporting without
2140 breaking pre JDK1.4 compatibility.
2141 </action>
2142 <action dev="Greg Luck" type="remove">
2143 Removed the old Hibernate plugin from the code base. It has been deprecated
2144 since the beginning of the
2145 1.2 beta series. The plugin is being actively maintained in the
2146 Hibernate project. Any project still using net.sf.ehcache.hibernate.Plugin
2147 should change their
2148 Hibernate configurations to org.hibernate.cache.EHCacheProvider.
2149 </action>
2150 <action dev="Greg Luck" type="add">
2151 Feature Request 1081071. Added the ability to specify subdirectories under
2152 System Property paths. e.g.
2153 java.io.tmpdir/one
2154 </action>
2155 <action dev="Greg Luck" type="add">
2156 Feature Request 1025706. Added the ability to specify a system property,
2157 net.sf.ehcache.disabled=true,
2158 to
2159 easily disable ehcache. A disabled cache works fully but discards and
2160 Elements
2161 added to it.
2162 </action>
2163
2164 <!-- Bug fixes -->
2165 <action dev="Greg Luck" issue="1432458" type="fix">
2166 Add protections to the DiskStore spoolThread against programming errors in
2167 Elements that can cause it to
2168 die.
2169 Secondly, if it does die, disable adding elements to the DiskStore and log
2170 an
2171 error, so as to gracefully
2172 degrade.
2173 </action>
2174 <action dev="Greg Luck" issue="1369073" type="fix">
2175 flush() was using up to double the memory used by a MemoryStore during
2176 flush()
2177 which could cause an
2178 OutOfMemory error on shutdown if memory was constrained. flush no longer
2179 causes
2180 any memory spike.
2181 Thanks to Sergey Nekoval for reporting the bug.
2182 </action>
2183 </release>
2184
2185
2186 <release version="1.2beta5" date="2006-3-26" description="Covers beta1 - beta 5 releases. ehcache-1.2 represents the addition of many new features while remaining
2187 backward compatible with 1.1.">
2188 <!-- Feature Changes -->
2189 <action dev="Surya Suravarapu" type="add">
2190 Introduced new caching policies in addition to the standard LRU. FIFO and
2191 LFU
2192 were added. LRU remains
2193 the default unless explicitly set in each cache's configuration. Thanks to
2194 Surya Suravarapu for working
2195 with me on these. The documentation has a new section on caching policies
2196 and
2197 when to use what.
2198 </action>
2199 <action dev="Greg Luck" type="add">
2200 Introduced CacheManagerEventListener and CacheEventListener interfaces and
2201 default implementations.
2202 These can be configured in ehcache.xml or set programmatically. Thanks to
2203 steve
2204 at jofti dot com for
2205 help with the specification for these.
2206 </action>
2207 <action dev="Greg Luck" type="add">
2208 After requests from Jo Walnes, Paul Hammant and others, I have added normal
2209 instance constructers to
2210 CacheManager which do not act as singletons. The factory singleton methods
2211 remain for backward
2212 compatibility. CacheManager can now be constructed with a Configuration
2213 object
2214 programmatically.
2215 </action>
2216 <action dev="Greg Luck" type="add">
2217 Since version 1.1, ehcache has had a persistent diskStore, which makes it
2218 suitable for storing
2219 application state. Added a flush method so that, if the cache is
2220 diskPersistent, it can be
2221 programmatically flushed, in addition to the automatic flush which happens
2222 at
2223 shutdown.
2224 </action>
2225 <action dev="Greg Luck" type="add">
2226 Pluggable Distributed Caching. The default implementation supports cache
2227 discovery via multicast or
2228 manual configuration. Updates are delivered asynchronously or synchronously
2229 via
2230 custom RMI connections.
2231 Additional discovery or delivery schemes can be plugged in by third parties.
2232 </action>
2233 <action dev="Greg Luck" type="add">
2234 DiskStore is now up to 12 times faster in certain operations and much more
2235 scalable.
2236 </action>
2237 <action dev="Greg Luck" type="add">
2238 Significant (up to 7 fold) DiskStore performance increases, after
2239 introduction
2240 of finer grained
2241 threading. Thanks to Robert Watkins for reporting on the performance limits.
2242 </action>
2243 <action dev="Greg Luck" type="update">
2244 Clover test coverage raised to 86%.
2245 </action>
2246
2247
2248 <!-- Feature Requests -->
2249 <action dev="Greg Luck" type="update">
2250 Feature Request 431481 Distributed: The ability to notify cache event
2251 listeners
2252 excluding
2253 CacheReplicators
2254 </action>
2255 <action dev="Greg Luck" type="update">
2256 Feature Request 1431393 Events from remote in distributed cache should be
2257 received by any non
2258 CacheReplicator listeners
2259 </action>
2260
2261 <!-- Patches -->
2262 <action dev="Greg Luck" type="update">
2263 Patch 1158788. Fix for dependencies list... MemoryStore.java to remove
2264 Apache
2265 commons-collections for
2266 JDK1.4
2267 users
2268 </action>
2269
2270 <!-- Bug fixes -->
2271 <action dev="Greg Luck" issue="1122734" type="fix">
2272 change default configuration to use context classloader
2273 </action>
2274 <action dev="Greg Luck" issue="1324221" type="fix">
2275 Fix for DiskStore to deserialize using
2276 Thread.currentThread().getContextClassLoader()
2277 </action>
2278 <action dev="Greg Luck" issue="1261613" type="fix">
2279 CacheManager.shutdown now uses a Class rather than an instance lock.
2280 </action>
2281 <action dev="Greg Luck" issue="1237017" type="fix">
2282 Configurator gets a file not found when files contain spaces.
2283 </action>
2284 <action dev="Greg Luck" issue="1332728" type="fix">
2285 DiskStore degrades under load.
2286 </action>
2287 <action dev="Greg Luck" issue="1079529" type="fix">
2288 Change classloader to Thread.currentThread().getContextClassLoader() for
2289 ehache.xml.
2290 </action>
2291 <action dev="Greg Luck" issue="1414674" type="fix">
2292 DiskStore data file is not deleted when index is corrupt.
2293 </action>
2294 <action dev="Greg Luck" issue="1224325" type="fix">
2295 JavaDoc documentation fix for element.getLastAccessTime returns 0 for
2296 element
2297 just created
2298 </action>
2299 <action dev="Greg Luck" issue="1247019" type="fix">
2300 Documentation should advise using the Hibernate supplied plugin rather than
2301 the
2302 older one in
2303 ehcache which is now deprecated.
2304 </action>
2305 <action dev="Greg Luck" issue="" type="fix">
2306 Fix bug introduced in 1.2 beta series. Removed Boolean.parseBoolean and
2307 java.util.Queue which were
2308 introduced
2309 in the JDK1.5 API to preserve backward compatibility.
2310 </action>
2311 <action dev="Greg Luck" issue="" type="fix">
2312 Fix bug introduced in 1.2 beta series. Changed ant script to avoid compiling
2313 with clover in dists
2314 </action>
2315 <action dev="Greg Luck" issue="1410374" type="fix">
2316 Fix bug introduced in 1.2 beta series. Cannot load configuration from jar
2317 (or
2318 any non-file URL).
2319 </action>
2320 <action dev="Greg Luck" issue="1432074" type="fix">
2321 Fix bug introduced in 1.2 beta series. NPE on
2322 RMICacheManagerPeerProviderFactory when rmiUrls not
2323 specified. Now throws a meaningful CacheException.
2324 </action>
2325 <action dev="Greg Luck" issue="1445694" type="fix">
2326 Fix bug introduced in 1.2 beta series. Deadlock on deserialization of a
2327 cache
2328 entry. Thanks to Felix
2329 Meschberger
2330 for reporting the bug and uploading a patch.
2331 </action>
2332 <action dev="Greg Luck" issue="1457268" type="fix">
2333 Fix bug introduced in 1.2 beta series. Caches created with
2334 Cache.addCache(String) share a
2335 RegisteredEventListeners instance.
2336 Thanks to Olaf Ontaine for for reporting the bug and showing how it happens.
2337 </action>
2338 <action dev="Greg Luck" issue="1451780" type="fix">
2339 Fix bug introduced in 1.2 beta series. RMIAsynchronousCacheReplicator
2340 mishandling non-copy updates.
2341 Thanks to Randy Puro for a patch.
2342 </action>
2343 </release>
2344
2345
2346 <release version="1.1" date="2004-11-23" description="Maintenance release">
2347
2348 <!-- Feature Changes -->
2349 <action dev="Greg Luck" type="remove">
2350 Split out the entire constructs package. These are now in a new subproject:
2351 ehcache-constructs, which
2352 has been released.
2353 See http://ehcache.org/ehcache-constructs for more details.
2354 </action>
2355 <action dev="Greg Luck" type="remove">
2356 removed the dependency on Doug Lea's concurrency library.
2357 </action>
2358 <action dev="Greg Luck" type="add">
2359 Add new documentation on cache configuration and hibernate performance
2360 tuning.
2361 </action>
2362
2363 <!-- Bug Fixes -->
2364 <action dev="Greg Luck" issue="1063908" type="fix">
2365 Extra check to make sure that we always close persistent disk store's
2366 FileInputStream in the
2367 rare case where the ObjectInputStream is null.
2368 </action>
2369
2370 </release>
2371
2372 <release version="1.0" date="2004-9-28" description="Stable release">
2373
2374 <!-- Feature Changes -->
2375 <action dev="Greg Luck" type="add">
2376 Added SelfPopulatingCacheManager
2377 </action>
2378 <action dev="Greg Luck" type="add">
2379 Added a new diskExpiryThreadIntervalSeconds configuration option to
2380 ehcache.xml, to allow
2381 tuning of the expiry thread per cache.
2382 </action>
2383 <action dev="Greg Luck" type="add">
2384 Added a new diskPersistent feature and configuration option. diskPersistent
2385 makes disk stores
2386 persistent between CacheManager and JVM restarts. It enables very long held
2387 caches to be configured,
2388 useful
2389 for very expensive cache entries that are long lives, such as mapping
2390 geocodes.
2391 </action>
2392
2393 <!-- Bug Fixes -->
2394 <action dev="Greg Luck" issue="" type="fix">
2395 Expiry Thread now has a default time of 2 minutes, not 25.
2396 </action>
2397 <action dev="Greg Luck" issue="" type="fix">
2398 Expiry Thread now dies immediately on DiskStore disposal.
2399 </action>
2400 <action dev="Greg Luck" issue="" type="fix">
2401 cache.calculateInMemorySize() now returns a non-zero value
2402 </action>
2403 <action dev="Greg Luck" issue="" type="fix">
2404 Bug 1025130 - Null Pointer Exception when no default cache configured. Now
2405 we
2406 throw a CacheException
2407 with a
2408 meaningful message.
2409 </action>
2410 <action dev="Greg Luck" issue="" type="fix">
2411 Bug 1025128 IBM Websphere alway requires commons-collection.jar, even though
2412 it
2413 is never used. Updated
2414 requirements
2415 to note this.
2416 </action>
2417 <action dev="Greg Luck" issue="" type="fix">
2418 Patch 1030960. JDK1.4 and higher now chain exception thrown from
2419 SelfPopulatingCache.
2420 </action>
2421 <action dev="Greg Luck" issue="" type="fix">
2422 1033061 Fix to Thread naming in SelfPopulatingCache so that the old name is
2423 always put back.
2424 </action>
2425 <action dev="Greg Luck" issue="" type="fix">
2426 1003659 build script unfriendly to IDE: IDE builds should now work.
2427 </action>
2428
2429 </release>
2430
2431
2432 <release version="0.9" date="2004-7-5" description="Additional release">
2433
2434 <!-- Feature Changes -->
2435 <action dev="Greg Luck" type="add">
2436 ehcache.xml cache definitions can now omit timeToIdle and/or timeToLive,
2437 which
2438 are now optional
2439 attributes.
2440 This will make cache config easier to read for eternal caches.
2441 Either omitting the attributes or setting them to 0 causes them not to be
2442 considered when calculating
2443 expiry.
2444 Earlier versions of ehcache would have immediately expired all elements if
2445 either attribute was set to
2446 0,
2447 so this change should not break any existing code.
2448 </action>
2449 <action dev="Greg Luck" type="add">
2450 Added getQuiet and putQuiet methods to Cache. These methods are the same as
2451 get
2452 and put
2453 but do not affect statistics.
2454 </action>
2455 <action dev="Greg Luck" type="add">
2456 Implemented an Element clone method.
2457 </action>
2458 <action dev="Greg Luck" type="add">
2459 Added calculateInMemorySize() method to Cache to measure the approximate
2460 size
2461 of a cache's
2462 memory footprint.
2463 </action>
2464 <action dev="Greg Luck" type="update">
2465 Increased Clover test coverage to above 80%.
2466 </action>
2467 <action dev="Greg Luck" type="update">
2468 Added many new tests for idle expiry.
2469 </action>
2470 <action dev="Greg Luck" type="update">
2471 Added tests for the new constructs package. These tests demonstrate
2472 concurrency
2473 performance
2474 differences between blocking cache designs based on notify/notifyAll and
2475 Doug
2476 Lea's concurrency package.
2477 </action>
2478 <action dev="Greg Luck" type="update">
2479 Test new xml format scenarios for eternal, time to idle and time to live
2480 </action>
2481 <action dev="Greg Luck" type="update">
2482 Started adding performance tests to ensure there are no regressions over
2483 time.
2484 </action>
2485 <action dev="Greg Luck" type="add">
2486 Added a new constructs package. There are blocking, self populating and self
2487 populating collections
2488 caches.
2489 These are all pull-through caches. They are useful where the cost of
2490 creating
2491 an entry is high.
2492
2493 Details follow:
2494 <![CDATA[
2495 BlockingCache - a cache which blocks subsequent threads until the first read thread
2496 populates a cache entry
2497 <br/><br/>
2498 SelfPopulatingCache - a read-through cache. A cache that populates elements as they are requested
2499 without requiring the caller to know how the entries are populated. It also enables refreshes
2500 of cache entries without blocking reads on the same entries.
2501 <br/> <br/>
2502 SelfPopulatingCollectionsCache - a SelfPopulatingCache that adds threading safety where it is known
2503 in advance that all entries will be collections.
2504 <br/> <br/>
2505 The package is useful for, inter alia, :
2506 <br/><br/>
2507 - Web Page caches <br/>
2508 - Search Engine caches<br/>
2509 <br/><br/>
2510 See the tests for examples of how to use this package.
2511 <br/><br/>
2512 This package requires Doug Lea's concurrency library. A copy is provided in the tools directory
2513 when you check out the project by SVN. Or, you can get it from http://gee.cs.oswego.edu/dl/cpj/
2514 Note that if you are not using the constructs package, you do not need the concurrency library.
2515 ]]>
2516 </action>
2517
2518 <!-- Bug Fixes -->
2519 <action dev="Greg Luck" issue="" type="fix">
2520 JavaDoc fixups
2521 </action>
2522 <action dev="Greg Luck" issue="" type="fix">
2523 Fixed time to idle which was not expiring elements after the idle time had
2524 expired. This feature did
2525 not seem to be getting used. It is now useable. Fixed the test which was
2526 also
2527 broken
2528 </action>
2529 <action dev="Greg Luck" issue="" type="fix">
2530 Fixed bugs with getSize and getKeys, which were not checking for duplicate
2531 keys
2532 between
2533 the memory and disk stores.
2534 </action>
2535 </release>
2536
2537
2538 <release version="0.8" date="2004-5-15" description="Additional features">
2539
2540 <!-- Feature Changes -->
2541 <action dev="Greg Luck" type="add">
2542 Investigated a Hibernate SessionFactory bug and clarified it was not a
2543 Hibernate bug. Added test.
2544 </action>
2545 <action dev="Greg Luck" type="add">
2546 Investigated a cache size possible bug and clarified it is not in EHCache.
2547 Added test.
2548 </action>
2549 <action dev="Greg Luck" type="add">
2550 Added Clover test coverage reporting. Clover instrumentation is not included
2551 in
2552 release jars.
2553 </action>
2554 <action dev="Greg Luck" type="add">
2555 Updated Hibernate testing to version 2.1.1
2556 </action>
2557 <action dev="Greg Luck" type="add">
2558 Modified the Apache license at the request of the Apache Cocoon project.
2559 </action>
2560
2561 <!-- Bug fixes -->
2562 <action dev="Greg Luck" issue="" type="fix">
2563 Fixed a very rare null pointer exception, when retrieving a cache entry.
2564 </action>
2565
2566 </release>
2567
2568
2569 <release version="0.7" date="2004-1-2" description="Bug fix release">
2570
2571 <!-- Bug fixes -->
2572 <action dev="Greg Luck" issue="" type="fix">
2573 Cache Configuration
2574 Fixed null pointer exception where the disk store path was not specified
2575 when
2576 use disk store is set to
2577 false
2578 </action>
2579 <action dev="Greg Luck" issue="" type="fix">
2580 JDK1.3 Compatibility Replaced JDK1.4 Exception constructors with simple
2581 message
2582 constructors compatible
2583 with JDK1.2 and 1.3
2584 </action>
2585 <action dev="Greg Luck" issue="" type="fix">
2586 Problem with Element expiry
2587 Fixed bug where expiry checking on get was calling remove with the element
2588 rather than the key.
2589 </action>
2590 <action dev="Greg Luck" issue="" type="fix">
2591 Expire thread should not run if the cache is not active
2592 Changed the expire thread to while(active)
2593 </action>
2594 <action dev="Greg Luck" issue="" type="fix">
2595 Expiry thread unnecessarily being created for eternal caches
2596 Skipped creating the expiry thread if caches are eternal.
2597 </action>
2598 </release>
2599
2600
2601 <release version="0.6" date="2003-12-8" description="Bug fix release">
2602
2603 <!-- Feature Changes -->
2604 <action dev="Greg Luck" type="remove">
2605 Remove SoftReferences
2606 SoftReferences for cache element values has been replaced with standard
2607 references.
2608 The JDK 1.4.2 JVM was found to remove SoftReferences in normal operation,
2609 rather than
2610 the expected behaviour of use only to avoid memory exhaustion. Caches will
2611 now
2612 behave deterministically. Element values will only be removed when the
2613 element
2614 is
2615 garbage collected.
2616 </action>
2617
2618
2619 <!-- Bug fixes -->
2620 <action dev="Greg Luck" issue="" type="fix">
2621 Hibernate Cache Provider.
2622 Fixed bug where incompatible timestamps were generated
2623 </action>
2624 <action dev="Greg Luck" issue="" type="fix">
2625 Time to Idle" documentation bug.
2626 </action>
2627 <action dev="Greg Luck" issue="" type="fix">
2628 Fixed documentation bug in ehcache.xml and ehcache-failsafe.xml where "Time
2629 to
2630 Live" was
2631 incorrectly referred to as "Time to Idle"
2632 </action>
2633
2634 </release>
2635
2636
2637 <release version="0.5" date="2003-11-18"
2638 description="Hibernate compatibility release">
2639
2640 <!-- Feature Changes -->
2641 <action dev="Greg Luck" type="add">
2642 Changed from JDK1.4 Logging to Commons Logging. This is to permit JDK1.2 and
2643 JDK1.3 to use EHCache.
2644 </action>
2645 <action dev="Greg Luck" type="add">
2646 Added Apache Commons Collections LRUMap as an alternative backing Map for
2647 the
2648 MemoryStore. The
2649 java.util.LinkedHashMap has been retained and is used automatically for
2650 JDK1.4
2651 and higher.
2652 </action>
2653 <action dev="Greg Luck" type="add">
2654 Added LICENSE.txt to the jar in the distribution
2655 </action>
2656
2657
2658 <!-- Bug fixes -->
2659 <action dev="Greg Luck" issue="" type="fix">
2660 Don't create a Disk Store when overflowToDisk="false" is set in ehcache.xml
2661 </action>
2662 <action dev="Greg Luck" issue="" type="fix">
2663 toString() methods now report on all fields
2664 </action>
2665 <action dev="Greg Luck" issue="" type="fix">
2666 Fixed documentation bug in ehcache.xml and ehcache-failsafe.xml where "Time
2667 to
2668 Live" was
2669 incorrectly referred to as "Time to Idle"
2670 </action>
2671
2672 </release>
2673
2674
2675 <release version="0.4" date="2003-11-13" description="First public release">
2676
2677 <!-- Feature Changes -->
2678 <action dev="Greg Luck" type="add">
2679 Initial version, originally based on a fork from JCS plus donated patches.
2680 </action>
2681
2682 </release>
2683
2684
2685 </body>
2686 </document>