CacheKey (EclipseLink 2.6.3, "build v20160428-59c81c5" API Reference)

java.lang.Object
- org.eclipse.persistence.internal.helper.ConcurrencyManager
- - org.eclipse.persistence.internal.identitymaps.CacheKey

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

CacheKeyInterceptor, LinkedCacheKey, WeakCacheKey
```
public class CacheKey
extends ConcurrencyManager
implements java.lang.Cloneable
```
Purpose: Container class for storing objects in an IdentityMap.
Responsibilities:
- Hold key and object.
- Maintain and update the current writeLockValue.
Since:

TOPLink/Java 1.0

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CACHE_KEY_INVALID`
`static int`	`CHECK_INVALIDATION_POLICY` The following constants are used for the invalidationState variable
`static int`	`MAX_WAIT_TRIES`

Fields inherited from class org.eclipse.persistence.internal.helper.ConcurrencyManager
deferredLockManagers

Constructor Summary

Constructors
Constructor and Description
`CacheKey(java.lang.Object primaryKey)`
`CacheKey(java.lang.Object primaryKey, java.lang.Object object, java.lang.Object lockValue)`
`CacheKey(java.lang.Object primaryKey, java.lang.Object object, java.lang.Object lockValue, long readTime, boolean isIsolated)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`acquire()` Acquire the lock on the cache key object.
`void`	`acquire(boolean forMerge)` Acquire the lock on the cache key object.
`void`	`acquireDeferredLock()` Acquire the deferred lock.
`boolean`	`acquireIfUnownedNoWait()` Acquire the lock on the cache key object.
`void`	`acquireLock(ObjectBuildingQuery query)`
`boolean`	`acquireNoWait()` Acquire the lock on the cache key object.
`boolean`	`acquireNoWait(boolean forMerge)` Acquire the lock on the cache key object.
`void`	`acquireReadLock()` Acquire the read lock on the cache key object.
`boolean`	`acquireReadLockNoWait()` Acquire the read lock on the cache key object.
`boolean`	`acquireWithWait(boolean forMerge, int wait)` Acquire the lock on the cache key object.
`void`	`checkDeferredLock()` Check the deferred lock on the cache key object.
`void`	`checkReadLock()` Check the read lock on the cache key object.
`java.lang.Object`	`clone()` INTERNAL: Clones itself.
`boolean`	`equals(CacheKey key)` Determine if the receiver is equal to key.
`boolean`	`equals(java.lang.Object object)` Determine if the receiver is equal to anObject.
`java.lang.Thread`	`getActiveThread()` Return the active thread.
`int`	`getInvalidationState()` INTERNAL: Return the value of the invalidationState Variable The return value will be a constant CHECK_INVALIDATION_POLICY - The Invalidation policy is must be checked for this cache key's sate CACHE_KEY_INVALID - This cache key has been labeled invalid.
`java.lang.Object`	`getKey()`
`long`	`getLastUpdatedQueryId()` INTERNAL: This method returns the system time in millis seconds at which this object was last refreshed CR #4365 CR #2698903 ...
`java.lang.Object`	`getObject()`
`IdentityMap`	`getOwningMap()`
`AbstractRecord`	`getProtectedForeignKeys()` INTERNAL: Return the FK cache
`long`	`getReadTime()` INTERNAL: Return the current value of the Read Time variable
`Record`	`getRecord()`
`java.lang.Object`	`getTransactionId()`
`CacheKey`	`getWrappedCacheKey()` If a Wrapper subclasses this CacheKey this method will be used to unwrap the cache key.
`java.lang.Object`	`getWrapper()`
`java.lang.Object`	`getWriteLockValue()`
`int`	`hashCode()` Overrides hashCode() in Object to use the primaryKey's hashCode for storage in data structures.
`boolean`	`hasProtectedForeignKeys()` Returns true if the protectedForeignKeys record is non-null and non-empty, false otherwise.
`boolean`	`isIsolated()` Returns true if this CacheKey is from an IsolatedClientSession
`boolean`	`isWrapper()` Returns true if this Instance of CacheKey is a wrapper and should be unwrapped before passing to IdentityMap APIs.
`void`	`release()` Release the lock on the cache key object.
`void`	`releaseDeferredLock()` Release the deferred lock
`void`	`releaseReadLock()` Release the read lock on the cache key object.
`java.lang.Object`	`removeFromOwningMap()` Removes this cacheKey from the owning map
`void`	`setInvalidationState(int invalidationState)` INTERNAL: Set the value of the invalidationState Variable The possible values are from an enumeration of constants CHECK_INVALIDATION_POLICY - The invalidation policy is must be checked for this cache key's sate CACHE_KEY_INVALID - This cache key has been labelled invalid.
`void`	`setIsolated(boolean isIsolated)`
`void`	`setIsWrapper(boolean isWrapper)`
`void`	`setKey(java.lang.Object key)`
`void`	`setLastUpdatedQueryId(long id)` INTERNAL: This method sets the system time in millis seconds at which this object was last refreshed CR #4365 CR #2698903 ...
`void`	`setObject(java.lang.Object object)`
`void`	`setOwningMap(IdentityMap map)`
`void`	`setProtectedForeignKeys(AbstractRecord protectedForeignKeys)`
`void`	`setReadTime(long readTime)` INTERNAL: Set the read time of this cache key
`void`	`setRecord(Record newRecord)`
`void`	`setTransactionId(java.lang.Object transactionId)`
`void`	`setWrapper(java.lang.Object wrapper)`
`void`	`setWriteLockValue(java.lang.Object writeLockValue)`
`java.lang.String`	`toString()` Print the nested depth.
`void`	`updateAccess()` Notifies that cache key that it has been accessed.
`java.lang.Object`	`waitForObject()`

