org.hibernate.cache

Interface CollectionRegion

All Superinterfaces:
Region, TransactionalDataRegion
Known Implementing Classes:
CollectionRegionAdapter

public interface CollectionRegion
extends TransactionalDataRegion

Defines the contract for a cache region which will specifically be used to store collection data.

Impl note: Hibernate always deals with changes to collections which (potentially) has its data in the L2 cache by removing that collection data; in other words it never tries to update the cached state, thereby allowing it to avoid a bunch of concurrency problems.

Author:
Steve Ebersole

Method Summary

CollectionRegionAccessStrategy
buildAccessStrategy(AccessType accessType)
Build an access strategy for the requested access type.

Methods inherited from interface org.hibernate.cache.Region

destroy, getElementCountInMemory, getElementCountOnDisk, getName, getSizeInMemory, getTimeout, nextTimestamp, toMap

Methods inherited from interface org.hibernate.cache.TransactionalDataRegion

getCacheDataDescription, isTransactionAware

Method Details

buildAccessStrategy

public CollectionRegionAccessStrategy buildAccessStrategy(AccessType accessType)
            throws CacheException
Build an access strategy for the requested access type.
Parameters:
accessType - The type of access strategy to build; never null.
Returns:
The appropriate strategy contract for accessing this region for the requested type of access.
Throws:
CacheException - Usually indicates mis-configuration.