Skip navigation links

oracle.toplink.descriptors
Class ClassDescriptor

java.lang.Object
RootDescriptor
oracle.toplink.descriptors.ClassDescriptor

Direct Known Subclasses:

EISDescriptor, RelationalDescriptor, XMLDescriptor

public class ClassDescriptor

extends RootDescriptor

Purpose: Abstract descriptor class for defining persistence information on a class. This class provides the data independent behavior and is subclassed, for relational, object-relational, EIS, XML, etc.

See Also:

RelationalDescriptor, ObjectRelationalDescriptor, EISDescriptor, XMLDescriptor, Serialized Form

Field Summary

static int	DO_NOT_SEND_CHANGES
static int	INVALIDATE_CHANGED_OBJECTS
static int	ISOLATE_CACHE_AFTER_TRANSACTION
static int	ISOLATE_CACHE_ALWAYS
static int	ISOLATE_NEW_DATA_AFTER_TRANSACTION
static int	SEND_NEW_OBJECTS_WITH_CHANGES
static int	SEND_OBJECT_CHANGES
static int	UNDEFINED_OBJECT_CHANGE_BEHAVIOR Configures how objects will be sent via cache synchronization, if synchronization is enabled.
static int	USE_SESSION_CACHE_AFTER_TRANSACTION Configures how the unit of work uses the session cache.

Constructor Summary

ClassDescriptor()
PUBLIC: Return a new descriptor.

Method Summary

