所有超级接口:

CachedDomainDataAccess

所有已知实现类:

AbstractNaturalIdDataAccess, NaturalIdNonStrictReadWriteAccess, NaturalIdReadOnlyAccess, NaturalIdReadWriteAccess, NaturalIdTransactionalAccess
```
public interface NaturalIdDataAccess
extends CachedDomainDataAccess
```
Contract for managing transactional and concurrent access to cached naturalId data. The expected call sequences related to various operations are:
Note the special case of UPDATES above. Because the cache key itself has changed here we need to remove the old entry as well
There is another usage pattern that is used to invalidate entries afterQuery performing "bulk" HQL/SQL operations: CachedDomainDataAccess.lockRegion() -> CachedDomainDataAccess.removeAll(org.hibernate.engine.spi.SharedSessionContractImplementor) -> CachedDomainDataAccess.unlockRegion(org.hibernate.cache.spi.access.SoftLock)
IMPORTANT : NaturalIds are not versioned so null will always be passed to the version parameter to:
作者:

Gavin King, Steve Ebersole, Eric Dalquist

方法概要

所有方法实例方法抽象方法
修饰符和类型	方法	说明
`boolean`	`afterInsert(SharedSessionContractImplementor session, Object key, Object value)`	Called afterQuery an item has been inserted (afterQuery the transaction completes), instead of calling release().
`boolean`	`afterUpdate(SharedSessionContractImplementor session, Object key, Object value, SoftLock lock)`	Called afterQuery an item has been updated (afterQuery the transaction completes), instead of calling release().
`Object`	`generateCacheKey(Object[] naturalIdValues, EntityPersister rootEntityDescriptor, SharedSessionContractImplementor session)`	To create instances of NaturalIdCacheKey for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.
`Object[]`	`getNaturalIdValues(Object cacheKey)`	Performs reverse operation to `generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor)`, returning the original naturalIdValues.
`boolean`	`insert(SharedSessionContractImplementor session, Object key, Object value)`	Called afterQuery an item has been inserted (beforeQuery the transaction completes), instead of calling evict().
`boolean`	`update(SharedSessionContractImplementor session, Object key, Object value)`	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[] naturalIdValues,
                        EntityPersister rootEntityDescriptor,
                        SharedSessionContractImplementor session)
```
    To create instances of NaturalIdCacheKey for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.
    
    参数:
    
    naturalIdValues - the sequence of values which unequivocally identifies a cached element on this region
    
    rootEntityDescriptor - the persister of the element being cached
    
    返回:
    
    a key which can be used to identify an element unequivocally on this same region
  - getNaturalIdValues
```
Object[] getNaturalIdValues(Object cacheKey)
```
    Performs reverse operation to generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor), returning the original naturalIdValues.
    
    参数:
    
    cacheKey - key returned from generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor)
    
    返回:
    
    the sequence of values which unequivocally identifies a cached element on this region
  - insert
```
boolean insert(SharedSessionContractImplementor session,
               Object key,
               Object value)
```
    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
    
    返回:
    
    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)
```
    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
    
    返回:
    
    Were the contents of the cache actually changed by this operation?
    
    抛出:
    
    CacheException - Propagated from underlying cache provider
  - update
```
boolean update(SharedSessionContractImplementor session,
               Object key,
               Object value)
```
    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
    
    返回:
    
    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,
                    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
    
    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

接口 NaturalIdDataAccess

方法概要

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

方法详细资料

generateCacheKey

getNaturalIdValues

insert

afterInsert

update

afterUpdate