Methods inherited from class org.eclipse.persistence.internal.helper.ConcurrencyManager
acquireIfUnownedNoWait, getDeferredLockManager, getDepth, getNumberOfReaders, getNumberOfWritersWaiting, getStack, isAcquired, isBuildObjectOnThreadComplete, isLockedByMergeManager, isNested, putDeferredLock, removeDeferredLockManager, setActiveThread, setIsLockedByMergeManager, setShouldTrackStack, setStack, shouldTrackStack, transitionToDeferredLock

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - CHECK_INVALIDATION_POLICY
```
public static final int CHECK_INVALIDATION_POLICY
```
    The following constants are used for the invalidationState variable
    
    See Also:
    
    Constant Field Values
  - CACHE_KEY_INVALID
```
public static final int CACHE_KEY_INVALID
```
    See Also:
    
    Constant Field Values
  - MAX_WAIT_TRIES
```
public static final int MAX_WAIT_TRIES
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - CacheKey
```
public CacheKey(java.lang.Object primaryKey)
```
  - CacheKey
```
public CacheKey(java.lang.Object primaryKey,
                java.lang.Object object,
                java.lang.Object lockValue)
```
  - CacheKey
```
public CacheKey(java.lang.Object primaryKey,
                java.lang.Object object,
                java.lang.Object lockValue,
                long readTime,
                boolean isIsolated)
```
- Method Detail
  - acquire
```
public void acquire()
```
    Acquire the lock on the cache key object.
    
    Overrides:
    
    acquire in class ConcurrencyManager
  - acquire
```
public void acquire(boolean forMerge)
```
    Acquire the lock on the cache key object. For the merge process called with true from the merge process, if true then the refresh will not refresh the object
    
    Overrides:
    
    acquire in class ConcurrencyManager
  - acquireNoWait
```
public boolean acquireNoWait()
```
    Acquire the lock on the cache key object. But only if the object has no lock on it Added for CR 2317
    
    Overrides:
    
    acquireNoWait in class ConcurrencyManager
  - acquireIfUnownedNoWait
```
public boolean acquireIfUnownedNoWait()
```
    Acquire the lock on the cache key object. Only acquire a lock if the cache key's active thread is not set. Added for Bug 5840635
  - acquireNoWait
```
public boolean acquireNoWait(boolean forMerge)
```
    Acquire the lock on the cache key object. But only if the object has no lock on it Added for CR 2317 called with true from the merge process, if true then the refresh will not refresh the object
    
    Overrides:
    
    acquireNoWait in class ConcurrencyManager
  - acquireWithWait
```
public boolean acquireWithWait(boolean forMerge,
                               int wait)