void	addAbstractQueryKey(java.lang.String queryKeyName) PUBLIC: This method should only be used for interface descriptors.
void	addConstraintDependencies(java.lang.Class dependencies) ADVANCED: TopLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings.
DatabaseMapping	addDirectMapping(java.lang.String attributeName, java.lang.String fieldName) PUBLIC: Add a direct mapping to the receiver.
DatabaseMapping	addDirectMapping(java.lang.String attributeName, java.lang.String getMethodName, java.lang.String setMethodName, java.lang.String fieldName) PUBLIC: Add a direct mapping to the receiver.
void	addDirectQueryKey(java.lang.String queryKeyName, java.lang.String fieldName) PUBLIC: Add a query key to the descriptor.
DatabaseMapping	addMapping(DatabaseMapping mapping) PUBLIC: Add a database mapping to the receiver.
void	addMultipleTableForeignKeyFieldName(java.lang.String fieldNameInSourceTable, java.lang.String fieldNameInTargetTable) PUBLIC: This protocol can be used to associate multiple tables with foreign key information.
void	addMultipleTablePrimaryKeyFieldName(java.lang.String fieldNameInSourceTable, java.lang.String fieldNameInTargetTable) PUBLIC: This protocol can be used to map the primary key field names in a multiple table descriptor.
void	addPrimaryKeyField(DatabaseField field) ADVANCED: Specify the primary key field of the descriptors table.
void	addPrimaryKeyFieldName(java.lang.String fieldName) PUBLIC: Specify the primary key field of the descriptors table.
void	addQueryKey(QueryKey queryKey) PUBLIC: Add a query key to the descriptor.
void	alwaysConformResultsInUnitOfWork() PUBLIC: Used to set the descriptor to always conform in any unit of work query.
void	alwaysRefreshCache() PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCache(boolean) with an argument of true: it configures a Descriptor to always refresh the cache if data is received from the database by any query.
void	alwaysRefreshCacheOnRemote() PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCacheOnRemote(boolean) with an argument of true: it configures a Descriptor to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.
void	applyAmendmentMethod() ADVANCED: Call the descriptor amendment method.
void	createCopyPolicy(java.lang.String policyType) PUBLIC: Create a copy policy of the type passed in as a string.
void	createInstantiationPolicy(java.lang.String policyType) PUBLIC: Create a instantiation policy of the type passed in as a string.
void	descriptorIsAggregate() PUBLIC: Sets the descriptor to be an aggregate.
void	descriptorIsAggregateCollection() PUBLIC: Sets the descriptor to be part of an aggregate collection.
void	descriptorIsForInterface() PUBLIC: Sets the descriptor to be for an interface.
void	descriptorIsNormal() PUBLIC: Sets the descriptor to be normal.
void	disableCacheHits() PUBLIC: Allow for cache hits on primary key read object queries to be disabled.
void	disableCacheHitsOnRemote() PUBLIC: Allow for remote session cache hits on primary key read object queries to be disabled.
void	dontAlwaysConformResultsInUnitOfWork() PUBLIC: The descriptor is defined to not conform the results in unit of work in read query.
void	dontAlwaysRefreshCache() PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCache(boolean) with an argument of false: it ensures that a Descriptor is not configured to always refresh the cache if data is received from the database by any query.
void	dontAlwaysRefreshCacheOnRemote() PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCacheOnRemote(boolean) with an argument of false: it ensures that a Descriptor is not configured to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.
void	dontDisableCacheHits() PUBLIC: Allow for cache hits on primary key read object queries.
void	dontDisableCacheHitsOnRemote() PUBLIC: Allow for remote session cache hits on primary key read object queries.
void	dontOnlyRefreshCacheIfNewerVersion() PUBLIC: This method is the equivalent of calling setShouldOnlyRefreshCacheIfNewerVersion(boolean) with an argument of false: it ensures that a Descriptor is not configured to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).
java.lang.String	getAlias() PUBLIC: Get the alias
java.lang.Class	getAmendmentClass() PUBLIC: Return the amendment class.
java.lang.String	getAmendmentMethodName() PUBLIC: Return the amendment method.
CacheInvalidationPolicy	getCacheInvalidationPolicy() PUBLIC: Return the CacheInvalidationPolicy for this descriptor For uninitialized cache invalidation policies, this will return a NoExpiryCacheInvalidationPolicy
int	getCacheSynchronizationType() PUBLIC: Get a value indicating the type of cache synchronization that will be used on objects of this type.
CMPPolicy	getCMPPolicy() ADVANCED: Return the cmp descriptor that holds EJB CMP specific information.
java.util.Vector	getConstraintDependencies() ADVANCED: TopLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings.
CopyPolicy	getCopyPolicy() PUBLIC: Returns the copy policy.
DescriptorEventManager	getDescriptorEventManager() PUBLIC: Get the event manager for the descriptor.
InheritancePolicy	getDescriptorInheritancePolicy() PUBLIC: The inheritance policy is used to define how a descriptor takes part in inheritance.
DescriptorQueryManager	getDescriptorQueryManager() PUBLIC: Return the queryManager.
int	getDescriptorType() ADVANCED: return the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION)
FetchGroupManager	getFetchGroupManager() PUBLIC: Get the fetch group manager for the descriptor.
HistoryPolicy	getHistoryPolicy() PUBLIC: Return this descriptors HistoryPolicy.
int	getIdentityMapSize() PUBLIC: Return the size of the identity map.
InstantiationPolicy	getInstantiationPolicy() PUBLIC: Returns the instantiation policy.
InterfacePolicy	getInterfacePolicy() PUBLIC: Returns the InterfacePolicy.
java.lang.Class	getJavaClass() PUBLIC: Return the java class.
DatabaseMapping	getMappingForAttributeName(java.lang.String attributeName) PUBLIC: Returns the mapping associated with a given attribute name.
java.util.Vector	getMappings() PUBLIC: Returns mappings
oracle.toplink.descriptors.changetracking.ObjectChangePolicy	getObjectChangePolicy() PUBLIC: Return this objects ObjectChangePolicy.
OptimisticLockingPolicy	getOptimisticLockingPolicy() PUBLIC: Returns the OptimisticLockingPolicy.
java.util.Vector	getPrimaryKeyFieldNames() PUBLIC: Return the names of all the primary keys.
java.util.List	getPrimaryKeyFields() PUBLIC: Return all the primary key fields
java.util.Map	getProperties() PUBLIC: Returns the user defined properties.
java.lang.Object	getProperty(java.lang.String name) PUBLIC: Returns the descriptor property associated the given String.
QueryKey	getQueryKeyNamed(java.lang.String queryKeyName) PUBLIC: Return the query key with the specified name
java.util.Map	getQueryKeys() PUBLIC: Return the query keys.
int	getRemoteIdentityMapSize() PUBLIC: Return the size of the remote identity map.
ReturningPolicy	getReturningPolicy() PUBLIC: Return returning policy.
java.lang.String	getSequenceNumberFieldName() PUBLIC: Get sequence number field name
java.lang.String	getSequenceNumberName() PUBLIC: Get sequence number name
java.lang.String	getSessionName() PUBLIC: Return the name of the session local to this descriptor.
WrapperPolicy	getWrapperPolicy() ADVANCED: Return the WrapperPolicy for this descriptor.
boolean	hasCascadeLockingPolicies() PUBLIC:
boolean	hasInheritance() PUBLIC: Return if this descriptor is involved in inheritence, (is child or parent).
boolean	hasInterfacePolicy() PUBLIC: Return if this descriptor is involved in interface, (is child or parent).
boolean	hasMultipleTables() PUBLIC: Check if descriptor has multiple tables
boolean	hasReturningPolicy() PUBLIC: Return if this descriptor has Returning policy.
boolean	hasWrapperPolicy() PUBLIC: Return if a wrapper policy is used.
boolean	isAggregateCollectionDescriptor() PUBLIC: Return true if this descriptor is an aggregate collection descriptor
boolean	isAggregateDescriptor() PUBLIC: Return true if this descriptor is an aggregate descriptor
boolean	isChildDescriptor() PUBLIC: Return if the descriptor defines inheritence and is a child.
boolean	isDescriptorForCMP() PUBLIC: Return true if the descriptor is a CMP entity descriptor
boolean	isDescriptorForInterface() PUBLIC: Return if the java class is interface
boolean	isFullyInitialized() PUBLIC: Check if the descriptor is finished initialization.
boolean	isInterfaceChildDescriptor() PUBLIC: Return if the descriptor defines inheritence and is a child.
boolean	isIsolated() PUBLIC: Returns true if the descriptor represents an isolated class
boolean	isMultipleTableDescriptor() PUBLIC: Return if this descriptor has more than one table.
void	onlyRefreshCacheIfNewerVersion() PUBLIC: This method is the equivalent of calling setShouldOnlyRefreshCacheIfNewerVersion(boolean) with an argument of true: it configures a Descriptor to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field) and as long as one of the following is true: the Descriptor was configured by calling alwaysRefreshCache() or alwaysRefreshCacheOnRemote(), the query was configured by calling ObjectLevelReadQuery.refreshIdentityMapResult(), or the query was a call to Session.refreshObject(java.lang.Object) However, if a query hits the cache, data is not refreshed regardless of how this setting is configured.
void	removeProperty(java.lang.String property) PUBLIC: Remove the user defined property.
void	setAlias(java.lang.String alias) PUBLIC: Set the alias
void	setAmendmentClass(java.lang.Class amendmentClass) PUBLIC: Set the amendment class.
void	setAmendmentMethodName(java.lang.String amendmentMethodName) PUBLIC: Set the amendment method.
void	setCacheInvalidationPolicy(CacheInvalidationPolicy policy) PUBLIC: Set the Cache Invalidation Policy for this descriptor
void	setCacheSynchronizationType(int type) PUBLIC: Set the type of cache synchonization that will be used on objects of this type.
void	setCMPPolicy(CMPPolicy newCMPPolicy) ADVANCED: Set the cmp descriptor that holds EJB CMP specific information.
void	setCopyPolicy(CopyPolicy policy) PUBLIC: Set the copy policy.
void	setDescriptorType(int descriptorType) ADVANCED: set the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION)
void	setFetchGroupManager(FetchGroupManager fetchGroupManager) PUBLIC: Set the fetch group manager for the descriptor.
void	setHistoryPolicy(HistoryPolicy policy) PUBLIC: Set the HistoryPolicy for this descriptor.
void	setIdentityMapClass(java.lang.Class theIdentityMapClass) PUBLIC: Set the class of identity map to be used by this descriptor.
void	setIdentityMapSize(int identityMapSize) PUBLIC: Set the size of the identity map to be used by this descriptor.
void	setInheritancePolicy(InheritancePolicy inheritancePolicy) PUBLIC: Sets the inheritance policy.
void	setInstantiationPolicy(InstantiationPolicy instantiationPolicy) PUBLIC: Sets the instantiation policy.
void	setInterfacePolicy(InterfacePolicy interfacePolicy) PUBLIC: Sets the interface policy.
void	setIsIsolated(boolean isIsolated) PUBLIC: Used to set if the class that this descriptor represents should be isolated from the shared cache.
void	setJavaClass(java.lang.Class theJavaClass) PUBLIC: Set the Java class that this descriptor maps.
void	setJavaInterface(java.lang.Class theJavaInterface) PUBLIC: Sets the descriptor to be for an interface.
void	setObjectChangePolicy(oracle.toplink.descriptors.changetracking.ObjectChangePolicy policy) PUBLIC: Set the ObjectChangePolicy for this descriptor.
void	setOptimisticLockingPolicy(OptimisticLockingPolicy optimisticLockingPolicy) PUBLIC: Set the OptimisticLockingPolicy.
void	setPrimaryKeyFieldName(java.lang.String fieldName) PUBLIC: Specify the primary key field of the descriptors table.
void	setPrimaryKeyFieldNames(java.util.Vector primaryKeyFieldsName) PUBLIC: User can specify a vector of all the primary key field names if primary key is composite.
void	setProperty(java.lang.String name, java.lang.Object value) PUBLIC: Set the user defined property.
void	setReadOnly() PUBLIC: Set the descriptor to be read-only.
void	setRemoteIdentityMapClass(java.lang.Class theIdentityMapClass) PUBLIC: Set the class of identity map to be used by this descriptor.
void	setRemoteIdentityMapSize(int identityMapSize) PUBLIC: Set the size of the identity map to be used by this descriptor.
void	setReturningPolicy(ReturningPolicy returningPolicy) PUBLIC: Sets the returning policy.
void	setSequenceNumberFieldName(java.lang.String fieldName) PUBLIC: Set the sequence number field name.
void	setSequenceNumberName(java.lang.String name) PUBLIC: Set the sequence number name.
void	setShouldAlwaysConformResultsInUnitOfWork(boolean shouldAlwaysConformResultsInUnitOfWork) PUBLIC: set if the descriptor is defined to always conform the results in unit of work in read query.
void	setShouldAlwaysRefreshCache(boolean shouldAlwaysRefreshCache) PUBLIC: When the shouldAlwaysRefreshCache argument passed into this method is true, this method configures a Descriptor to always refresh the cache if data is received from the database by any query.
void	setShouldAlwaysRefreshCacheOnRemote(boolean shouldAlwaysRefreshCacheOnRemote) PUBLIC: When the shouldAlwaysRefreshCacheOnRemote argument passed into this method is true, this method configures a Descriptor to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.
void	setShouldBeReadOnly(boolean shouldBeReadOnly) PUBLIC: Define if the descriptor reference class is read-only
void	setShouldDisableCacheHits(boolean shouldDisableCacheHits) PUBLIC: Set if cache hits on primary key read object queries should be disabled.
void	setShouldDisableCacheHitsOnRemote(boolean shouldDisableCacheHitsOnRemote) PUBLIC: Set if the remote session cache hits on primary key read object queries is allowed or not.
void	setShouldOnlyRefreshCacheIfNewerVersion(boolean shouldOnlyRefreshCacheIfNewerVersion) PUBLIC: When the shouldOnlyRefreshCacheIfNewerVersion argument passed into this method is true, this method configures a Descriptor to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field) and as long as one of the following is true: the Descriptor was configured by calling alwaysRefreshCache() or alwaysRefreshCacheOnRemote(), the query was configured by calling ObjectLevelReadQuery.refreshIdentityMapResult(), or the query was a call to Session.refreshObject(java.lang.Object) However, if a query hits the cache, data is not refreshed regardless of how this setting is configured.
void	setShouldOrderMappings(boolean shouldOrderMappings) PUBLIC: This is set to turn off the ordering of mappings.
void	setWrapperPolicy(WrapperPolicy wrapperPolicy) ADVANCED: Sets the WrapperPolicy for this descriptor.
boolean	shouldAlwaysConformResultsInUnitOfWork() PUBLIC: Return if the descriptor is defined to always conform the results in unit of work in read query.
boolean	shouldAlwaysRefreshCache() PUBLIC: This method returns true if the Descriptor is configured to always refresh the cache if data is received from the database by any query.
boolean	shouldAlwaysRefreshCacheOnRemote() PUBLIC: This method returns true if the Descriptor is configured to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.
boolean	shouldBeReadOnly() PUBLIC: Return if the descriptor reference class is defined as read-only
boolean	shouldDisableCacheHits() PUBLIC: Return if for cache hits on primary key read object queries to be disabled.
boolean	shouldDisableCacheHitsOnRemote() PUBLIC: Return if the remote server session cache hits on primary key read object queries is aloowed or not.
boolean	shouldOnlyRefreshCacheIfNewerVersion() PUBLIC: This method returns true if the Descriptor is configured to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).
boolean	shouldUseCacheIdentityMap() PUBLIC: Return true if this descriptor is using CacheIdentityMap
boolean	shouldUseFullIdentityMap() PUBLIC: Return true if this descriptor is using FullIdentityMap
boolean	shouldUseHardCacheWeakIdentityMap() PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap.
boolean	shouldUseNoIdentityMap() PUBLIC: Return true if this descriptor is using NoIdentityMap
boolean	shouldUseRemoteCacheIdentityMap() PUBLIC: Return true if this descriptor is using CacheIdentityMap
boolean	shouldUseRemoteFullIdentityMap() PUBLIC: Return true if this descriptor is using FullIdentityMap
boolean	shouldUseRemoteHardCacheWeakIdentityMap() PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap
boolean	shouldUseRemoteNoIdentityMap() PUBLIC: Return true if this descriptor is using NoIdentityMap
boolean	shouldUseRemoteSoftCacheWeakIdentityMap() PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap
boolean	shouldUseRemoteWeakIdentityMap() PUBLIC: Return true if this descriptor is using WeakIdentityMap
boolean	shouldUseSoftCacheWeakIdentityMap() PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap.
boolean	shouldUseWeakIdentityMap() PUBLIC: Return true if this descriptor is using WeakIdentityMap
void	useAllFieldsLocking() PUBLIC: Set the locking policy an all fields locking policy.
void	useCacheIdentityMap() PUBLIC: Set the class of identity map to be the cache identity map.
void	useChangedFieldsLocking() PUBLIC: Set the locking policy a changed fields locking policy.
void	useCloneCopyPolicy() PUBLIC: Specifies that the creation of clones within a unit of work is done by sending the #clone() method to the original object.
void	useCloneCopyPolicy(java.lang.String cloneMethodName) PUBLIC: Specifies that the creation of clones within a unit of work is done by sending the cloneMethodName method to the original object.
void	useDefaultConstructorInstantiationPolicy() PUBLIC: Use the default constructor to create new instances of objects built from the database.
void	useFactoryInstantiationPolicy(java.lang.Class factoryClass, java.lang.String methodName) PUBLIC: Use an object factory to create new instances of objects built from the database.
void	useFactoryInstantiationPolicy(java.lang.Class factoryClass, java.lang.String methodName, java.lang.String factoryMethodName) PUBLIC: Use an object factory to create new instances of objects built from the database.
void	useFactoryInstantiationPolicy(java.lang.Object factory, java.lang.String methodName) PUBLIC: Use an object factory to create new instances of objects built from the database.
void	useFactoryInstantiationPolicy(java.lang.String factoryClassName, java.lang.String methodName) PUBLIC: Set the factory class name, used by the MW.
void	useFactoryInstantiationPolicy(java.lang.String factoryClassName, java.lang.String methodName, java.lang.String factoryMethodName) PUBLIC: Set the factory class name, used by the MW.
void	useFullIdentityMap() PUBLIC: Set the class of identity map to be the full identity map.
void	useHardCacheWeakIdentityMap() PUBLIC: Set the class of identity map to be the hard cache weak identity map.
void	useInstantiationCopyPolicy() PUBLIC: Specifies that the creation of clones within a unit of work is done by building a new instance using the technique indicated by the descriptor's instantiation policy (which by default is to use the the default constructor).
void	useMethodInstantiationPolicy(java.lang.String staticMethodName) PUBLIC: Use the specified static method to create new instances of objects built from the database.
void	useNoIdentityMap() PUBLIC: Set the class of identity map to be the no identity map.
void	useRemoteCacheIdentityMap() PUBLIC: Set the class of identity map to be the cache identity map.
void	useRemoteFullIdentityMap() PUBLIC: Set the class of identity map to be the full identity map.
void	useRemoteHardCacheWeakIdentityMap() PUBLIC: Set the class of identity map to be the hard cache weak identity map.
void	useRemoteNoIdentityMap() PUBLIC: Set the class of identity map to be the no identity map.
void	useRemoteSoftCacheWeakIdentityMap() PUBLIC: Set the class of identity map to be the soft cache weak identity map.
void	useRemoteWeakIdentityMap() PUBLIC: Set the class of identity map to be the weak identity map.
void	useSelectedFieldsLocking(java.util.Vector fieldNames) PUBLIC: Set the locking policy a selected fields locking policy.
boolean	usesFieldLocking() PUBLIC: Return true if the receiver uses either all or changed fields for optimistic locking.
void	useSoftCacheWeakIdentityMap() PUBLIC: Set the class of identity map to be the soft cache weak identity map.
boolean	usesOptimisticLocking() PUBLIC: Return true if the receiver uses write (optimistic) locking.
boolean	usesSequenceNumbers() PUBLIC: Return true if the receiver uses sequence numbers.
void	useTimestampLocking(java.lang.String writeLockFieldName) PUBLIC: Use the Timestamps locking policy and storing the value in the cache key #see useVersionLocking(String)
void	useTimestampLocking(java.lang.String writeLockFieldName, boolean shouldStoreInCache) PUBLIC: Set the locking policy to use timestamp version locking.
void	useVersionLocking(java.lang.String writeLockFieldName) PUBLIC: Default to use the version locking policy and storing the value in the cache key #see useVersionLocking(String)
void	useVersionLocking(java.lang.String writeLockFieldName, boolean shouldStoreInCache) PUBLIC: Set the locking policy to use numeric version locking.
void	useWeakIdentityMap() PUBLIC: Set the class of identity map to be the weak identity map.

