org.hibernate.cache.spi

Interface RegionFactory

All Superinterfaces:

Serializable, Service, Stoppable

All Known Subinterfaces:

RegionFactory

All Known Implementing Classes:

AbstractRegionFactory, NoCachingRegionFactory, RegionFactoryTemplate

public interface RegionFactory
extends Service, Stoppable

Contract for building second level cache regions.

Implementors should define a constructor in one of two forms:

• MyRegionFactoryImpl(Properties)
• MyRegionFactoryImpl()

Use the first when we need to read config properties prior to start(org.hibernate.boot.spi.SessionFactoryOptions, java.util.Map) being called.

Author:

Steve Ebersole

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_QUERY_RESULTS_REGION_UNQUALIFIED_NAME
static String	DEFAULT_UPDATE_TIMESTAMPS_REGION_UNQUALIFIED_NAME

Method Summary

Modifier and Type	Method and Description
DomainDataRegion	buildDomainDataRegion(DomainDataRegionConfig regionConfig, DomainDataRegionBuildingContext buildingContext) Create a named Region for holding domain model data
QueryResultsRegion	buildQueryResultsRegion(String regionName, SessionFactoryImplementor sessionFactory)
TimestampsRegion	buildTimestampsRegion(String regionName, SessionFactoryImplementor sessionFactory)
default CacheTransactionSynchronization	createTransactionContext(SharedSessionContractImplementor session)
AccessType	getDefaultAccessType() Get the default access type for any "user model" data
default long	getTimeout()
boolean	isMinimalPutsEnabledByDefault() By default should we perform "minimal puts" when using this second level cache implementation?
long	nextTimestamp() Generate a timestamp.
String	qualify(String regionName)
void	start(SessionFactoryOptions settings, Map configValues) Lifecycle callback to perform any necessary initialization of the underlying cache provider.

Methods inherited from interface org.hibernate.service.spi.Stoppable

stop

Field Detail

DEFAULT_QUERY_RESULTS_REGION_UNQUALIFIED_NAME

static final String DEFAULT_QUERY_RESULTS_REGION_UNQUALIFIED_NAME

See Also:

Constant Field Values

DEFAULT_UPDATE_TIMESTAMPS_REGION_UNQUALIFIED_NAME

static final String DEFAULT_UPDATE_TIMESTAMPS_REGION_UNQUALIFIED_NAME

See Also:

Constant Field Values

Method Detail

start

void start(SessionFactoryOptions settings,
           Map configValues)
    throws CacheException

Lifecycle callback to perform any necessary initialization of the underlying cache provider. Called exactly once during the construction of a SessionFactoryImpl.

Parameters:

settings - The settings in effect.

configValues - The available config values

Throws:

CacheException - Indicates problems starting the L2 cache impl; considered as a sign to stop SessionFactory building.

isMinimalPutsEnabledByDefault

boolean isMinimalPutsEnabledByDefault()

By default should we perform "minimal puts" when using this second level cache implementation?

Returns:

True if "minimal puts" should be performed by default; false otherwise.

getDefaultAccessType

AccessType getDefaultAccessType()

Get the default access type for any "user model" data

qualify

String qualify(String regionName)

createTransactionContext

default CacheTransactionSynchronization createTransactionContext(SharedSessionContractImplementor session)

nextTimestamp

long nextTimestamp()

Generate a timestamp. This value is generally used for purpose of locking/unlocking cache content depending upon the access-strategy being used. The intended consumer of this method is the Session to manage its SharedSessionContractImplementor.getTransactionStartTimestamp() value. It is also expected that this be the value used for this's RegionFactory's CacheTransactionContext

getTimeout

default long getTimeout()

buildDomainDataRegion

DomainDataRegion buildDomainDataRegion(DomainDataRegionConfig regionConfig,
                                       DomainDataRegionBuildingContext buildingContext)

Create a named Region for holding domain model data

Parameters:

regionConfig - The user requested caching configuration for this Region

buildingContext - Access to delegates useful in building the Region

buildQueryResultsRegion

QueryResultsRegion buildQueryResultsRegion(String regionName,
                                           SessionFactoryImplementor sessionFactory)

buildTimestampsRegion

TimestampsRegion buildTimestampsRegion(String regionName,
                                       SessionFactoryImplementor sessionFactory)