Package org.hibernate.cache.spi.support

This package provides a framework intended to reduce the work needed to implement a caching provider. It takes care of most of the "grunt work" associated with the implementation, leaving the integrator to implement the interfaces StorageAccess and DomainDataStorageAccess.

A typical integration would provide:

1. a custom StorageAccess or DomainDataStorageAccess, along with
2. a custom RegionFactoryTemplate.

The preferred way to register these implementations to Hibernate is via a custom StrategyRegistrationProvider.

Examples of using this support package to implement a caching provider include:

• org.hibernate.testing.cache.CachingRegionFactory in hibernate-testing, and
• org.hibernate.cache.jcache.internal.JCacheRegionFactory in hibernate-jcache.

Interface Summary

Interface	Description
AbstractDomainDataRegion.Destructible	Optional interface caching implementors can implement in their CachedDomainDataAccess impls to automatically have them destroyed when this region is destroyed
AbstractReadWriteAccess.Lockable	Interface type implemented by all wrapper objects in the cache.
DomainDataStorageAccess	Specialization of StorageAccess for domain data regions.
StorageAccess	A general read/write abstraction over the specific "cache" object from the caching provider.

Class Summary

Class	Description
AbstractCachedDomainDataAccess
AbstractCollectionDataAccess
AbstractDomainDataRegion
AbstractEntityDataAccess
AbstractNaturalIdDataAccess
AbstractReadWriteAccess
AbstractReadWriteAccess.Item	Wrapper type representing unlocked items.
AbstractReadWriteAccess.SoftLockImpl	Wrapper type representing locked items.
AbstractRegion
CacheUtils
CollectionNonStrictReadWriteAccess	Standard support for CollectionDataAccess using the AccessType.NONSTRICT_READ_WRITE access type.
CollectionReadOnlyAccess	Standard support for CollectionDataAccess using the AccessType.READ_ONLY access type.
CollectionReadWriteAccess	Standard support for CollectionDataAccess using the AccessType.READ_WRITE access type.
CollectionTransactionAccess
DirectAccessRegionTemplate	Bridge between DirectAccessRegion and StorageAccess
DomainDataRegionImpl
DomainDataRegionTemplate	Abstract implementation of DomainDataRegion based on implementations just needing to provide a DomainDataStorageAccess reference for basic caching support - DomainDataStorageAccess acts as a simple wrapper around some generalized cache actions such as put or get.
EntityNonStrictReadWriteAccess	Standard support for EntityDataAccess using the AccessType.NONSTRICT_READ_WRITE access type.
EntityReadOnlyAccess	Standard support for EntityDataAccess using the AccessType.READ_ONLY access type.
EntityReadWriteAccess	Standard support for EntityDataAccess using the AccessType.READ_WRITE access type.
EntityTransactionalAccess
NaturalIdNonStrictReadWriteAccess	Standard support for NaturalIdDataAccess using the AccessType.NONSTRICT_READ_WRITE access type.
NaturalIdReadOnlyAccess	Standard support for NaturalIdDataAccess using the AccessType.READ_ONLY access type.
NaturalIdReadWriteAccess	Standard support for NaturalIdDataAccess using the AccessType.READ_WRITE access type.
NaturalIdTransactionalAccess
QueryResultsRegionTemplate
RegionFactoryTemplate
RegionNameQualifier
SimpleTimestamper	Generates increasing identifiers (in a single VM only).
TimestampsRegionTemplate

Enum Summary

Enum	Description
AccessedDataClassification