Methods inherited from class java.lang.Object

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

Field Detail

UNDEFINED_OBJECT_CHANGE_BEHAVIOR

public static final int UNDEFINED_OBJECT_CHANGE_BEHAVIOR

Configures how objects will be sent via cache synchronization, if synchronization is enabled.

See Also:

Constant Field Values

SEND_OBJECT_CHANGES

public static final int SEND_OBJECT_CHANGES

See Also:

Constant Field Values

INVALIDATE_CHANGED_OBJECTS

public static final int INVALIDATE_CHANGED_OBJECTS

See Also:

Constant Field Values

SEND_NEW_OBJECTS_WITH_CHANGES

public static final int SEND_NEW_OBJECTS_WITH_CHANGES

See Also:

Constant Field Values

DO_NOT_SEND_CHANGES

public static final int DO_NOT_SEND_CHANGES

See Also:

Constant Field Values

USE_SESSION_CACHE_AFTER_TRANSACTION

public static final int USE_SESSION_CACHE_AFTER_TRANSACTION

Configures how the unit of work uses the session cache.

See Also:

Constant Field Values

ISOLATE_NEW_DATA_AFTER_TRANSACTION

public static final int ISOLATE_NEW_DATA_AFTER_TRANSACTION

See Also:

Constant Field Values

ISOLATE_CACHE_AFTER_TRANSACTION

public static final int ISOLATE_CACHE_AFTER_TRANSACTION

See Also:

Constant Field Values

ISOLATE_CACHE_ALWAYS

public static final int ISOLATE_CACHE_ALWAYS

See Also:

Constant Field Values

Constructor Detail

ClassDescriptor

public ClassDescriptor()

PUBLIC: Return a new descriptor.

Method Detail

addAbstractQueryKey

public void addAbstractQueryKey(java.lang.String queryKeyName)

PUBLIC: This method should only be used for interface descriptors. It adds an abstract query key to the interface descriptor. Any implementors of that interface must define the query key defined by this abstract query key.

addConstraintDependencies

public void addConstraintDependencies(java.lang.Class dependencies)

ADVANCED: TopLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. In some case when 1:1 are not defined it may be required to tell the descriptor about a constraint, this defines that this descriptor has a foreign key constraint to another class and must be inserted after instances of the other class.

addDirectMapping

public DatabaseMapping addDirectMapping(java.lang.String attributeName,
                                        java.lang.String fieldName)

PUBLIC: Add a direct mapping to the receiver. The new mapping specifies that an instance variable of the class of objects which the receiver describes maps in the default manner for its type to the indicated database field.

Returns:

The newly created DatabaseMapping is returned.

addDirectMapping

public DatabaseMapping addDirectMapping(java.lang.String attributeName,
                                        java.lang.String getMethodName,
                                        java.lang.String setMethodName,
                                        java.lang.String fieldName)

PUBLIC: Add a direct mapping to the receiver. The new mapping specifies that a variable accessed by the get and set methods of the class of objects which the receiver describes maps in the default manner for its type to the indicated database field.

