OSCache 2.4.1

Release Notes

(7th July 2007 - by Lars Torunski)

This maintenance release of 2.4.1 has two bug fixes:

• The cacheFlushed method is not being invoked on the CacheEntryEventListener
• CacheFilter max-age parameter MAX_AGE_NO_INIT not set properly

JIRA Issue List

OpenSymphony JIRA (4 issues)
T	Key	Summary	Status
	CACHE-297	max-age parameter not set on ResponseContent object returned from cache when using MAX_AGE_NO_INIT	Closed
	CACHE-296	For a Cache class the cacheFlushed method is not being invoked on the CacheEntryEventListener.	Closed
	CACHE-279	LRUCache loses entries when updated by mutliple threads.	Closed
	CACHE-209	Review: Handling junit failures in threads other than the main thread	Closed

OSCache 2.4

Release Notes

(1st Mai 2007 - by Lars Torunski)

New features and enhancements

Furthermore the next major release 2.4 enhances the CacheFilter and allows a better integration with the Spring Framework and JMX Monitoring.

• Setting CacheFilter parameters runtime
• Lazy initialization in CacheFilter in order to ease spring integration
• Allow disabling cacheing for special http methods (e.g. POST/DELETE/PUT) in CacheFilter
• CacheFilter allow reentrance over different filter configurations

• Hibernate 3.2 integration support
• JMX Monitoring/Administration via Spring
• Improve oscache.properties loading
• Performance improvment for large disk persistence usage

Upgrade Guide

• Due to the enhancements in the CacheFilter and method signature changes, it's recommended to recompile your code.
• Due to changes for CACHE-284 the handling of the listeners have been changed: Before OSCache 2.4 objects which implemented different CacheEventListener (e.g. CacheEntryEventListener and CacheMapAccessEventListener) had to be added twice, because the listeners where registrated only for one special event listener. With OSCache 2.4 only the object has to be added to the list without the 2nd parameter 'type of the listener'.

JIRA Issue List

OpenSymphony JIRA (29 issues)
T	Key	Summary	Status
	CACHE-260	NullPointerException in AbstractConcurrentReadCache	Closed
	CACHE-295	Hibernate 3.2 integration support	Closed
	CACHE-215	Setting CacheFilter parameters runtime	Closed
	CACHE-99	Use lazy initialization in cache filter in order to ease spring integration	Closed
	CACHE-258	NullPointerException when using putCache(key, val) in LRUCache	Closed
	CACHE-273	Update to Commons Logging 1.1	Closed
	CACHE-253	Migrate from CVS to SVN	Closed
	CACHE-261	Check javadoc of Cache.cancelUpdate on key not being updated	Closed
	CACHE-163	CacheFilter easier sub-classing via pre- and post-processes	Closed
	CACHE-162	CacheFilter easier sub-classing via useCache	Closed
	CACHE-272	Allow disabling of cacheing special http methods (e.g. POST/DELETE/PUT) in CacheFilter	Closed
	CACHE-277	CacheFilter should allow reentrance over different filter configurations	Closed
	CACHE-283	Improve oscache.properties loading	Closed
	CACHE-266	ServletCacheAdministrator no longer a "Servlet Singleton"	Closed
	CACHE-267	SplitServletOutputStream doesn't pass flush() on to underlying stream	Closed
	CACHE-141	CacheFilter easier sub-classing	Closed
	CACHE-288	Error in the HashDiskPersistenceListener byteArrayToHexString	Closed
	CACHE-264	problem with not escaped group names and their filenames for disk persistence	Closed
	CACHE-255	AbstractConcurrentReadCache#put(Object key, Object value) may return a wrong value	Closed
	CACHE-249	Performance improvment for large disk persistence usage	Closed
	CACHE-293	Allow to specify a different oscache.properties file for Hibernate	Closed
	CACHE-278	Filter ignores max-age parameter when serving from cache	Closed
	CACHE-284	Cache.dispatchCacheEntryEvent and Cache.addEventListener implementations are inconsistent	Closed
	CACHE-274	new method getIntialContext JMSBroadcastingListener	Closed
	CACHE-263	Run FindBugs 1.1.3 against current source code	Closed
	CACHE-292	CacheFilter max-age default and error-case initialisation are wrong	Closed
	CACHE-290	Bad Practice	Closed
	CACHE-178	JMX Monitoring/Administration via Spring	Closed
	CACHE-252	Log warning if user tries to set max entries on an unlimited cache	Closed

OSCache 2.3.2

Release Notes

(23rd July 2006 - by Lars Torunski)

This maintenance release of 2.3.1 has one enhancement:

• The removeEntry method in the Cache removes the entry from its groups now

Bug fixes:

• Method addGroupMappings leads to inconsistent memory cache if a persistent cache group exists
• Cache group is updated if entry is removed (duplicate)

JIRA Issue List

OpenSymphony JIRA (3 issues)
T	Key	Summary	Status
	CACHE-244	Cache group is not updated if entry is removed	Closed
	CACHE-188	removeEntry should update group mappings	Closed
	CACHE-181	addGroupMappings leads to inconsistent Memory-Cache	Closed

OSCache 2.3.1

Release Notes

(19th June 2006 - by Lars Torunski)

This maintenance release of 2.3 has one enhancement:

• CacheFilter: Default initialization of the Cache-Control max-age

Bug fixes:

• Cache.flushAll(Date flushDate) won't throw NeedsRefreshException when flush date is not yet reached anymore
• No NoSuchElementException at Cache.putInCache() anymore

JIRA Issue List

OpenSymphony JIRA (3 issues)
T	Key	Summary	Status
	CACHE-246	java.util.NoSuchElementException during at com.opensymphony.oscache.base.Cache.putInCache()	Closed
	CACHE-241	Cache.flushAll(Date flushDate) throws NeedsRefreshException when flush date is not yet reached	Closed
	CACHE-240	Default initialization of the Cache-Control max-age	Closed

OSCache 2.3

Release Notes

(6th March 2006 - by Lars Torunski)

This release includes additional improvements to the CacheFilter:

• CRON expressions to expire content at specific dates and/or times
• Pluggable EntryRefreshPolicy
• Reduced memory consumption

Disk persistence:

• Faster disk persistence
• Avoid DiskPersistenceListener deadlocks if process has no rights to delete cache file

Further changes are:

• new JSP tag addgroups
• interface to get a list of the cache event listeners
• commons collection dependency removed
• Java 1.3 support dropped

JIRA Issue List

OpenSymphony JIRA (14 issues)
T	Key	Summary	Status
	CACHE-235	Pluggable EntryRefreshPolicy for CacheFilter	Closed
	CACHE-230	CacheFilter Tutorial	Closed
	CACHE-229	Tomcat 5.5.12 throws IllegalStateException on getId() / fixed Servlet Spec 2.4	Closed
	CACHE-228	Add CRON expressions to CacheFilter to expire content at specific dates and/or times.	Closed
	CACHE-227	Remove commons collections from distribution	Closed
	CACHE-226	Drop Java 1.3 support	Closed
	CACHE-222	Add new JSP tag addGroups	Closed
	CACHE-217	Avoid DiskPersistenceListener deadlocks if process has no rights to delete cache file	Closed
	CACHE-216	Review CacheFilter against Servlet 2.4 spec.	Closed
	CACHE-214	Reduce memory consumption of ResponseContent	Closed
	CACHE-200	add 'getCacheEventListenerList()' to Cache class	Closed
	CACHE-197	Speed up disk persistence	Closed
	CACHE-183	HashDiskPersistenceListener / MessageDigest not thread safe	Closed
	CACHE-136	SequencedHashMap is deprecated in commons collections 3.1	Closed

OSCache 2.2 Final

Release Notes - Final

(6th November 2005 - by Lars Torunski)

Additionally to the 2.2 RC improvements, the final release was enhanced by:

• Allow cache group definition in CacheFilter
• Option to specify when to send Expires-Header
• Allow disabling initial set of the last modified header
• Continuous Integration and Dependency Management with Ivy
• Update to JGroups 2.2.8

JIRA Issue List

OpenSymphony JIRA (12 issues)
T	Key	Summary	Status
	CACHE-223	completeUpdate never being called after startUpdate() has been called, OSCache hangs for that key	Closed
	CACHE-211	Create check sums for the distribution files	Closed
	CACHE-210	Review: If last test-base and last test-web overwrite previous unit test reports	Closed
	CACHE-204	Allow disabling initial set of the last modified header	Closed
	CACHE-203	Change JSP tag URI in pages of example war	Closed
	CACHE-202	Expires header should not be inital set in fragments	Closed
	CACHE-201	Defined interface for ICacheKeyProvider not used in CacheFilter	Closed
	CACHE-199	Continuous Integration and Dependency Management with Ivy	Closed
	CACHE-198	Update to JGroups 2.2.8	Closed
	CACHE-196	Option to specify when to send Expires-Header	Closed
	CACHE-195	Allow cache group generation in CacheFilter	Closed
	CACHE-194	Update Documentation	Closed

OSCache 2.2 RC

Release Notes - Release Candidate

(18th September 2005 - by Lars Torunski)

Besides bugs being fixed, major improvements have been made to the CacheFilter in many ways:

• Default initialization of the last modified header which reduces transaction overhead and server load
• Support of GZip filters in the filter chain
• Custom key generation by subclassing CacheFilter or by implementing a special interface
• Preserving more http headers, e.g. the expires header
• Special handling for fragments of a page
• Avoids session creation for application scope pages
• Multiple matching cache filters won't dead-lock the response anymore

JIRA Issue List

OpenSymphony JIRA (22 issues)
T	Key	Summary	Status
	CACHE-189	AbstractDiskPersistenceListener.store hangs on exception	Closed
	CACHE-185	Filtered requests will be re-requested twice	Closed
	CACHE-184	Filter deadlock with external apps (mostly spiders)	Closed
	CACHE-179	Provider interface for method createCacheKey	Closed
	CACHE-174	Regression in fix of CACHE-170: UpdateStateEntry may leak when entry are removed	Closed
	CACHE-173	NullPointerException while flushing inexistant group	Closed
	CACHE-170	Data race handling Cache.updateStates results in Thread hangs when the blocking mode is used in concurrence	Closed
	CACHE-169	Default initialization of the last modified header	Closed
	CACHE-161	CacheFilter easier sub-classing via isCacheable	Closed
	CACHE-160	ExpiresRefreshPolicy always set in CacheFilter	Closed
	CACHE-155	Support of GZip filters in the filter chain	Closed
	CACHE-154	NullPointerException in JavaGroupsBroadcastingListener	Closed