org.eclipse.persistence.internal.identitymaps

Class FullIdentityMap

java.lang.Object

org.eclipse.persistence.internal.identitymaps.AbstractIdentityMap

org.eclipse.persistence.internal.identitymaps.FullIdentityMap

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, IdentityMap

Direct Known Subclasses:

CacheIdentityMap, UnitOfWorkIdentityMap, WeakIdentityMap

public class FullIdentityMap
extends AbstractIdentityMap

Purpose: A FullIdentityMap holds all objects stored within it for the life of the application.

Responsibilities:

• Guarantees identity
• Holds all cached objects indefinitely.

Since:

TOPLink/Java 1.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FullIdentityMap() Used to allow subclasses to build different map type.
FullIdentityMap(int size, ClassDescriptor descriptor, AbstractSession session, boolean isolated)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() INTERNAL: Clones itself.
void	collectLocks(java.util.HashMap threadList) INTERNAL: Used to print all the Locks in every identity map in this session.
java.util.Enumeration	elements() Allow for the cache to be iterated on.
CacheKey	getCacheKey(java.lang.Object searchKey, boolean forMerge) Return the cache key matching the primary key of the searchKey.
java.util.Map<java.lang.Object,CacheKey>	getCacheKeys() Return the cache keys.
int	getSize() Return the number of CacheKeys in the IdentityMap.
int	getSize(java.lang.Class myClass, boolean recurse) Return the number of actual objects of type myClass in the IdentityMap.
java.util.Enumeration	keys() Allow for the cache keys to be iterated on.
java.util.Enumeration	keys(boolean checkReadLocks) Allow for the cache keys to be iterated on.
void	lazyRelationshipLoaded(java.lang.Object object, ValueHolderInterface valueHolder, ForeignReferenceMapping mapping) Notify the cache that a lazy relationship has been triggered in the object and the cache may need to be updated
CacheKey	put(java.lang.Object primaryKey, java.lang.Object object, java.lang.Object writeLockValue, long readTime) Store the object in the cache at its primary key.
java.lang.Object	remove(CacheKey cacheKey) Removes the CacheKey from the map.
void	resetCacheKey(CacheKey key, java.lang.Object object, java.lang.Object writeLockValue, long readTime) Reset the cache key with new data.

Methods inherited from class org.eclipse.persistence.internal.identitymaps.AbstractIdentityMap

acquireDeferredLock, acquireLock, acquireLockNoWait, acquireLockWithWait, acquireReadLockOnCacheKey, acquireReadLockOnCacheKeyNoWait, containsKey, createCacheKey, get, getAllCacheKeysFromIdentityMapWithEntityPK, getAllFromIdentityMapWithEntityPK, getCacheKeyForLock, getDefaultIdentityMapClass, getDescriptor, getDescriptorClass, getMaxSize, getWrapper, getWriteLockValue, release, remove, setDescriptor, setWrapper, setWriteLockValue, toString, updateMaxSize

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FullIdentityMap

public FullIdentityMap()

Used to allow subclasses to build different map type.

FullIdentityMap

public FullIdentityMap(int size,
                       ClassDescriptor descriptor,
                       AbstractSession session,
                       boolean isolated)

Method Detail

clone

public java.lang.Object clone()

INTERNAL: Clones itself.

Specified by:

clone in interface IdentityMap

Overrides:

clone in class AbstractIdentityMap

collectLocks

public void collectLocks(java.util.HashMap threadList)

INTERNAL: Used to print all the Locks in every identity map in this session.

Specified by:

collectLocks in interface IdentityMap

Specified by:

collectLocks in class AbstractIdentityMap

elements

public java.util.Enumeration elements()

Allow for the cache to be iterated on.

Specified by:

elements in interface IdentityMap

Specified by:

elements in class AbstractIdentityMap

getCacheKey

public CacheKey getCacheKey(java.lang.Object searchKey,
                            boolean forMerge)

Return the cache key matching the primary key of the searchKey. If no object for the key exists, return null.

Specified by:

getCacheKey in interface IdentityMap

Specified by:

getCacheKey in class AbstractIdentityMap

getCacheKeys

public java.util.Map<java.lang.Object,CacheKey> getCacheKeys()

Return the cache keys.

getSize

public int getSize()

Return the number of CacheKeys in the IdentityMap. This may contain weak referenced objects that have been garbage collected.

Specified by:

getSize in interface IdentityMap

Specified by:

getSize in class AbstractIdentityMap

getSize

public int getSize(java.lang.Class myClass,
                   boolean recurse)

Return the number of actual objects of type myClass in the IdentityMap. Recurse = true will include subclasses of myClass in the count.

Specified by:

getSize in interface IdentityMap

Specified by:

getSize in class AbstractIdentityMap

keys

public java.util.Enumeration keys()

Allow for the cache keys to be iterated on. Read locks will be checked.

Specified by:

keys in interface IdentityMap

Specified by:

keys in class AbstractIdentityMap

keys

public java.util.Enumeration keys(boolean checkReadLocks)

Allow for the cache keys to be iterated on.

Parameters:

checkReadLocks - - true if readLocks should be checked, false otherwise.

lazyRelationshipLoaded

public void lazyRelationshipLoaded(java.lang.Object object,
                                   ValueHolderInterface valueHolder,
                                   ForeignReferenceMapping mapping)

Notify the cache that a lazy relationship has been triggered in the object and the cache may need to be updated

put

public CacheKey put(java.lang.Object primaryKey,
                    java.lang.Object object,
                    java.lang.Object writeLockValue,
                    long readTime)

Store the object in the cache at its primary key. This is used by InsertObjectQuery, typically into the UnitOfWork identity map. Merge and reads do not use put, but acquireLock. Also an advanced (very) user API.

Specified by:

put in interface IdentityMap

Specified by:

put in class AbstractIdentityMap

Parameters:

primaryKey - is the primary key for the object.

object - is the domain object to cache.

writeLockValue - is the current write lock value of object, if null the version is ignored.

remove

public java.lang.Object remove(CacheKey cacheKey)

Removes the CacheKey from the map.

Specified by:

remove in interface IdentityMap

Specified by:

remove in class AbstractIdentityMap

Returns:

the object held within the CacheKey or null if no object cached for given cacheKey.

resetCacheKey

public void resetCacheKey(CacheKey key,
                          java.lang.Object object,
                          java.lang.Object writeLockValue,
                          long readTime)

Reset the cache key with new data.