addDirectQueryKey

public void addDirectQueryKey(java.lang.String queryKeyName,
                              java.lang.String fieldName)

PUBLIC: Add a query key to the descriptor. Query keys define Java aliases to database fields.

addMapping

public DatabaseMapping addMapping(DatabaseMapping mapping)

PUBLIC: Add a database mapping to the receiver. Perform any required initialization of both the mapping and the receiving descriptor as a result of adding the new mapping.

addMultipleTableForeignKeyFieldName

public void addMultipleTableForeignKeyFieldName(java.lang.String fieldNameInSourceTable,
                                                java.lang.String fieldNameInTargetTable)
                                         throws DescriptorException

PUBLIC: This protocol can be used to associate multiple tables with foreign key information. The join criteria will be generated based on the fields provided. By default TopLink associates multiple tables using a primary key join where the primary keys fields are named the same.

Throws:

DescriptorException

addMultipleTablePrimaryKeyFieldName

public void addMultipleTablePrimaryKeyFieldName(java.lang.String fieldNameInSourceTable,
                                                java.lang.String fieldNameInTargetTable)
                                         throws DescriptorException

PUBLIC: This protocol can be used to map the primary key field names in a multiple table descriptor. By default TopLink assumes that all of the primary key fields are named the same.

Throws:

DescriptorException

addPrimaryKeyFieldName

public void addPrimaryKeyFieldName(java.lang.String fieldName)

PUBLIC: Specify the primary key field of the descriptors table. This should be called for each field that makes up the primary key of the table. If the descriptor has many tables, this must be the primary key in the first table, if the other tables have the same primary key nothing else is required, otherwise a primary key/foreign key field mapping must be provided for each of the other tables.

See Also:

#addMultipleTableForeignKeyFieldName(String, String);

addPrimaryKeyField

public void addPrimaryKeyField(DatabaseField field)

ADVANCED: Specify the primary key field of the descriptors table. This should be called for each field that makes up the primary key of the table. This can be used for advanced field types, such as XML nodes, or to set the field type.

addQueryKey

public void addQueryKey(QueryKey queryKey)

PUBLIC: Add a query key to the descriptor. Query keys define Java aliases to database fields.

alwaysConformResultsInUnitOfWork

public void alwaysConformResultsInUnitOfWork()

PUBLIC: Used to set the descriptor to always conform in any unit of work query.

alwaysRefreshCache

public void alwaysRefreshCache()

PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCache(boolean) with an argument of true: it configures a Descriptor to always refresh the cache if data is received from the database by any query.

However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHits() method.

Also note that the UnitOfWork will not refresh its registered objects.

Use this property with caution because it can lead to poor performance and may refresh on queries when it is not desired. Normally, if you require fresh data, it is better to configure a query with ObjectLevelReadQuery.refreshIdentityMapResult(). To ensure that refreshes are only done when required, use this method in conjunction with onlyRefreshCacheIfNewerVersion().

See Also:

dontAlwaysRefreshCache()

alwaysRefreshCacheOnRemote

public void alwaysRefreshCacheOnRemote()

PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCacheOnRemote(boolean) with an argument of true: it configures a Descriptor to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.

However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHitsOnRemote() method.

Also note that the UnitOfWork will not refresh its registered objects.

Use this property with caution because it can lead to poor performance and may refresh on queries when it is not desired. Normally, if you require fresh data, it is better to configure a query with ObjectLevelReadQuery.refreshIdentityMapResult(). To ensure that refreshes are only done when required, use this method in conjunction with #refreshOnlyIfNewerVersion.

See Also:

dontAlwaysRefreshCacheOnRemote()

applyAmendmentMethod

public void applyAmendmentMethod()

ADVANCED: Call the descriptor amendment method. This is called while loading or creating a descriptor that has an amendment method defined.

createCopyPolicy

public void createCopyPolicy(java.lang.String policyType)

PUBLIC: Create a copy policy of the type passed in as a string.

createInstantiationPolicy

public void createInstantiationPolicy(java.lang.String policyType)

PUBLIC: Create a instantiation policy of the type passed in as a string.

descriptorIsAggregate

public void descriptorIsAggregate()

PUBLIC: Sets the descriptor to be an aggregate. An aggregate descriptor is contained within another descriptor's table. Aggregate descriptors are insert/updated/deleted with their owner and cannot exist without their owner as they share the same row. Aggregates are not cached (they are cached as part of their owner) and cannot be read/written/deleted/registered. All aggregate descriptors must call this.

descriptorIsAggregateCollection

public void descriptorIsAggregateCollection()

PUBLIC: Sets the descriptor to be part of an aggregate collection. An aggregate collection descriptor stored in a seperate table but some of the fields (the primary key) comes from its owner. Aggregate collection descriptors are insert/updated/deleted with their owner and cannot exist without their owner as they share the primary key. Aggregate collections are not cached (they are cached as part of their owner) and cannot be read/written/deleted/registered. All aggregate collection descriptors must call this.

descriptorIsForInterface

public void descriptorIsForInterface()

PUBLIC: Sets the descriptor to be for an interface. An interface descriptor allows for other classes to reference an interface or one of serveral other classes. The implementor classes can be completely unrelated in term of the database stored in distinct tables. Queries can also be done for the interface which will query each of the implementor classes. An interface descriptor cannot define any mappings as an interface is just API and not state, a interface descriptor should define the common query key of its implementors to allow querying. An interface descriptor also does not define a primary key or table or other settings. If an interface only has a single implementor (i.e. a classes public interface or remote) then an interface descriptor should not be defined for it and relationships should be to the implementor class not the interface, in this case the implementor class can add the interface through its interface policy to map queries on the interface to it.

descriptorIsNormal

public void descriptorIsNormal()

PUBLIC: Sets the descriptor to be normal. This is the default and means the descriptor is not aggregate or for an interface.

disableCacheHits

public void disableCacheHits()

PUBLIC: Allow for cache hits on primary key read object queries to be disabled. This can be used with alwaysRefreshCache() or alwaysRefreshCacheOnRemote() to ensure queries always go to the database.

disableCacheHitsOnRemote

public void disableCacheHitsOnRemote()

PUBLIC: Allow for remote session cache hits on primary key read object queries to be disabled. This can be used with alwaysRefreshCacheOnRemote() to ensure queries always go to the server sesion cache.

See Also:

alwaysRefreshCacheOnRemote()

dontAlwaysConformResultsInUnitOfWork

public void dontAlwaysConformResultsInUnitOfWork()

PUBLIC: The descriptor is defined to not conform the results in unit of work in read query. Default.

dontAlwaysRefreshCache

public void dontAlwaysRefreshCache()

PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCache(boolean) with an argument of false: it ensures that a Descriptor is not configured to always refresh the cache if data is received from the database by any query.

See Also:

alwaysRefreshCache()

dontAlwaysRefreshCacheOnRemote

public void dontAlwaysRefreshCacheOnRemote()

PUBLIC: This method is the equivalent of calling setShouldAlwaysRefreshCacheOnRemote(boolean) with an argument of false: it ensures that a Descriptor is not configured to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.

See Also:

alwaysRefreshCacheOnRemote()

dontDisableCacheHits

public void dontDisableCacheHits()

PUBLIC: Allow for cache hits on primary key read object queries.

See Also:

disableCacheHits()

dontDisableCacheHitsOnRemote

public void dontDisableCacheHitsOnRemote()

PUBLIC: Allow for remote session cache hits on primary key read object queries.

See Also:

disableCacheHitsOnRemote()

dontOnlyRefreshCacheIfNewerVersion

public void dontOnlyRefreshCacheIfNewerVersion()

PUBLIC: This method is the equivalent of calling setShouldOnlyRefreshCacheIfNewerVersion(boolean) with an argument of false: it ensures that a Descriptor is not configured to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).

See Also:

onlyRefreshCacheIfNewerVersion()

getAlias

public java.lang.String getAlias()

PUBLIC: Get the alias

getAmendmentClass

public java.lang.Class getAmendmentClass()

PUBLIC: Return the amendment class. The amendment method will be called on the class before initialization to allow for it to initialize the descriptor. The method must be a public static method on the class.

getAmendmentMethodName

public java.lang.String getAmendmentMethodName()

PUBLIC: Return the amendment method. This will be called on the amendment class before initialization to allow for it to initialize the descriptor. The method must be a public static method on the class.

getObjectChangePolicy

public oracle.toplink.descriptors.changetracking.ObjectChangePolicy getObjectChangePolicy()

PUBLIC: Return this objects ObjectChangePolicy.

