ehcache

net.sf.ehcache.hibernate
Class SingletonEhCacheProvider

java.lang.Object
  extended by net.sf.ehcache.hibernate.SingletonEhCacheProvider
All Implemented Interfaces:
org.hibernate.cache.CacheProvider

Deprecated.

@Deprecated
public final class SingletonEhCacheProvider
extends Object

Singleton cache Provider plugin for Hibernate 3.2 and ehcache-1.2. New in this provider is support for non Serializable keys and values. This provider works as a Singleton. No matter how many Hibernate Configurations you have, only one ehcache CacheManager is used. See EhCacheProvider for a non-singleton implementation.

Ehcache-1.2 also has many other features such as cluster support and listeners, which can be used seamlessly simply by configurion in ehcache.xml.

Use hibernate.cache.provider_class=net.sf.ehcache.hibernate.SingletonEhCacheProvider in the Hibernate configuration to enable this provider for Hibernate's second level cache.

Updated for ehcache-1.2. Note this provider requires ehcache-1.2.jar. Make sure ehcache-1.1.jar or earlier is not in the classpath or it will not work.

See http://ehcache.org for documentation on ehcache

Version:
$Id: SingletonEhCacheProvider.java 5631 2012-05-10 08:31:33Z teck $
Author:
Greg Luck, Emmanuel Bernard

Field Summary
protected  CacheManager manager
          CacheManager instance that creates/builds Cache instances for this provider.
static String NET_SF_EHCACHE_CONFIGURATION_RESOURCE_NAME
          Deprecated. The Hibernate system property specifying the location of the ehcache configuration file name.
 
Constructor Summary
SingletonEhCacheProvider()
          Deprecated.  
 
Method Summary
 org.hibernate.cache.Cache buildCache(String name, Properties properties)
          Builds a Cache.
 boolean isMinimalPutsEnabledByDefault()
          Whether to optimize for minimals puts or minimal gets.
protected  URL loadResource(String configurationResourceName)
          Load the supplied resource from the classpath.
 long nextTimestamp()
          Returns the next timestamp.
 void start(Properties properties)
          Deprecated. Callback to perform any necessary initialization of the underlying cache implementation during SessionFactory construction.
 void stop()
          Deprecated. Callback to perform any necessary cleanup of the underlying cache implementation during SessionFactory.close().
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NET_SF_EHCACHE_CONFIGURATION_RESOURCE_NAME

public static final String NET_SF_EHCACHE_CONFIGURATION_RESOURCE_NAME
Deprecated. 
The Hibernate system property specifying the location of the ehcache configuration file name.

If set to say ehcache-1.xml, ehcache-1.xml will be looked for in the root of the classpath.

See Also:
Constant Field Values

manager

protected volatile CacheManager manager
CacheManager instance that creates/builds Cache instances for this provider.

Constructor Detail

SingletonEhCacheProvider

public SingletonEhCacheProvider()
Deprecated. 
Method Detail

start

public final void start(Properties properties)
                 throws org.hibernate.cache.CacheException
Deprecated. 
Callback to perform any necessary initialization of the underlying cache implementation during SessionFactory construction.

Parameters:
properties - current configuration settings.
Throws:
org.hibernate.cache.CacheException

stop

public void stop()
Deprecated. 
Callback to perform any necessary cleanup of the underlying cache implementation during SessionFactory.close().


buildCache

public final org.hibernate.cache.Cache buildCache(String name,
                                                  Properties properties)
                                           throws org.hibernate.cache.CacheException
Builds a Cache.

Even though this method provides properties, they are not used. Properties for EHCache are specified in the ehcache.xml file. Configuration will be read from ehcache.xml for a cache declaration where the name attribute matches the name parameter in this builder.

Specified by:
buildCache in interface org.hibernate.cache.CacheProvider
Parameters:
name - the name of the cache. Must match a cache configured in ehcache.xml
properties - not used
Returns:
a newly built cache will be built and initialised
Throws:
org.hibernate.cache.CacheException - inter alia, if a cache of the same name already exists

nextTimestamp

public final long nextTimestamp()
Returns the next timestamp.

Specified by:
nextTimestamp in interface org.hibernate.cache.CacheProvider

isMinimalPutsEnabledByDefault

public final boolean isMinimalPutsEnabledByDefault()
Whether to optimize for minimals puts or minimal gets.

Indicates whether when operating in non-strict read/write or read-only mode Hibernate should optimize the access patterns for minimal puts or minimal gets. In Ehcache we default to minimal puts since this should have minimal to no affect on unclustered users, and has great benefit for clustered users.

This setting can be overridden by setting the "hibernate.cache.use_minimal_puts" property in the Hibernate configuration.

Specified by:
isMinimalPutsEnabledByDefault in interface org.hibernate.cache.CacheProvider
Returns:
true, optimize for minimal puts

loadResource

protected URL loadResource(String configurationResourceName)
Load the supplied resource from the classpath.


ehcache

Copyright © 2003-2014 Terracotta, Inc.. All Rights Reserved.