```
    Acquire the lock on the cache key object. But only if the object has no lock on it Added for CR 2317 called with true from the merge process, if true then the refresh will not refresh the object
    
    Overrides:
    
    acquireWithWait in class ConcurrencyManager
  - acquireDeferredLock
```
public void acquireDeferredLock()
```
    Acquire the deferred lock.
    
    Overrides:
    
    acquireDeferredLock in class ConcurrencyManager
  - acquireLock
```
public void acquireLock(ObjectBuildingQuery query)
```
  - checkReadLock
```
public void checkReadLock()
```
    Check the read lock on the cache key object. This can be called to ensure the cache key has a valid built object. It does not hold a lock, so the object could be refreshed afterwards.
    
    Overrides:
    
    checkReadLock in class ConcurrencyManager
  - checkDeferredLock
```
public void checkDeferredLock()
```
    Check the deferred lock on the cache key object. This can be called to ensure the cache key has a valid built object. It does not hold a lock, so the object could be refreshed afterwards.
    
    Overrides:
    
    checkDeferredLock in class ConcurrencyManager
  - acquireReadLock
```
public void acquireReadLock()
```
    Acquire the read lock on the cache key object.
    
    Overrides:
    
    acquireReadLock in class ConcurrencyManager
  - acquireReadLockNoWait
```
public boolean acquireReadLockNoWait()
```
    Acquire the read lock on the cache key object. Return true if acquired.
    
    Overrides:
    
    acquireReadLockNoWait in class ConcurrencyManager
  - clone
```
public java.lang.Object clone()
```
    INTERNAL: Clones itself.
    
    Overrides:
    
    clone in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object object)
```
    Determine if the receiver is equal to anObject. If anObject is a CacheKey, do further comparison, otherwise, return false.
    
    Overrides:
    
    equals in class java.lang.Object
    
    See Also:
    
    equals(CacheKey)
  - equals
```
public boolean equals(CacheKey key)
```
    Determine if the receiver is equal to key. Use an index compare, because it is much faster than enumerations.
  - getLastUpdatedQueryId
```
public long getLastUpdatedQueryId()
```
    INTERNAL: This method returns the system time in millis seconds at which this object was last refreshed CR #4365 CR #2698903 ... instead of using millis we will now use id's instead. Method renamed appropriately.
  - getKey
```
public java.lang.Object getKey()
```
  - getActiveThread
```
public java.lang.Thread getActiveThread()
```
    Return the active thread.
    
    Overrides:
    
    getActiveThread in class ConcurrencyManager
  - getObject
```
public java.lang.Object getObject()
```
  - getOwningMap
```
public IdentityMap getOwningMap()
```
  - getReadTime
```
public long getReadTime()
```
    INTERNAL: Return the current value of the Read Time variable
  - getRecord
```
public Record getRecord()
```
  - getWrapper
```
public java.lang.Object getWrapper()
```
  - getWrappedCacheKey
```
public CacheKey getWrappedCacheKey()
```
    If a Wrapper subclasses this CacheKey this method will be used to unwrap the cache key.
    
    Returns:
  - getWriteLockValue
```
public java.lang.Object getWriteLockValue()
```
  - hashCode
```
public int hashCode()
```
    Overrides hashCode() in Object to use the primaryKey's hashCode for storage in data structures.
    
    Overrides:
    
    hashCode in class java.lang.Object
  - hasProtectedForeignKeys
```
public boolean hasProtectedForeignKeys()
```
    Returns true if the protectedForeignKeys record is non-null and non-empty, false otherwise.
  - isIsolated
```
public boolean isIsolated()
```
    Returns true if this CacheKey is from an IsolatedClientSession
  - isWrapper
```
public boolean isWrapper()
```
    Returns true if this Instance of CacheKey is a wrapper and should be unwrapped before passing to IdentityMap APIs. Wrapped CacheKeys may be used in the Cache Interceptors.
  - getProtectedForeignKeys
```
public AbstractRecord getProtectedForeignKeys()
```
    INTERNAL: Return the FK cache
  - getInvalidationState
```
public int getInvalidationState()
```
    INTERNAL: Return the value of the invalidationState Variable The return value will be a constant CHECK_INVALIDATION_POLICY - The Invalidation policy is must be checked for this cache key's sate CACHE_KEY_INVALID - This cache key has been labeled invalid.
  - release