getHistoryPolicy

public HistoryPolicy getHistoryPolicy()

PUBLIC: Return this descriptors HistoryPolicy.

getCacheInvalidationPolicy

public CacheInvalidationPolicy getCacheInvalidationPolicy()

PUBLIC: Return the CacheInvalidationPolicy for this descriptor For uninitialized cache invalidation policies, this will return a NoExpiryCacheInvalidationPolicy

Returns:

CacheInvalidationPolicy

See Also:

CacheInvalidationPolicy

getCacheSynchronizationType

public int getCacheSynchronizationType()

PUBLIC: Get a value indicating the type of cache synchronization that will be used on objects of this type. Possible values are: SEND_OBJECT_CHANGES INVALIDATE_CHANGED_OBJECTS SEND_NEW_OBJECTS+WITH_CHANGES DO_NOT_SEND_CHANGES

Returns:

int

getConstraintDependencies

public java.util.Vector getConstraintDependencies()

ADVANCED: TopLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. In some case when 1:1 are not defined it may be required to tell the descriptor about a constraint, this defines that this descriptor has a foreign key constraint to another class and must be inserted after instances of the other class.

getCopyPolicy

public CopyPolicy getCopyPolicy()

PUBLIC: Returns the copy policy.

getDescriptorType

public int getDescriptorType()

ADVANCED: return the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION)

getDescriptorEventManager

public DescriptorEventManager getDescriptorEventManager()

PUBLIC: Get the event manager for the descriptor. The event manager is responsible for managing the pre/post selectors.

getIdentityMapSize

public int getIdentityMapSize()

PUBLIC: Return the size of the identity map.

getDescriptorInheritancePolicy

public InheritancePolicy getDescriptorInheritancePolicy()

PUBLIC: The inheritance policy is used to define how a descriptor takes part in inheritance. All inheritance properties for both child and parent classes is configured in inheritance policy. Caution must be used in using this method as it lazy initializes an inheritance policy. Calling this on a descriptor that does not use inheritance will cause problems, #hasInheritance() must always first be called.

getInstantiationPolicy

public InstantiationPolicy getInstantiationPolicy()

PUBLIC: Returns the instantiation policy.

getInterfacePolicy

public InterfacePolicy getInterfacePolicy()

PUBLIC: Returns the InterfacePolicy. The interface policy allows for a descriptor's public and variable interfaces to be defined. Caution must be used in using this method as it lazy initializes an interface policy. Calling this on a descriptor that does not use interfaces will cause problems, #hasInterfacePolicy() must always first be called.

getJavaClass

public java.lang.Class getJavaClass()

PUBLIC: Return the java class.

getMappingForAttributeName

public DatabaseMapping getMappingForAttributeName(java.lang.String attributeName)

PUBLIC: Returns the mapping associated with a given attribute name. This can be used to find a descriptors mapping in a amendment method before the descriptor has been initialized.

getMappings

public java.util.Vector getMappings()

PUBLIC: Returns mappings

getOptimisticLockingPolicy

public OptimisticLockingPolicy getOptimisticLockingPolicy()

PUBLIC: Returns the OptimisticLockingPolicy. By default this is an instance of VersionLockingPolicy.

getPrimaryKeyFieldNames

public java.util.Vector getPrimaryKeyFieldNames()

PUBLIC: Return the names of all the primary keys.

getPrimaryKeyFields

public java.util.List getPrimaryKeyFields()

PUBLIC: Return all the primary key fields

getProperties

public java.util.Map getProperties()

PUBLIC: Returns the user defined properties.

getProperty

public java.lang.Object getProperty(java.lang.String name)

PUBLIC: Returns the descriptor property associated the given String.

getQueryKeyNamed

public QueryKey getQueryKeyNamed(java.lang.String queryKeyName)

PUBLIC: Return the query key with the specified name

getQueryKeys

public java.util.Map getQueryKeys()

PUBLIC: Return the query keys.

getDescriptorQueryManager

public DescriptorQueryManager getDescriptorQueryManager()

PUBLIC: Return the queryManager. The query manager can be used to specify customization of the SQL that TopLink generates for this descriptor.

getRemoteIdentityMapSize

public int getRemoteIdentityMapSize()

PUBLIC: Return the size of the remote identity map.

getReturningPolicy

public ReturningPolicy getReturningPolicy()

PUBLIC: Return returning policy.

getSequenceNumberFieldName

public java.lang.String getSequenceNumberFieldName()

PUBLIC: Get sequence number field name

getSequenceNumberName

public java.lang.String getSequenceNumberName()

PUBLIC: Get sequence number name

getSessionName

public java.lang.String getSessionName()

PUBLIC: Return the name of the session local to this descriptor. This is used by the session broker.

getWrapperPolicy

public WrapperPolicy getWrapperPolicy()

ADVANCED: Return the WrapperPolicy for this descriptor. This advacned feature can be used to wrap objects with other classes such as CORBA TIE objects or EJBs.

hasCascadeLockingPolicies

public boolean hasCascadeLockingPolicies()

PUBLIC:

hasInheritance

public boolean hasInheritance()

PUBLIC: Return if this descriptor is involved in inheritence, (is child or parent).

hasInterfacePolicy

public boolean hasInterfacePolicy()

PUBLIC: Return if this descriptor is involved in interface, (is child or parent).

hasMultipleTables

public boolean hasMultipleTables()

PUBLIC: Check if descriptor has multiple tables

hasReturningPolicy

public boolean hasReturningPolicy()

PUBLIC: Return if this descriptor has Returning policy.

hasWrapperPolicy

public boolean hasWrapperPolicy()

PUBLIC: Return if a wrapper policy is used.

isAggregateCollectionDescriptor

public boolean isAggregateCollectionDescriptor()

PUBLIC: Return true if this descriptor is an aggregate collection descriptor

isAggregateDescriptor

public boolean isAggregateDescriptor()

PUBLIC: Return true if this descriptor is an aggregate descriptor

isChildDescriptor

public boolean isChildDescriptor()

PUBLIC: Return if the descriptor defines inheritence and is a child.

isDescriptorForInterface

public boolean isDescriptorForInterface()

PUBLIC: Return if the java class is interface

isFullyInitialized

public boolean isFullyInitialized()

PUBLIC: Check if the descriptor is finished initialization.

isInterfaceChildDescriptor

public boolean isInterfaceChildDescriptor()

PUBLIC: Return if the descriptor defines inheritence and is a child.

isIsolated

public boolean isIsolated()

PUBLIC: Returns true if the descriptor represents an isolated class

isMultipleTableDescriptor

public boolean isMultipleTableDescriptor()

PUBLIC: Return if this descriptor has more than one table.

onlyRefreshCacheIfNewerVersion

public void onlyRefreshCacheIfNewerVersion()

PUBLIC: This method is the equivalent of calling setShouldOnlyRefreshCacheIfNewerVersion(boolean) with an argument of true: it configures a Descriptor to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field) and as long as one of the following is true:

• the Descriptor was configured by calling alwaysRefreshCache() or alwaysRefreshCacheOnRemote(),
• the query was configured by calling ObjectLevelReadQuery.refreshIdentityMapResult(), or
• the query was a call to Session.refreshObject(java.lang.Object)

However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHits() method.

Also note that the UnitOfWork will not refresh its registered objects.

See Also:

dontOnlyRefreshCacheIfNewerVersion()

removeProperty

public void removeProperty(java.lang.String property)

PUBLIC: Remove the user defined property.

setAlias

public void setAlias(java.lang.String alias)

PUBLIC: Set the alias

setAmendmentClass

public void setAmendmentClass(java.lang.Class amendmentClass)

PUBLIC: Set the amendment class. The amendment method will be called on the class before initialization to allow for it to initialize the descriptor. The method must be a public static method on the class.

setAmendmentMethodName

public void setAmendmentMethodName(java.lang.String amendmentMethodName)

PUBLIC: Set the amendment method. This will be called on the amendment class before initialization to allow for it to initialize the descriptor. The method must be a public static method on the class.

setCacheSynchronizationType

public void setCacheSynchronizationType(int type)

PUBLIC: Set the type of cache synchonization that will be used on objects of this type. Possible values are: SEND_OBJECT_CHANGES INVALIDATE_CHANGED_OBJECTS SEND_NEW_OBJECTS+WITH_CHANGES DO_NOT_SEND_CHANGES Note: Cache Synchronization type cannot be altered for descriptors that are set as isolated using the setIsIsolated method.

Parameters:

type - int The synchronization type for this descriptor

setObjectChangePolicy

