Interface RegionFactory

All Superinterfaces:

Serializable, Service, Stoppable

All Known Implementing Classes:

AbstractRegionFactory, RegionFactoryTemplate

public interface RegionFactory
extends Service, Stoppable

Contract for building second-level cache regions, including regions dedicated to storing:

• entity and collection instances,
• query result sets, and
• timestamps used to determine when a cached query result set is stale.

Implementors should define a constructor in one of two forms:

• MyRegionFactoryImpl(java.util.Properties)
• MyRegionFactoryImpl()

Use the first when we need to read config properties prior to start(SessionFactoryOptions, Map) being called.

A RegionFactory may be selected using the property "hibernate.cache.region.factory_class".

Field Summary

Fields

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

Method Summary

Modifier and Type	Method	Description
DomainDataRegion	buildDomainDataRegion(DomainDataRegionConfig regionConfig, DomainDataRegionBuildingContext buildingContext)	Create a named Region for holding domain model data
QueryResultsRegion	buildQueryResultsRegion(String regionName, SessionFactoryImplementor sessionFactory)	Create a named Region for holding query result sets.
TimestampsRegion	buildTimestampsRegion(String regionName, SessionFactoryImplementor sessionFactory)	Create a named Region for holding timestamps used to determine when a cached query result set is stale.
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<String,Object> configValues)	Lifecycle callback to perform any necessary initialization of the underlying cache provider.

Methods inherited from interface Stoppable

stop

Field Details

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 Details

start

void start(@Nonnull
 SessionFactoryOptions settings,
 @Nonnull
 Map<String,Object> 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

@Nullable
AccessType getDefaultAccessType()

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

qualify

@Nonnull
String qualify(@Nonnull
 String regionName)

createTransactionContext

@Nonnull
default CacheTransactionSynchronization createTransactionContext(@Nonnull
 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. It's also expected that this be the value used by the CacheTransactionSynchronization created by this RegionFactory.

API Note:

This "timestamp" need not be related to timestamp in the Date.getTime()/System.currentTimeMillis() sense. It just needs to be an incrementing value.

getTimeout

default long getTimeout()

buildDomainDataRegion

@Nonnull
DomainDataRegion buildDomainDataRegion(@Nonnull
 DomainDataRegionConfig regionConfig,
 @Nonnull
 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

@Nonnull
QueryResultsRegion buildQueryResultsRegion(@Nonnull
 String regionName,
 @Nonnull
 SessionFactoryImplementor sessionFactory)

Create a named Region for holding query result sets.

buildTimestampsRegion

@Nonnull
TimestampsRegion buildTimestampsRegion(@Nonnull
 String regionName,
 @Nonnull
 SessionFactoryImplementor sessionFactory)

Create a named Region for holding timestamps used to determine when a cached query result set is stale.