```
public void release()
```
    Release the lock on the cache key object.
    
    Overrides:
    
    release in class ConcurrencyManager
  - releaseDeferredLock
```
public void releaseDeferredLock()
```
    Release the deferred lock
    
    Overrides:
    
    releaseDeferredLock in class ConcurrencyManager
  - releaseReadLock
```
public void releaseReadLock()
```
    Release the read lock on the cache key object.
    
    Overrides:
    
    releaseReadLock in class ConcurrencyManager
  - removeFromOwningMap
```
public java.lang.Object removeFromOwningMap()
```
    Removes this cacheKey from the owning map
  - setInvalidationState
```
public void setInvalidationState(int invalidationState)
```
    INTERNAL: Set the value of the invalidationState Variable The possible values are from an enumeration of constants CHECK_INVALIDATION_POLICY - The invalidation policy is must be checked for this cache key's sate CACHE_KEY_INVALID - This cache key has been labelled invalid.
  - setLastUpdatedQueryId
```
public void setLastUpdatedQueryId(long id)
```
    INTERNAL: This method sets the system time in millis seconds at which this object was last refreshed CR #4365 CR #2698903 ... instead of using millis we will now use ids instead. Method renamed appropriately.
  - setKey
```
public void setKey(java.lang.Object key)
```
  - setObject
```
public void setObject(java.lang.Object object)
```
  - setOwningMap
```
public void setOwningMap(IdentityMap map)
```
  - setProtectedForeignKeys
```
public void setProtectedForeignKeys(AbstractRecord protectedForeignKeys)
```
  - setReadTime
```
public void setReadTime(long readTime)
```
    INTERNAL: Set the read time of this cache key
  - setRecord
```
public void setRecord(Record newRecord)
```
  - setWrapper
```
public void setWrapper(java.lang.Object wrapper)
```
  - setWriteLockValue
```
public void setWriteLockValue(java.lang.Object writeLockValue)
```
  - toString
```
public java.lang.String toString()
```
    Description copied from class: ConcurrencyManager
    
    Print the nested depth.
    
    Overrides:
    
    toString in class ConcurrencyManager
  - updateAccess
```
public void updateAccess()
```
    Notifies that cache key that it has been accessed. Allows the LRU sub-cache to be maintained.
  - setIsolated
```
public void setIsolated(boolean isIsolated)
```
  - setIsWrapper
```
public void setIsWrapper(boolean isWrapper)
```
  - getTransactionId
```
public java.lang.Object getTransactionId()
```
  - setTransactionId
```
public void setTransactionId(java.lang.Object transactionId)
```
  - waitForObject
```
public java.lang.Object waitForObject()
```

Class CacheKey

Field Summary

Fields inherited from class org.eclipse.persistence.internal.helper.ConcurrencyManager

Constructor Summary

Method Summary

Methods inherited from class org.eclipse.persistence.internal.helper.ConcurrencyManager

Methods inherited from class java.lang.Object

Field Detail

CHECK_INVALIDATION_POLICY

CACHE_KEY_INVALID

MAX_WAIT_TRIES

Constructor Detail

CacheKey

CacheKey

CacheKey

Method Detail

acquire

acquire

acquireNoWait

acquireIfUnownedNoWait

acquireNoWait

acquireWithWait

acquireDeferredLock

acquireLock

checkReadLock

checkDeferredLock

acquireReadLock

acquireReadLockNoWait

clone

equals

equals

getLastUpdatedQueryId

getKey

getActiveThread

getObject

getOwningMap

getReadTime

getRecord

getWrapper

getWrappedCacheKey

getWriteLockValue

hashCode

hasProtectedForeignKeys

isIsolated

isWrapper

getProtectedForeignKeys

getInvalidationState

release

releaseDeferredLock

releaseReadLock

removeFromOwningMap

setInvalidationState

setLastUpdatedQueryId

setKey

setObject

setOwningMap

setProtectedForeignKeys

setReadTime

setRecord

setWrapper

setWriteLockValue

toString

updateAccess

setIsolated

setIsWrapper

getTransactionId

setTransactionId

waitForObject