public void setObjectChangePolicy(oracle.toplink.descriptors.changetracking.ObjectChangePolicy policy)

PUBLIC: Set the ObjectChangePolicy for this descriptor.

setHistoryPolicy

public void setHistoryPolicy(HistoryPolicy policy)

PUBLIC: Set the HistoryPolicy for this descriptor.

setCacheInvalidationPolicy

public void setCacheInvalidationPolicy(CacheInvalidationPolicy policy)

PUBLIC: Set the Cache Invalidation Policy for this descriptor

See Also:

CacheInvalidationPolicy

setCopyPolicy

public void setCopyPolicy(CopyPolicy policy)

PUBLIC: Set the copy policy. This would be 'protected' but the EJB stuff in another package needs it to be public

setDescriptorType

public void setDescriptorType(int descriptorType)

ADVANCED: set the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION)

setIdentityMapClass

public void setIdentityMapClass(java.lang.Class theIdentityMapClass)

PUBLIC: Set the class of identity map to be used by this descriptor. The default is the "FullIdentityMap".

setIdentityMapSize

public void setIdentityMapSize(int identityMapSize)

PUBLIC: Set the size of the identity map to be used by this descriptor. The default is the 100.

setInheritancePolicy

public void setInheritancePolicy(InheritancePolicy inheritancePolicy)

PUBLIC: Sets the inheritance policy.

setInstantiationPolicy

public void setInstantiationPolicy(InstantiationPolicy instantiationPolicy)

PUBLIC: Sets the instantiation policy.

setInterfacePolicy

public void setInterfacePolicy(InterfacePolicy interfacePolicy)

PUBLIC: Sets the interface policy.

setReturningPolicy

public void setReturningPolicy(ReturningPolicy returningPolicy)

PUBLIC: Sets the returning policy.

setIsIsolated

public void setIsIsolated(boolean isIsolated)

PUBLIC: Used to set if the class that this descriptor represents should be isolated from the shared cache. Note: Calling this method with true will also set the cacheSynchronizationType to DO_NOT_SEND_CHANGES since isolated objects cannot be sent by TopLink cache synchronization.

setJavaClass

public void setJavaClass(java.lang.Class theJavaClass)

PUBLIC: Set the Java class that this descriptor maps. Every descriptor maps one and only one class.

setJavaInterface

public void setJavaInterface(java.lang.Class theJavaInterface)

PUBLIC: Sets the descriptor to be for an interface. An interface descriptor allows for other classes to reference an interface or one of serveral other classes. The implementor classes can be completely unrelated in term of the database stored in distinct tables. Queries can also be done for the interface which will query each of the implementor classes. An interface descriptor cannot define any mappings as an interface is just API and not state, a interface descriptor should define the common query key of its implementors to allow querying. An interface descriptor also does not define a primary key or table or other settings. If an interface only has a single implementor (i.e. a classes public interface or remote) then an interface descriptor should not be defined for it and relationships should be to the implementor class not the interface, in this case the implementor class can add the interface through its interface policy to map queries on the interface to it.

setOptimisticLockingPolicy

public void setOptimisticLockingPolicy(OptimisticLockingPolicy optimisticLockingPolicy)

PUBLIC: Set the OptimisticLockingPolicy. This can be one of the provided locking policies or a user defined policy.

See Also:

VersionLockingPolicy, TimestampLockingPolicy, FieldsLockingPolicy

setPrimaryKeyFieldName

public void setPrimaryKeyFieldName(java.lang.String fieldName)

PUBLIC: Specify the primary key field of the descriptors table. This should only be called if it is a singlton primary key field, otherwise addPrimaryKeyFieldName should be called. If the descriptor has many tables, this must be the primary key in all of the tables.

See Also:

addPrimaryKeyFieldName(String)

setPrimaryKeyFieldNames

public void setPrimaryKeyFieldNames(java.util.Vector primaryKeyFieldsName)

PUBLIC: User can specify a vector of all the primary key field names if primary key is composite.

See Also:

addPrimaryKeyFieldName(String)

setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object value)

PUBLIC: Set the user defined property.

setRemoteIdentityMapClass

public void setRemoteIdentityMapClass(java.lang.Class theIdentityMapClass)

PUBLIC: Set the class of identity map to be used by this descriptor. The default is the "FullIdentityMap".

setRemoteIdentityMapSize

public void setRemoteIdentityMapSize(int identityMapSize)

PUBLIC: Set the size of the identity map to be used by this descriptor. The default is the 100.

setSequenceNumberFieldName

public void setSequenceNumberFieldName(java.lang.String fieldName)

PUBLIC: Set the sequence number field name. This is the field in the descriptors table that needs its value to be generated. This is normally the primary key field of the descriptor.

setSequenceNumberName

public void setSequenceNumberName(java.lang.String name)

PUBLIC: Set the sequence number name. This is the seq_name part of the row stored in the sequence table for this descriptor. If using Oracle native sequencing this is the name of the Oracle sequence object. If using Sybase native sequencing this name has no meaning, but should still be set for compatibility. The name does not have to be unique among descriptors, as having descriptors share sequences can improve pre-allocation performance.

setShouldAlwaysConformResultsInUnitOfWork

public void setShouldAlwaysConformResultsInUnitOfWork(boolean shouldAlwaysConformResultsInUnitOfWork)

PUBLIC: set if the descriptor is defined to always conform the results in unit of work in read query.

setShouldAlwaysRefreshCache

public void setShouldAlwaysRefreshCache(boolean shouldAlwaysRefreshCache)

PUBLIC: When the shouldAlwaysRefreshCache argument passed into this method is true, this method configures a Descriptor to always refresh the cache if data is received from the database by any query.

However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHits() method.

Also note that the UnitOfWork will not refresh its registered objects.

Use this property with caution because it can lead to poor performance and may refresh on queries when it is not desired. Normally, if you require fresh data, it is better to configure a query with ObjectLevelReadQuery.refreshIdentityMapResult(). To ensure that refreshes are only done when required, use this method in conjunction with onlyRefreshCacheIfNewerVersion().

When the shouldAlwaysRefreshCache argument passed into this method is false, this method ensures that a Descriptor is not configured to always refresh the cache if data is received from the database by any query.

See Also:

alwaysRefreshCache(), dontAlwaysRefreshCache()

setShouldAlwaysRefreshCacheOnRemote

public void setShouldAlwaysRefreshCacheOnRemote(boolean shouldAlwaysRefreshCacheOnRemote)

PUBLIC: When the shouldAlwaysRefreshCacheOnRemote argument passed into this method is true, this method configures a Descriptor to always remotely refresh the cache if data is received from the database by any query in a RemoteSession. However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHitsOnRemote() method.

Also note that the UnitOfWork will not refresh its registered objects.

Use this property with caution because it can lead to poor performance and may refresh on queries when it is not desired. Normally, if you require fresh data, it is better to configure a query with ObjectLevelReadQuery.refreshIdentityMapResult(). To ensure that refreshes are only done when required, use this method in conjunction with #refreshOnlyIfNewerVersion.

When the shouldAlwaysRefreshCacheOnRemote argument passed into this method is false, this method ensures that a Descriptor is not configured to always remotely refresh the cache if data is received from the database by any query in a RemoteSession.

See Also:

alwaysRefreshCacheOnRemote(), dontAlwaysRefreshCacheOnRemote()

setShouldBeReadOnly

public void setShouldBeReadOnly(boolean shouldBeReadOnly)

PUBLIC: Define if the descriptor reference class is read-only

setReadOnly

public void setReadOnly()

PUBLIC: Set the descriptor to be read-only. Declaring a descriptor is read-only means that instances of the reference class will never be modified. Read-only descriptor is usually used in the unit of work to gain performance as there is no need for the registration, clone and merge for the read-only classes.

setShouldDisableCacheHits

public void setShouldDisableCacheHits(boolean shouldDisableCacheHits)

PUBLIC: Set if cache hits on primary key read object queries should be disabled.

See Also:

alwaysRefreshCache()

setShouldDisableCacheHitsOnRemote

public void setShouldDisableCacheHitsOnRemote(boolean shouldDisableCacheHitsOnRemote)

PUBLIC: Set if the remote session cache hits on primary key read object queries is allowed or not.

See Also:

disableCacheHitsOnRemote()

setShouldOnlyRefreshCacheIfNewerVersion

public void setShouldOnlyRefreshCacheIfNewerVersion(boolean shouldOnlyRefreshCacheIfNewerVersion)

