程序包 org.hibernate.cache.spi.access

接口 EntityDataAccess

所有超级接口:

CachedDomainDataAccess

所有已知实现类:

AbstractEntityDataAccess, EntityNonStrictReadWriteAccess, EntityReadOnlyAccess, EntityReadWriteAccess, EntityTransactionalAccess

public interface EntityDataAccess
extends CachedDomainDataAccess

Contract for managing transactional and concurrent access to cached entity data. The expected call sequences related to various operations are:

• INSERTS : insert(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object, java.lang.Object) -> afterInsert(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object, java.lang.Object)
• UPDATES : CachedDomainDataAccess.lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object) -> update(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object) -> afterUpdate(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object, org.hibernate.cache.spi.access.SoftLock)
• DELETES : CachedDomainDataAccess.lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object) -> CachedDomainDataAccess.remove(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object) -> CachedDomainDataAccess.unlockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, org.hibernate.cache.spi.access.SoftLock)
• LOADS : CachedDomainDataAccess.putFromLoad(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object, java.lang.Object)

There is another usage pattern that is used to invalidate entries after performing "bulk" HQL/SQL operations: CachedDomainDataAccess.lockRegion() -> CachedDomainDataAccess.removeAll(org.hibernate.engine.spi.SharedSessionContractImplementor) -> CachedDomainDataAccess.unlockRegion(org.hibernate.cache.spi.access.SoftLock)

作者:

Gavin King, Steve Ebersole

方法概要

修饰符和类型	方法	说明
boolean	afterInsert(SharedSessionContractImplementor session, Object key, Object value, Object version)	Called afterQuery an item has been inserted (afterQuery the transaction completes), instead of calling release().
boolean	afterUpdate(SharedSessionContractImplementor session, Object key, Object value, Object currentVersion, Object previousVersion, SoftLock lock)	Called afterQuery an item has been updated (afterQuery the transaction completes), instead of calling release().
Object	generateCacheKey(Object id, EntityPersister rootEntityDescriptor, SessionFactoryImplementor factory, String tenantIdentifier)	To create instances of keys for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.
Object	getCacheKeyId(Object cacheKey)	Performs reverse operation to generateCacheKey(java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SessionFactoryImplementor, java.lang.String)
boolean	insert(SharedSessionContractImplementor session, Object key, Object value, Object version)	Called afterQuery an item has been inserted (beforeQuery the transaction completes), instead of calling evict().
boolean	update(SharedSessionContractImplementor session, Object key, Object value, Object currentVersion, Object previousVersion)	Called afterQuery an item has been updated (beforeQuery the transaction completes), instead of calling evict().

从接口继承的方法 org.hibernate.cache.spi.access.CachedDomainDataAccess

contains, evict, evictAll, get, getAccessType, getRegion, lockItem, lockRegion, putFromLoad, putFromLoad, remove, removeAll, unlockItem, unlockRegion

方法详细资料

generateCacheKey

Object generateCacheKey(Object id,
                        EntityPersister rootEntityDescriptor,
                        SessionFactoryImplementor factory,
                        String tenantIdentifier)

To create instances of keys for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.

参数:

id - the primary identifier of the entity

rootEntityDescriptor - Hierarchy for which a key is being generated

factory - a reference to the current SessionFactory

tenantIdentifier - the tenant id, or null if multi-tenancy is not being used.

返回:

a key which can be used to identify this entity on this same region todo (6.0) : the access for an entity knows the entity hierarchy and the factory. why pass them in?

getCacheKeyId

Object getCacheKeyId(Object cacheKey)

Performs reverse operation to generateCacheKey(java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SessionFactoryImplementor, java.lang.String)

参数:

cacheKey - key previously returned from generateCacheKey(java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SessionFactoryImplementor, java.lang.String)

返回:

original id passed to generateCacheKey(java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SessionFactoryImplementor, java.lang.String)

insert

boolean insert(SharedSessionContractImplementor session,
               Object key,
               Object value,
               Object version)

Called afterQuery an item has been inserted (beforeQuery the transaction completes), instead of calling evict(). This method is used by "synchronous" concurrency strategies.

参数:

session - Current session

key - The item key

value - The item

version - The item's version value

返回:

Were the contents of the cache actually changed by this operation?

抛出:

CacheException - Propagated from underlying cache provider

afterInsert

boolean afterInsert(SharedSessionContractImplementor session,
                    Object key,
                    Object value,
                    Object version)

Called afterQuery an item has been inserted (afterQuery the transaction completes), instead of calling release(). This method is used by "asynchronous" concurrency strategies.

参数:

session - Current session

key - The item key

value - The item

version - The item's version value

返回:

Were the contents of the cache actual changed by this operation?

抛出:

CacheException - Propagated from underlying cache provider

update

boolean update(SharedSessionContractImplementor session,
               Object key,
               Object value,
               Object currentVersion,
               Object previousVersion)

Called afterQuery an item has been updated (beforeQuery the transaction completes), instead of calling evict(). This method is used by "synchronous" concurrency strategies.

参数:

session - Current session

key - The item key

value - The item

currentVersion - The item's current version value

previousVersion - The item's previous version value

返回:

Were the contents of the cache actually changed by this operation?

抛出:

CacheException - Propagated from underlying cache provider

afterUpdate

boolean afterUpdate(SharedSessionContractImplementor session,
                    Object key,
                    Object value,
                    Object currentVersion,
                    Object previousVersion,
                    SoftLock lock)

Called afterQuery an item has been updated (afterQuery the transaction completes), instead of calling release(). This method is used by "asynchronous" concurrency strategies.

参数:

session - Current session

key - The item key

value - The item

currentVersion - The item's current version value

previousVersion - The item's previous version value

lock - The lock previously obtained from CachedDomainDataAccess.lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object)

返回:

Were the contents of the cache actually changed by this operation?

抛出:

CacheException - Propagated from underlying cache provider