PUBLIC: When the shouldOnlyRefreshCacheIfNewerVersion argument passed into this method is true, this method configures a Descriptor to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field) and as long as one of the following is true:

• the Descriptor was configured by calling alwaysRefreshCache() or alwaysRefreshCacheOnRemote(),
• the query was configured by calling ObjectLevelReadQuery.refreshIdentityMapResult(), or
• the query was a call to Session.refreshObject(java.lang.Object)

However, if a query hits the cache, data is not refreshed regardless of how this setting is configured. For example, by default, when a query for a single object based on its primary key is executed, OracleAS TopLink will first look in the cache for the object. If the object is in the cache, the cached object is returned and data is not refreshed. To avoid cache hits, use the disableCacheHits() method.

Also note that the UnitOfWork will not refresh its registered objects.

When the shouldOnlyRefreshCacheIfNewerVersion argument passed into this method is false, this method ensures that a Descriptor is not configured to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field).

See Also:

onlyRefreshCacheIfNewerVersion(), dontOnlyRefreshCacheIfNewerVersion()

setShouldOrderMappings

public void setShouldOrderMappings(boolean shouldOrderMappings)

PUBLIC: This is set to turn off the ordering of mappings. By Default this is set to true. By ordering the mappings TopLink insures that object are merged in the right order. If the order of the mappings needs to be specified by the developer then set this to false and TopLink will use the order that the mappings were added to the descriptor

setWrapperPolicy

public void setWrapperPolicy(WrapperPolicy wrapperPolicy)

ADVANCED: Sets the WrapperPolicy for this descriptor. This advacned feature can be used to wrap objects with other classes such as CORBA TIE objects or EJBs.

shouldAlwaysConformResultsInUnitOfWork

public boolean shouldAlwaysConformResultsInUnitOfWork()

PUBLIC: Return if the descriptor is defined to always conform the results in unit of work in read query.

shouldAlwaysRefreshCache

public boolean shouldAlwaysRefreshCache()

PUBLIC: This method returns true if the Descriptor is configured to always refresh the cache if data is received from the database by any query. Otherwise, it returns false.

See Also:

setShouldAlwaysRefreshCache(boolean)

shouldAlwaysRefreshCacheOnRemote

public boolean shouldAlwaysRefreshCacheOnRemote()

PUBLIC: This method returns true if the Descriptor is configured to always remotely refresh the cache if data is received from the database by any query in a RemoteSession. Otherwise, it returns false.

See Also:

setShouldAlwaysRefreshCacheOnRemote(boolean)

shouldBeReadOnly

public boolean shouldBeReadOnly()

PUBLIC: Return if the descriptor reference class is defined as read-only

shouldDisableCacheHits

public boolean shouldDisableCacheHits()

PUBLIC: Return if for cache hits on primary key read object queries to be disabled.

See Also:

disableCacheHits()

shouldDisableCacheHitsOnRemote

public boolean shouldDisableCacheHitsOnRemote()

PUBLIC: Return if the remote server session cache hits on primary key read object queries is aloowed or not.

See Also:

disableCacheHitsOnRemote()

shouldOnlyRefreshCacheIfNewerVersion

public boolean shouldOnlyRefreshCacheIfNewerVersion()

PUBLIC: This method returns true if the Descriptor is configured to only refresh the cache if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field). Otherwise, it returns false.

See Also:

setShouldOnlyRefreshCacheIfNewerVersion(boolean)

shouldUseCacheIdentityMap

public boolean shouldUseCacheIdentityMap()

PUBLIC: Return true if this descriptor is using CacheIdentityMap

shouldUseFullIdentityMap

public boolean shouldUseFullIdentityMap()

PUBLIC: Return true if this descriptor is using FullIdentityMap

shouldUseHardCacheWeakIdentityMap

public boolean shouldUseHardCacheWeakIdentityMap()

PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap.

shouldUseNoIdentityMap

public boolean shouldUseNoIdentityMap()

PUBLIC: Return true if this descriptor is using NoIdentityMap

shouldUseRemoteCacheIdentityMap

public boolean shouldUseRemoteCacheIdentityMap()

PUBLIC: Return true if this descriptor is using CacheIdentityMap

shouldUseRemoteFullIdentityMap

public boolean shouldUseRemoteFullIdentityMap()

PUBLIC: Return true if this descriptor is using FullIdentityMap

shouldUseRemoteHardCacheWeakIdentityMap

public boolean shouldUseRemoteHardCacheWeakIdentityMap()

PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap

shouldUseRemoteNoIdentityMap

public boolean shouldUseRemoteNoIdentityMap()

PUBLIC: Return true if this descriptor is using NoIdentityMap

shouldUseRemoteSoftCacheWeakIdentityMap

public boolean shouldUseRemoteSoftCacheWeakIdentityMap()

PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap

shouldUseRemoteWeakIdentityMap

public boolean shouldUseRemoteWeakIdentityMap()

PUBLIC: Return true if this descriptor is using WeakIdentityMap

shouldUseSoftCacheWeakIdentityMap

public boolean shouldUseSoftCacheWeakIdentityMap()

PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap.

shouldUseWeakIdentityMap

public boolean shouldUseWeakIdentityMap()

PUBLIC: Return true if this descriptor is using WeakIdentityMap

useAllFieldsLocking

public void useAllFieldsLocking()

PUBLIC: Set the locking policy an all fields locking policy. A field locking policy is base on locking on all fields by comparing with their previous values to detect field-level collisions. Note: the unit of work must be used for all updates when using field locking.

See Also:

AllFieldsLockingPolicy

useCacheIdentityMap

public void useCacheIdentityMap()

PUBLIC: Set the class of identity map to be the cache identity map. This map caches the LRU instances read from the database. The default is the "SoftCacheWeakIdentityMap".

useChangedFieldsLocking

public void useChangedFieldsLocking()

PUBLIC: Set the locking policy a changed fields locking policy. A field locking policy is base on locking on all changed fields by comparing with their previous values to detect field-level collisions. Note: the unit of work must be used for all updates when using field locking.

See Also:

ChangedFieldsLockingPolicy

useCloneCopyPolicy

public void useCloneCopyPolicy()

PUBLIC: Specifies that the creation of clones within a unit of work is done by sending the #clone() method to the original object. The #clone() method must return a logical shallow copy of the original object. This can be used if the default mechanism of creating a new instance does not handle the object's non-persistent attributes correctly.

See Also:

useCloneCopyPolicy(String)

useCloneCopyPolicy

public void useCloneCopyPolicy(java.lang.String cloneMethodName)

PUBLIC: Specifies that the creation of clones within a unit of work is done by sending the cloneMethodName method to the original object. This method must return a logical shallow copy of the original object. This can be used if the default mechanism of creating a new instance does not handle the object's non-persistent attributes correctly.

See Also:

useCloneCopyPolicy()

useInstantiationCopyPolicy

public void useInstantiationCopyPolicy()

PUBLIC: Specifies that the creation of clones within a unit of work is done by building a new instance using the technique indicated by the descriptor's instantiation policy (which by default is to use the the default constructor). This new instance is then populated by using the descriptor's mappings to copy attributes from the original to the clone. This is the default. If another mechanism is desired the copy policy allows for a clone method to be called.

See Also:

useCloneCopyPolicy(), useCloneCopyPolicy(String), useDefaultConstructorInstantiationPolicy(), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(Object, String)

useDefaultConstructorInstantiationPolicy

public void useDefaultConstructorInstantiationPolicy()

PUBLIC: Use the default constructor to create new instances of objects built from the database. This is the default. The descriptor's class must either define a default constructor or define no constructors at all.

See Also:

useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(Object, String)

useFactoryInstantiationPolicy

public void useFactoryInstantiationPolicy(java.lang.Class factoryClass,
                                          java.lang.String methodName)

PUBLIC: Use an object factory to create new instances of objects built from the database. The methodName is the name of the method that will be invoked on the factory. When invoked, it must return a new instance of the descriptor's class. The factory will be created by invoking the factoryClass's default constructor.

See Also:

useDefaultConstructorInstantiationPolicy(), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(Object, String), useFactoryInstantiationPolicy(String, String), useFactoryInstantiationPolicy(String, String, String)

useFactoryInstantiationPolicy

public void useFactoryInstantiationPolicy(java.lang.Class factoryClass,
                                          java.lang.String methodName,
                                          java.lang.String factoryMethodName)

PUBLIC: Use an object factory to create new instances of objects built from the database. The factoryMethodName is a static method declared by the factoryClass. When invoked, it must return an instance of the factory. The methodName is the name of the method that will be invoked on the factory. When invoked, it must return a new instance of the descriptor's class.

See Also:

useDefaultConstructorInstantiationPolicy(), useFactoryInstantiationPolicy(Class, String), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Object, String), useFactoryInstantiationPolicy(String, String), useFactoryInstantiationPolicy(String, String, String)

useFactoryInstantiationPolicy

public void useFactoryInstantiationPolicy(java.lang.Object factory,
                                          java.lang.String methodName)

PUBLIC: Use an object factory to create new instances of objects built from the database. The methodName is the name of the method that will be invoked on the factory. When invoked, it must return a new instance of the descriptor's class.

See Also:

useDefaultConstructorInstantiationPolicy(), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(String, String), useFactoryInstantiationPolicy(String, String, String)

useFactoryInstantiationPolicy

public void useFactoryInstantiationPolicy(java.lang.String factoryClassName,
                                          java.lang.String methodName)

PUBLIC: Set the factory class name, used by the MW.

See Also:

useDefaultConstructorInstantiationPolicy(), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(String, String), useFactoryInstantiationPolicy(String, String, String)

useFactoryInstantiationPolicy

public void useFactoryInstantiationPolicy(java.lang.String factoryClassName,
                                          java.lang.String methodName,
                                          java.lang.String factoryMethodName)

PUBLIC: Set the factory class name, used by the MW.

See Also:

useDefaultConstructorInstantiationPolicy(), useMethodInstantiationPolicy(String), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(String, String), useFactoryInstantiationPolicy(String, String, String)

useFullIdentityMap

public void useFullIdentityMap()

PUBLIC: Set the class of identity map to be the full identity map. This map caches all instances read and grows to accomodate them. The default is the "SoftCacheWeakIdentityMap".

useHardCacheWeakIdentityMap

public void useHardCacheWeakIdentityMap()

PUBLIC: Set the class of identity map to be the hard cache weak identity map. This map uses weak references to only cache object in-memory. It also includes a secondary fixed sized soft cache to improve caching performance. This is provided because some Java VM's do not implement soft references correctly. The default is the "SoftCacheWeakIdentityMap".

useMethodInstantiationPolicy

public void useMethodInstantiationPolicy(java.lang.String staticMethodName)

PUBLIC: Use the specified static method to create new instances of objects built from the database. This method must be statically declared by the descriptor's class, and it must return a new instance of the descriptor's class.

See Also:

useDefaultConstructorInstantiationPolicy(), useFactoryInstantiationPolicy(Class, String), useFactoryInstantiationPolicy(Class, String, String), useFactoryInstantiationPolicy(Object, String)

useNoIdentityMap

public void useNoIdentityMap()

PUBLIC: Set the class of identity map to be the no identity map. This map does no caching. The default is the "SoftCacheWeakIdentityMap".

useRemoteCacheIdentityMap

public void useRemoteCacheIdentityMap()

PUBLIC: Set the class of identity map to be the cache identity map. This map caches the LRU instances read from the database. The default is the "SoftCacheWeakIdentityMap".

useRemoteFullIdentityMap

public void useRemoteFullIdentityMap()

PUBLIC: Set the class of identity map to be the full identity map. This map caches all instances read and grows to accomodate them. The default is the "SoftCacheWeakIdentityMap".

useRemoteHardCacheWeakIdentityMap

public void useRemoteHardCacheWeakIdentityMap()

PUBLIC: Set the class of identity map to be the hard cache weak identity map. This map uses weak references to only cache object in-memory. It also includes a secondary fixed sized soft cache to improve caching performance. This is provided because some Java VM's do not implement soft references correctly. The default is the "SoftCacheWeakIdentityMap".

useRemoteNoIdentityMap

public void useRemoteNoIdentityMap()

PUBLIC: Set the class of identity map to be the no identity map. This map does no caching. The default is the "SoftCacheWeakIdentityMap".

useRemoteSoftCacheWeakIdentityMap

public void useRemoteSoftCacheWeakIdentityMap()

PUBLIC: Set the class of identity map to be the soft cache weak identity map. The SoftCacheIdentityMap holds a fixed number of objects is memory (using SoftReferences) to improve caching. The default is the "SoftCacheWeakIdentityMap".

useRemoteWeakIdentityMap

public void useRemoteWeakIdentityMap()

PUBLIC: Set the class of identity map to be the weak identity map. The default is the "SoftCacheWeakIdentityMap".

useSelectedFieldsLocking

public void useSelectedFieldsLocking(java.util.Vector fieldNames)

PUBLIC: Set the locking policy a selected fields locking policy. A field locking policy is base on locking on the specified fields by comparing with their previous values to detect field-level collisions. Note: the unit of work must be used for all updates when using field locking.

See Also:

SelectedFieldsLockingPolicy

usesFieldLocking

public boolean usesFieldLocking()

PUBLIC: Return true if the receiver uses either all or changed fields for optimistic locking.

useSoftCacheWeakIdentityMap

public void useSoftCacheWeakIdentityMap()

PUBLIC: Set the class of identity map to be the soft cache weak identity map. The SoftCacheIdentityMap holds a fixed number of objects is memory (using SoftReferences) to improve caching. The default is the "SoftCacheWeakIdentityMap".

usesOptimisticLocking

public boolean usesOptimisticLocking()

PUBLIC: Return true if the receiver uses write (optimistic) locking.

usesSequenceNumbers

public boolean usesSequenceNumbers()

PUBLIC: Return true if the receiver uses sequence numbers.

useTimestampLocking

public void useTimestampLocking(java.lang.String writeLockFieldName)

PUBLIC: Use the Timestamps locking policy and storing the value in the cache key #see useVersionLocking(String)

useTimestampLocking

public void useTimestampLocking(java.lang.String writeLockFieldName,
                                boolean shouldStoreInCache)

PUBLIC: Set the locking policy to use timestamp version locking. This updates the timestamp field on all updates, first comparing that the field has not changed to detect locking conflicts. Note: many database have limited precision of timestamps which can be an issue is highly concurrent systems. The parameter 'shouldStoreInCache' configures the version lock value to be stored in the cache or in the object. Note: if using a stateless model where the object can be passed to a client and then later updated in a different transaction context, then the version lock value should not be stored in the cache, but in the object to ensure it is the correct value for that object.

See Also:

VersionLockingPolicy

useVersionLocking

public void useVersionLocking(java.lang.String writeLockFieldName)

PUBLIC: Default to use the version locking policy and storing the value in the cache key #see useVersionLocking(String)

useVersionLocking

public void useVersionLocking(java.lang.String writeLockFieldName,
                              boolean shouldStoreInCache)

PUBLIC: Set the locking policy to use numeric version locking. This updates the version field on all updates, first comparing that the field has not changed to detect locking conflicts. The parameter 'shouldStoreInCache' configures the version lock value to be stored in the cache or in the object. Note: if using a stateless model where the object can be passed to a client and then later updated in a different transaction context, then the version lock value should not be stored in the cache, but in the object to ensure it is the correct value for that object.

See Also:

TimestampLockingPolicy

useWeakIdentityMap

public void useWeakIdentityMap()

PUBLIC: Set the class of identity map to be the weak identity map. The default is the "SoftCacheWeakIdentityMap".

getCMPPolicy

public CMPPolicy getCMPPolicy()

ADVANCED: Return the cmp descriptor that holds EJB CMP specific information. This will be null unless explicitly set, or after CMP deoloyment. This can only be specified when using CMP for bean class descriptors. This must be set explicitly if any setting need to be configured and before calling getCMPPolicy().

setCMPPolicy

public void setCMPPolicy(CMPPolicy newCMPPolicy)

ADVANCED: Set the cmp descriptor that holds EJB CMP specific information. This can only be specified when using CMP for bean class descriptors. This must be set explicitly if any setting need to be configured and before calling getCMPPolicy().

isDescriptorForCMP

public boolean isDescriptorForCMP()

PUBLIC: Return true if the descriptor is a CMP entity descriptor

getFetchGroupManager

public FetchGroupManager getFetchGroupManager()

PUBLIC: Get the fetch group manager for the descriptor. The fetch group manager is responsible for managing the fetch group behaviors and operations. To use the fetch group, the domain object must implement FetchGroupTracker interface. Otherwise, a descriptor validation exception would throw during initialization. NOTE: It's for CMP project only.

See Also:

FetchGroupTracker

setFetchGroupManager

public void setFetchGroupManager(FetchGroupManager fetchGroupManager)

PUBLIC: Set the fetch group manager for the descriptor. The fetch group manager is responsible for managing the fetch group behaviors and operations.

Skip navigation links