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.
RelationalDescriptor, org.eclipse.persistence.mappings.structures.ObjectRelationalDataTypeDescriptor , org.eclipse.persistence.eis.EISDescriptor , org.eclipse.persistence.oxm.XMLDescriptor
| Modifier and Type | Field and Description |
|---|---|
| protected List | accessorTree
A list of AttributeAccessors in order of access from root to leaf to arrive at current AggregateDescriptor. |
| protected transient List | additionalAggregateCollectionKeyFields
used by aggregate descriptors to hold additional fields needed when they are stored in an AggregatateCollection These fields are generally foreign key fields that are required in addition to the fields in the descriptor's mappings to uniquely identify the Aggregate |
| protected Map | |
| protected transient List | additionalWritableMapKeyFields
stores fields that are written by Map key mappings so they can be checked for multiple writable mappings |
| protected static final int | |
| protected static final int | |
| protected String | |
| protected transient Vector | |
| protected transient List | |
| protected transient Class | |
| protected String | |
| protected transient String | |
| protected CacheInvalidationPolicy | |
| protected CachePolicy | |
| protected boolean | cascadedLockingInitialized
INTERNAL: flag to indicate the initialization state of cascade locking for this descriptor |
| protected transient List | |
| protected ObjectChangePolicy | |
| protected CMPPolicy | |
| protected transient Vector | |
| protected CopyPolicy | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected QueryRedirector | |
| protected String | |
| protected transient DatabaseTable | |
| protected QueryRedirector | |
| protected String | |
| protected Map | |
| protected String | descriptorCustomizerClassName
JPA DescriptorCustomizer list stored here to preserve it when caching the project |
| protected int | |
| public static final int | |
| protected static final int | |
| protected FetchGroupManager | |
| protected transient Vector | |
| protected Set | foreignKeyValuesForCaching
Stores a set of FK fields that will be cached to later retrieve noncacheable mappings |
| protected boolean | hasMultipleTableConstraintDependecy
Defines if any mapping reference a field in a secondary table. |
| protected boolean | hasNoncacheableMappings
caches if this descriptor has any non cacheable mappings |
| protected boolean | hasRelationships
whether this descriptor has any relationships through its mappings, through inheritance, or through aggregates |
| protected boolean | hasSimplePrimaryKey
PERF: Compute and store if the primary key is simple (direct-mapped) to allow fast extraction. |
| protected HistoryPolicy | |
| protected IdValidation | idValidation
Allow zero primary key validation to be configured. |
| protected transient int | |
| protected static final int | |
| protected static final int | |
| protected transient int | |
| protected InterfacePolicy | |
| public static final int | |
| protected boolean | isCascadeOnDeleteSetOnDatabaseOnSecondaryTables
Support delete cascading on the database for multiple and inheritance tables. |
| protected boolean | isNativeConnectionRequired
Allow connection unwrapping to be configured. |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| protected Class | |
| protected String | |
| protected List | |
| protected Vector | |
| protected List | mappingsPostCalculateChanges
Mappings that require postCalculateChanges method to be called |
| protected List | mappingsPostCalculateChangesOnDeleted
Mappings that require postCalculateChangesOnDeleted method to be called |
| protected Map | |
| protected transient List | |
| protected MultitenantPolicy | |
| protected static final int | NORMAL
Define valid descriptor types. |
| protected OptimisticLockingPolicy | |
| protected PartitioningPolicy | |
| protected String | |
| protected static final int | |
| protected List | preDeleteMappings
stores a list of mappings that require preDelete as a group prior to the delete individually |
| protected static final int | |
| protected List | |
| protected List | primaryKeyIdValidations
Allow zero primary key validation to be configured per field. |
| protected Map | properties
Additional properties may be added. |
| protected Map | |
| protected DescriptorQueryManager | |
| protected Set | |
| protected transient Vector | |
| protected transient Vector | |
| protected transient List | |
| protected transient List | |
| protected List | |
| protected ReturningPolicy | |
| protected transient List | |
| public static final int | |
| public static final int | |
| protected Sequence | sequence
Store the Sequence used for the descriptor. |
| protected DatabaseField | |
| protected String | |
| protected SerializedObjectPolicy | |
| protected transient String | |
| protected boolean | shouldAcquireCascadedLocks
PERF: Used to optimize cache locking to only acquire deferred locks when required (no-indirection). |
| protected boolean | |
| protected boolean | |
| protected boolean | shouldLockForClone
This flag controls if a UOW should acquire locks for clone or simple clone the instance passed to registerExistingObject. |
| protected boolean | |
| protected boolean | |
| public static boolean | shouldUseFullChangeSetsForNewObjects
INTERNAL: Backdoor for using changes sets for new objects. |
| protected Vector | |
| protected Map | unconvertedProperties
Allow the user to defined un-converted properties which will be initialized at runtime. |
| public static final int | |
| public static final int | |
| protected static final int | UNINITIALIZED
The following are the [initializationStage] states the descriptor passes through during the initialization. |
| public static final int | |
| protected List | virtualAttributeMethods
A list of methods that are used by virtual mappings. |
| protected boolean | weavingUsesPropertyAccess
This flag stores whether this descriptor is using Property access based on JPA semantics. |
| protected WrapperPolicy |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public void | addAbstractQueryKey(String queryKeyName)
PUBLIC: This method should only be used for interface descriptors. |
| public void | addCascadeLockingPolicy(CascadeLockingPolicy
- the CascadeLockingPolicy policy)INTERNAL: Add the cascade locking policy to all children that have a relationship to this descriptor either by inheritance or by encapsulation/aggregation. |
| public void | addConstraintDependencies(Class<?> dependencies)
ADVANCED: EclipseLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. |
| public void | addConstraintDependency(Class<?> dependencies)
ADVANCED: EclipseLink automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. |
| public DatabaseMapping | Returns: The newly created DatabaseMapping is returned.is the name of an instance variable of the
class which the receiver describes. attributeName, String is the name of the database column which corresponds
with the designated instance variable. fieldName)PUBLIC: Add a direct to field mapping to the receiver. |
| public DatabaseMapping | addDirectMapping(String attributeName, String getMethodName, String setMethodName, String fieldName)
PUBLIC: Add a direct to field mapping to the receiver. |
| public void | |
| public void | addForeignKeyFieldForMultipleTable(DatabaseField sourceForeignKeyField, DatabaseField targetPrimaryKeyField)
PUBLIC: This protocol can be used to associate multiple tables with foreign key information. |
| public void | addForeignKeyFieldNameForMultipleTable(String sourceForeignKeyFieldName, String targetPrimaryKeyFieldName)
PUBLIC: This protocol can be used to associate multiple tables with foreign key information. |
| public DatabaseMapping | |
| public void | addMappingsPostCalculateChanges(DatabaseMapping mapping)
Add a mapping to the list of mappings that require postCalculateChanges method to be called. |
| public void | addMappingsPostCalculateChangesOnDeleted(DatabaseMapping mapping)
Add a mapping to the list of mappings that require mappingsPostCalculateChangesOnDeleted method to be called. |
| public void | addPreDeleteMapping(DatabaseMapping mapping)
INTERNAL: Add the mapping to be notified before deletion. |
| public void | addPrimaryKeyField(DatabaseField field)
ADVANCED: Specify the primary key field of the descriptors table. |
| public void | addPrimaryKeyFieldName(String fieldName)
PUBLIC: Specify the primary key field of the descriptors table. |
| public void | |
| public void | addTable(DatabaseTable table)
PUBLIC: Specify the table for the class of objects the receiver describes. |
| public void | addTableName(String tableName)
PUBLIC: Specify the table name for the class of objects the receiver describes. |
| public void | addUnconvertedProperty(String propertyName, String propertyValue, String propertyType)
PUBLIC: Add an unconverted property (to be initialiazed at runtime) |
| public void | adjustMultipleTableInsertOrder()
INTERNAL: Adjust the order of the tables in the multipleTableInsertOrder Vector according to the FK relationship if one (or more) were previously specified. |
| public void | alwaysConformResultsInUnitOfWork()
PUBLIC: Used to set the descriptor to always conform in any unit of work query. |
| public void | alwaysRefreshCache()
PUBLIC:
This method is the equivalent of calling |
| public void | alwaysRefreshCacheOnRemote()
PUBLIC:
This method is the equivalent of calling |
| public void | |
| public void | |
| public boolean | arePrimaryKeyFields(Vector<E> fields)
INTERNAL: Used to determine if a foreign key references the primary key. |
| protected void | assignDefaultValues(AbstractSession session)
INTERNAL: Some attributes have default values defined in Project. |
| private void | |
| public Expression | buildBatchCriteriaByPK(ExpressionBuilder builder, ObjectLevelReadQuery query)
INTERNAL: Return the selection criteria used to IN batch fetching. |
| public DatasourceCall | buildCallFromStatement(SQLStatement statement, DatabaseQuery query, AbstractSession session)
INTERNAL: Return a call built from a statement. |
| public Vector | buildDirectValuesFromFieldValue(Object fieldValue)
INTERNAL: Extract the direct values from the specified field value. |
| public DatabaseField | |
| public DatabaseField | buildField(DatabaseField field)
INTERNAL: The table of the field is ensured to be unique from the descriptor's tables. |
| public DatabaseField | |
| public Object | buildFieldValueFromDirectValues(Vector<E> directValues, String elementDataTypeName, AbstractSession session)
INTERNAL: Build the appropriate field value for the specified set of direct values. |
| public Object | buildFieldValueFromForeignKeys(Vector<E> foreignKeys, String referenceDataTypeName, AbstractSession session)
INTERNAL: Build and return the appropriate field value for the specified set of foreign keys (i.e. each row has the fields that make up a foreign key). |
| public Object | buildFieldValueFromNestedRow(AbstractRecord nestedRow, AbstractSession session)
INTERNAL: Build and return the field value from the specified nested database row. |
| public Object | buildFieldValueFromNestedRows(Vector<E> nestedRows, String structureName, AbstractSession session)
INTERNAL: Build and return the appropriate field value for the specified set of nested rows. |
| public AbstractRecord | buildNestedRowFromFieldValue(Object fieldValue)
INTERNAL: Build and return the nested database row from the specified field value. |
| public Vector | buildNestedRowsFromFieldValue(Object fieldValue, AbstractSession session)
INTERNAL: Build and return the nested rows from the specified field value. |
| protected void | |
| public void | checkInheritanceTreeAggregateSettings(AbstractSession session, AggregateMapping mapping)
INTERNAL: Verify that an aggregate descriptor's inheritance tree is full of aggregate descriptors. |
| private void | checkInheritanceTreeAggregateSettingsForChildren(AbstractSession session, AggregateMapping mapping)
Verify that an aggregate descriptor's inheritance tree is full of aggregate descriptors, cont. |
| public void | |
| public Object | |
| public void | convertClassNamesToClasses(ClassLoader classLoader)
INTERNAL: Convert all the class-name-based settings in this Descriptor to actual class-based settings. |
| public void | |
| public void | createInstantiationPolicy(String policyType)
PUBLIC: Create a instantiation policy of the type passed in as a string. |
| protected void | |
| protected void | createMultipleTableInsertOrderFromComparison(int[][] tableComparison, int nStart)
INTERNAL: This helper method creates multipleTableInsertOrderFromComparison using comparison matrix created by createTableComparison(getTables()) method call. |
| protected int[][] | createTableComparison(List<DatabaseTable> tables, int nStart)
INTERNAL: This helper method creates a matrix that contains insertion order comparison for the tables. |
| protected boolean | createTableOrder(int k, int nTables, int[] tableOrder, int[][] tableComparison)
INTERNAL: This helper method recursively puts indexes from 0 to nTables-1 into tableOrder according to tableComparison 2 dim array. |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | disableCacheHitsOnRemote()
PUBLIC: Allow for remote session cache hits on primary key read object queries to be disabled. |
| public void | dontAlwaysConformResultsInUnitOfWork()
PUBLIC: The descriptor is defined to not conform the results in unit of work in read query. |
| public void | dontAlwaysRefreshCache()
PUBLIC:
This method is the equivalent of calling |
| public void | dontAlwaysRefreshCacheOnRemote()
PUBLIC:
This method is the equivalent of calling |
| public void | |
| public void | dontDisableCacheHitsOnRemote()
PUBLIC: Allow for remote session cache hits on primary key read object queries. |
| public void | dontOnlyRefreshCacheIfNewerVersion()
PUBLIC:
This method is the equivalent of calling |
| protected DatabaseTable | |
| public List | |
| public List | getAdditionalAggregateCollectionKeyFields()
INTERNAL: additionalAggregateCollectionKeyFields are used by aggregate descriptors to hold additional fields needed when they are stored in an AggregatateCollection These fields are generally foreign key fields that are required in addition to the fields in the descriptor's mappings to uniquely identify the Aggregate |
| public Map | getAdditionalTablePrimaryKeyFields()
INTERNAL: This is used to map the primary key field names in a multiple table descriptor. |
| public List | getAdditionalWritableMapKeyFields()
INTERNAL: Return a list of fields that are written by map keys Used to determine if there is a multiple writable mappings issue |
| public String | |
| public Vector | |
| public List | |
| public List | getAllSelectionFields(ObjectLevelReadQuery query)
INTERNAL: Return all selection fields which include all child class fields. |
| public Class | |
| public String | |
| public String | |
| public AttributeGroup | getAttributeGroup(String name)
Overrides org. |
| public Map | getAttributeGroups()
Overrides org. |
| public Class | getCacheInterceptorClass()
A CacheInterceptor is an adaptor that when overridden and assigned to a Descriptor all interaction between EclipseLink and the internal cache for that class will pass through the Interceptor. |
| public String | getCacheInterceptorClassName()
A CacheInterceptor is an adaptor that when overridden and assigned to a Descriptor all interaction between EclipseLink and the internal cache for that class will pass through the Interceptor. |
| public CacheInvalidationPolicy | Returns: CacheInvalidationPolicyPUBLIC: Return the CacheInvalidationPolicy for this descriptor For uninitialized cache invalidation policies, this will return a NoExpiryCacheInvalidationPolicy |
| public CacheIsolationType | Returns: the isolationTypePUBLIC: Controls how the Entity instances will be cached. |
| public CacheKeyType | |
| public CachePolicy | |
| public int | getCacheSynchronizationType()
PUBLIC: Get a value indicating the type of cache synchronization that will be used on objects of this type. |
| public List | |
| public CMPPolicy | |
| public Vector | getConstraintDependencies()
ADVANCED: automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. |
| public CopyPolicy | |
| public String | getCopyPolicyClassName()
INTERNAL: Returns the name of a Class that implements CopyPolicy Will be instantiated as a copy policy at initialization times using the no-args constructor |
| public QueryRedirector | getDefaultDeleteObjectQueryRedirector()
A Default DeleteObjectQuery Redirector will be applied to any executing DeleteObjectQuery or DeleteAllQuery that does not have a redirector set directly on the query. |
| public FetchGroup | |
| public QueryRedirector | getDefaultInsertObjectQueryRedirector()
A Default InsertObjectQuery Redirector will be applied to any executing InsertObjectQuery that does not have a redirector set directly on the query. |
| public QueryRedirector | getDefaultQueryRedirector()
A Default Query Redirector will be applied to any executing object query that does not have a more precise default (like the default ReadObjectQuery Redirector) or a redirector set directly on the query. |
| public QueryRedirector | getDefaultReadAllQueryRedirector()
A Default ReadAllQuery Redirector will be applied to any executing ReadAllQuery that does not have a redirector set directly on the query. |
| public QueryRedirector | getDefaultReadObjectQueryRedirector()
A Default ReadObjectQuery Redirector will be applied to any executing ReadObjectQuery that does not have a redirector set directly on the query. |
| public QueryRedirector | getDefaultReportQueryRedirector()
A Default ReportQuery Redirector will be applied to any executing ReportQuery that does not have a redirector set directly on the query. |
| public DatabaseTable | |
| public QueryRedirector | getDefaultUpdateObjectQueryRedirector()
A Default UpdateObjectQuery Redirector will be applied to any executing UpdateObjectQuery or UpdateAllQuery that does not have a redirector set directly on the query. |
| public Collection | |
| public String | getDescriptorCustomizerClassName()
INTERNAL: DescriptorCustomizer is the JPA equivalent of an amendment method. |
| public DescriptorEventManager | |
| public InheritancePolicy | getDescriptorInheritancePolicy()
PUBLIC: The inheritance policy is used to define how a descriptor takes part in inheritance. |
| public DescriptorQueryManager | |
| public int | getDescriptorType()
ADVANCED: return the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION) |
| public String | |
| public DescriptorEventManager | getEventManager()
Implements abstract org. |
| public FetchGroupManager | |
| public Vector | |
| public Set | |
| public boolean | |
| public HistoryPolicy | |
| public <T extends IdentityMap> Class | |
| public int | |
| public IdValidation | |
| public InheritancePolicy | getInheritancePolicy()
Implements abstract org. |
| public InheritancePolicy | |
| public InstantiationPolicy | getInstantiationPolicy()
Implements abstract org. |
| public InterfacePolicy | |
| public InterfacePolicy | |
| public <T> Class | getJavaClass()
Implements abstract org. |
| public String | |
| public List | getLockableMappings()
INTERNAL: Returns a reference to the mappings that must be traverse when locking |
| public DatabaseMapping | getMappingForAttributeName(String attributeName)
PUBLIC: Returns the mapping associated with a given attribute name. |
| public Vector | |
| public List | |
| public List | getMappingsPostCalculateChangesOnDeleted()
Mappings that require mappingsPostCalculateChangesOnDeleted method to be called |
| public Vector | getMultipleTableForeignKeyAssociations()
INTERNAL: Returns the foreign key relationships used for multiple tables which were specified by the user. |
| public Map | getMultipleTableForeignKeys()
INTERNAL: Returns the foreign key relationships used for multiple tables which were specified by the user. |
| public List | getMultipleTableInsertOrder()
INTERNAL: Returns the List of DatabaseTables in the order which INSERTS should take place. |
| public Vector | getMultipleTablePrimaryKeyAssociations()
INTERNAL: Returns the foreign key relationships used for multiple tables which were specified by the user. |
| public MultitenantPolicy | |
| public ObjectBuilder | getObjectBuilder()
Implements abstract org. |
| public ObjectChangePolicy | |
| public ObjectChangePolicy | getObjectChangePolicyInternal()
INTERNAL: Return this objects ObjectChangePolicy and do not lazy initialize |
| public OptimisticLockingPolicy | |
| public PartitioningPolicy | |
| public String | |
| public List | |
| public Vector | getPrimaryKeyFieldNames()
Implements abstract org. |
| public List | getPrimaryKeyFields()
Implements abstract org. |
| public List | |
| public Map | |
| public Object | |
| public QueryKey | |
| public Map | |
| public DescriptorQueryManager | |
| public <T extends IdentityMap> Class | getRemoteIdentityMapClass()
INTERNAL: Return the class of identity map to be used by this descriptor. |
| public int | |
| public Vector | |
| public Vector | |
| public List | |
| public List | |
| public List | |
| public ReturningPolicy | |
| public ClassDescriptor | getRootDescriptor()
PUBLIC: This method returns the root descriptor for for this descriptor's class heirarchy. |
| public List | |
| public List | |
| public Sequence | |
| public DatabaseField | |
| public String | |
| public String | |
| public SerializedObjectPolicy | |
| public String | |
| public DatabaseTable | |
| public String | |
| public Vector | |
| public TablePerClassPolicy | |
| public Vector | |
| public DatabaseField | getTypedField(DatabaseField field)
Implements abstract org. |
| public Map | getUnconvertedProperties()
INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method. |
| public int | |
| public List | |
| public WrapperPolicy | |
| public boolean | |
| public boolean | |
| public boolean | hasDependencyOnParts()
INTERNAL: Checks if the class has any private owned parts or other dependencies, (i.e. M:M join table). |
| public boolean | |
| public boolean | hasEventManager()
Implements abstract org. |
| public boolean | |
| public boolean | hasInheritance()
Implements abstract org. |
| public boolean | hasInterfacePolicy()
INTERNAL: Return if this descriptor is involved in interface, (is child or parent). |
| public boolean | hasMappingsPostCalculateChanges()
Are there any mappings that require postCalculateChanges method to be called. |
| public boolean | hasMappingsPostCalculateChangesOnDeleted()
Are there any mappings that require mappingsPostCalculateChangesOnDeleted method to be called. |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | hasNestedIdentityReference(boolean withChildren)
INTERNAL: Calculates whether descriptor references an entity (directly or through a nested mapping). |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | hasQueryKeyOrMapping(String attributeName)
INTERNAL: Checks to see if it has a query key or mapping with the specified name or not. |
| public boolean | hasRelationships()
INTERNAL: return whether this descriptor has any relationships through its mappings, through inheritance, or through aggregates |
| public boolean | hasRelationshipsExceptBackpointer(ClassDescriptor descriptor)
INTERNAL: This method returns true if this descriptor has either a ForeignReferenceMapping to an object aside from the one described by descriptor or more than one ForeignReferenceMapping to descriptor. |
| public boolean | hasReturningPolicies()
INTERNAL: Return if this descriptor or descriptors from mappings has Returning policy. |
| public boolean | |
| public boolean | |
| public boolean | hasSimplePrimaryKey()
INTERNAL: PERF: Return if the primary key is simple (direct-mapped) to allow fast extraction. |
| public boolean | hasTablePerClassPolicy()
INTERNAL: Return if this descriptor is involved in a table per class inheritance. |
| public boolean | Returns: true if this descriptor is configured with a table per tenant policy.PUBLIC |
| public boolean | hasTargetForeignKeyMapping(AbstractSession session)
INTERNAL: Indicates whether descriptor has at least one target foreign key mapping |
| public boolean | hasUnconvertedProperties()
INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method. |
| public boolean | |
| public void | |
| public void | initialize(DescriptorQueryManager queryManager, AbstractSession session)
INTERNAL: Initialize the query manager specific to the descriptor type. |
| public void | initializeAggregateInheritancePolicy(AbstractSession session)
INTERNAL: This initialized method is used exclusively for inheritance. |
| public void | |
| protected void | initializeProperties(AbstractSession session)
INTERNAL: Initialize the descriptor properties such as write lock and sequencing. |
| public void | interfaceInitialization(AbstractSession session)
INTERNAL: Allow the descriptor to initialize any dependencies on this session. |
| public boolean | isAbstract()
INTERNAL: Convenience method to return true if the java class from this descriptor is abstract. |
| public boolean | isAggregateCollectionDescriptor()
PUBLIC: Return true if this descriptor is an aggregate collection descriptor |
| public boolean | |
| public boolean | isCascadeOnDeleteSetOnDatabaseOnSecondaryTables()
ADVANCED: Return if delete cascading has been set on the database for the descriptor's multiple tables. |
| public boolean | |
| public boolean | |
| public boolean | isDescriptorTypeAggregate()
PUBLIC return true if this descriptor is any type of aggregate descriptor. |
| public boolean | |
| public boolean | |
| public boolean | |
| protected boolean | isInitialized(int initializationStage)
INTERNAL: Check if descriptor is already initialized for the level of initialization. |
| public boolean | |
| protected boolean | isInterfaceInitialized(int interfaceInitializationStage)
INTERNAL: Check if interface descriptor is already initialized for the level of initialization. |
| public boolean | isInvalid()
INTERNAL: Return if an error occurred during initialization which should abort any further initialization. |
| public boolean | |
| public boolean | |
| public boolean | isNativeConnectionRequired()
ADVANCED: Return if the descriptor requires usage of a native (unwrapped) JDBC connection. |
| public boolean | isObjectRelationalDataTypeDescriptor()
PUBLIC: Return if the descriptor maps to an object-relational structured type. |
| public boolean | isPrimaryKeySetAfterInsert(AbstractSession session)
INTERNAL: Indicates whether pk or some of its components set after insert into the database. |
| public boolean | |
| public boolean | |
| public boolean | isReturnTypeRequiredForReturningPolicy()
INTERNAL: Indicates if a return type is required for the field set on the returning policy. |
| public boolean | |
| public boolean | |
| public DatabaseMapping | newAggregateCollectionMapping()
Return a new aggregate collection/element collection mapping for this type of descriptor. |
| public AggregateMapping | |
| public DatabaseMapping | newDirectCollectionMapping()
Return a new direct collection/element collection mapping for this type of descriptor. |
| public AbstractDirectMapping | |
| public CollectionMapping | |
| public ObjectReferenceMapping | |
| public CollectionMapping | |
| public ObjectReferenceMapping | |
| public CollectionMapping | |
| public void | notifyReferencingDescriptorsOfIsolation(AbstractSession session)
INTERNAL: Configure all descriptors referencing this class to be protected and update their cache settings. |
| public void | onlyRefreshCacheIfNewerVersion()
PUBLIC:
This method is the equivalent of calling
|
| public void | postInitialize(AbstractSession session)
INTERNAL: Post initializations after mappings are initialized. |
| private void | |
| public void | preInitialize(AbstractSession session)
INTERNAL: Allow the descriptor to initialize any dependencies on this session. |
| protected void | |
| public void | preInterfaceInitialization(AbstractSession session)
INTERNAL: Allow the descriptor to initialize any dependencies on this session. |
| protected void | |
| private void | |
| public void | |
| public void | reInitializeJoinedAttributes()
INTERNAL: A user should not be setting which attributes to join or not to join after descriptor initialization; provided only for backwards compatibility. |
| public void | |
| public DatabaseMapping | removeMappingForAttributeName(String attributeName)
ADVANCED: Removes the locally defined mapping associated with a given attribute name. |
| public void | |
| public boolean | requiresInitialization(AbstractSession session)
INTERNAL: Aggregate and Interface descriptors do not require initialization as they are cloned and initialized by each mapping. |
| protected void | selfValidationAfterInitialization(AbstractSession session)
INTERNAL: Validate that the descriptor was defined correctly. |
| protected void | selfValidationBeforeInitialization(AbstractSession session)
INTERNAL: Validate that the descriptor's non-mapping attribute are defined correctly. |
| public void | |
| protected void | setAdditionalTablePrimaryKeyFields(DatabaseTable table, DatabaseField field1, DatabaseField field2)
INTERNAL: This is used to map the primary key field names in a multiple table descriptor. |
| public void | setAdditionalTablePrimaryKeyFields(Map<DatabaseTable, Map<DatabaseField, DatabaseField>> additionalTablePrimaryKeyFields)
INTERNAL: This is used to map the primary key field names in a multiple table descriptor. |
| public void | |
| protected void | |
| public void | |
| public void | setAmendmentClassName(String amendmentClassName)
INTERNAL: Return the amendment class name, used by the MW. |
| public void | |
| public void | setCacheable(Boolean
Entity @Cacheable annotation value for current class
or cacheable)null if @Cacheable annotation is not set. Parent
values are ignored, value shall refer to current class only.
This value should be set only when SharedCacheMode allows
to override caching on entity level (DISABLE_SELECTIVE
or ENABLE_SELECTIVE).INTERNAL: Set entity @Cacheable annotation value in cache configuration object. |
| public void | setCacheInterceptorClass(Class<? extends CacheInterceptor> cacheInterceptorClass)
PUBLIC: A CacheInterceptor is an adaptor that when overridden and assigned to a Descriptor all interaction between EclipseLink and the internal cache for that class will pass through the Interceptor. |
| public void | setCacheInterceptorClassName(String cacheInterceptorClassName)
PUBLIC: A CacheInterceptor is an adaptor that when overridden and assigned to a Descriptor all interaction between EclipseLink and the internal cache for that class will pass through the Interceptor. |
| public void | setCacheInvalidationPolicy(CacheInvalidationPolicy policy)
PUBLIC: Set the Cache Invalidation Policy for this descriptor. |
| public void | setCacheIsolation(CacheIsolationType isolationType)
PUBLIC: Controls how the Entity instances and data will be cached. |
| public void | setCacheKeyType(CacheKeyType cacheKeyType)
ADVANCED: Set what cache key type to use to store the object in the cache. |
| public void | |
| public void | setCacheSynchronizationType(int
int The synchronization type for this descriptor type)PUBLIC: Set the type of cache synchronization that will be used on objects of this type. |
| public void | setCMPPolicy(CMPPolicy newCMPPolicy)
ADVANCED: Set the cmp descriptor that holds cmp specific information. |
| public void | setConstraintDependencies(Vector<E> constraintDependencies)
ADVANCED: automatically orders database access through the foreign key information provided in 1:1 and 1:m mappings. |
| public void | |
| public void | setCopyPolicyClassName(String className)
INTERNAL: Sets the name of a Class that implements CopyPolicy Will be instantiatied as a copy policy at initialization times using the no-args constructor |
| public void | setDefaultDeleteObjectQueryRedirector(QueryRedirector defaultDeleteObjectQueryRedirector)
A Default DeleteObjectQuery Redirector will be applied to any executing DeleteObjectQuery or DeleteAllQuery that does not have a redirector set directly on the query. |
| public void | setDefaultDeleteObjectQueryRedirectorClassName(String defaultDeleteObjectQueryRedirectorClassName)
A Default DeleteObjectQuery Redirector will be applied to any executing DeleteObjectQuery or DeleteAllQuery that does not have a redirector set directly on the query. |
| public void | setDefaultInsertObjectQueryRedirector(QueryRedirector defaultInsertQueryRedirector)
A Default InsertObjectQuery Redirector will be applied to any executing InsertObjectQuery that does not have a redirector set directly on the query. |
| public void | setDefaultInsertObjectQueryRedirectorClassName(String defaultInsertObjectQueryRedirectorClassName)
A Default InsertObjectQuery Redirector will be applied to any executing InsertObjectQuery that does not have a redirector set directly on the query. |
| public void | setDefaultQueryRedirector(QueryRedirector defaultRedirector)
A Default Query Redirector will be applied to any executing object query that does not have a more precise default (like the default ReadObjectQuery Redirector) or a redirector set directly on the query. |
| public void | setDefaultQueryRedirectorClassName(String defaultQueryRedirectorClassName)
A Default Query Redirector will be applied to any executing object query that does not have a more precise default (like the default ReadObjectQuery Redirector) or a redirector set directly on the query. |
| public void | setDefaultReadAllQueryRedirector(QueryRedirector defaultReadAllQueryRedirector)
A Default ReadAllQuery Redirector will be applied to any executing ReadAllQuery that does not have a redirector set directly on the query. |
| public void | setDefaultReadAllQueryRedirectorClassName(String defaultReadAllQueryRedirectorClassName)
A Default ReadAllQuery Redirector will be applied to any executing ReadAllQuery that does not have a redirector set directly on the query. |
| public void | setDefaultReadObjectQueryRedirector(QueryRedirector defaultReadObjectQueryRedirector)
A Default ReadObjectQuery Redirector will be applied to any executing ReadObjectQuery that does not have a redirector set directly on the query. |
| public void | setDefaultReadObjectQueryRedirectorClassName(String defaultReadObjectQueryRedirectorClassName)
A Default ReadObjectQuery Redirector will be applied to any executing ReadObjectQuery that does not have a redirector set directly on the query. |
| public void | setDefaultReportQueryRedirector(QueryRedirector defaultReportQueryRedirector)
A Default ReportQuery Redirector will be applied to any executing ReportQuery that does not have a redirector set directly on the query. |
| public void | setDefaultReportQueryRedirectorClassName(String defaultReportQueryRedirectorClassName)
A Default ReportQuery Redirector will be applied to any executing ReportQuery that does not have a redirector set directly on the query. |
| public void | setDefaultTable(DatabaseTable defaultTable)
INTERNAL: The descriptors default table can be configured if the first table is not desired. |
| public void | setDefaultTableName(String defaultTableName)
PUBLIC: The descriptors default table can be configured if the first table is not desired. |
| public void | setDefaultUpdateObjectQueryRedirector(QueryRedirector defaultUpdateQueryRedirector)
A Default UpdateObjectQuery Redirector will be applied to any executing UpdateObjectQuery or UpdateAllQuery that does not have a redirector set directly on the query. |
| public void | setDefaultUpdateObjectQueryRedirectorClassName(String defaultUpdateObjectQueryRedirectorClassName)
A Default UpdateObjectQuery Redirector will be applied to any executing UpdateObjectQuery or UpdateAllQuery that does not have a redirector set directly on the query. |
| public void | setDescriptorCustomizerClassName(String descriptorCustomizerClassName)
INTERNAL: Sets the JPA DescriptorCustomizer class name. |
| public void | setDescriptorType(int descriptorType)
ADVANCED: set the descriptor type (NORMAL by default, others include INTERFACE, AGGREGATE, AGGREGATE COLLECTION) |
| public void | |
| public void | setEventManager(DescriptorEventManager eventManager)
Implements abstract org. |
| public void | |
| public void | setFetchGroupManager(FetchGroupManager fetchGroupManager)
PUBLIC: Set the fetch group manager for the descriptor. |
| public void | |
| public void | setForeignKeyFieldNamesForMultipleTable(List<Association> associations)
INTERNAL: This method is used by the XML Deployment ClassDescriptor to read and write these mappings |
| public void | |
| public void | setHasMultipleTableConstraintDependecy(boolean hasMultipleTableConstraintDependecy)
Set if any mapping reference a field in a secondary table. |
| public void | setHasRelationships(boolean hasRelationships)
INTERNAL: set whether this descriptor has any relationships through its mappings, through inheritance, or through aggregates |
| public void | setHasSimplePrimaryKey(boolean hasSimplePrimaryKey)
INTERNAL: PERF: Set if the primary key is simple (direct-mapped) to allow fast extraction. |
| public void | |
| public void | setIdentityMapClass(Class<? extends IdentityMap> theIdentityMapClass)
PUBLIC: Set the class of identity map to be used by this descriptor. |
| public void | setIdentityMapSize(int identityMapSize)
PUBLIC: Set the size of the identity map to be used by this descriptor. |
| public void | setIdValidation(IdValidation idValidation)
ADVANCED: Set what types are allowed as a primary key (id). |
| public void | setInheritancePolicy(InheritancePolicy inheritancePolicy)
Implements abstract org. |
| protected void | |
| public void | setInstantiationPolicy(InstantiationPolicy instantiationPolicy)
Implements abstract org. |
| protected void | |
| public void | |
| public void | |
| public void | setInternalDefaultTable(DatabaseTable defaultTable)
INTERNAL: Set the default table if one if not already set. |
| public void | setIsCascadeOnDeleteSetOnDatabaseOnSecondaryTables(boolean isCascadeOnDeleteSetOnDatabaseOnSecondaryTables)
ADVANCED: Set if delete cascading has been set on the database for the descriptor's multiple tables. |
| public void | setIsNativeConnectionRequired(boolean isNativeConnectionRequired)
ADVANCED: Set if the descriptor requires usage of a native (unwrapped) JDBC connection. |
| public void | setJavaClass(Class<?> theJavaClass)
Implements abstract org. |
| public void | |
| public void | |
| public void | setJavaInterfaceName(String theJavaInterfaceName)
INTERNAL: Return the java interface name, used by the MW. |
| public void | setLockableMappings(List<DatabaseMapping> lockableMappings)
INTERNAL: Set the list of lockable mappings for this project This method is provided for CMP use. |
| public void | |
| protected void | |
| public void | setMultipleTableInsertOrder(List<DatabaseTable> newValue)
ADVANCED: Sets the List of DatabaseTables in the order which INSERTS should take place. |
| public void | setMultitenantPolicy(MultitenantPolicy multitenantPolicy)
INTERNAL: Set a multitenant policy on the descriptor. |
| protected void | setObjectBuilder(ObjectBuilder builder)
Implements abstract org. |
| public void | setObjectChangePolicy(ObjectChangePolicy policy)
PUBLIC: Set the ObjectChangePolicy for this descriptor. |
| public void | setOptimisticLockingPolicy(OptimisticLockingPolicy optimisticLockingPolicy)
PUBLIC: Set the OptimisticLockingPolicy. |
| public void | setPartitioningPolicy(PartitioningPolicy partitioningPolicy)
PUBLIC: Set the descriptor's partitioning policy. |
| public void | setPartitioningPolicyName(String partitioningPolicyName)
PUBLIC: Set the name of the descriptor's partitioning policy. |
| public void | setPrimaryKeyFieldName(String fieldName)
PUBLIC: Specify the primary key field of the descriptors table. |
| public void | setPrimaryKeyFieldNames(Vector<E> primaryKeyFieldsName)
Implements abstract org. |
| public void | setPrimaryKeyFields(List<DatabaseField> thePrimaryKeyFields)
Implements abstract org. |
| public void | setPrimaryKeyIdValidations(List<IdValidation> primaryKeyIdValidations)
ADVANCED: Return what types are allowed in each primary key field (id). |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | setRemoteIdentityMapClass(Class<? extends IdentityMap> theIdentityMapClass)
PUBLIC: Set the class of identity map to be used by this descriptor. |
| public void | setRemoteIdentityMapSize(int identityMapSize)
PUBLIC: Set the size of the identity map to be used by this descriptor. |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | |
| protected void | |
| public void | setShouldAcquireCascadedLocks(boolean shouldAcquireCascadedLocks)
INTERNAL: PERF: Set if deferred locks should be used. |
| public void | setShouldAlwaysConformResultsInUnitOfWork(boolean shouldAlwaysConformResultsInUnitOfWork)
PUBLIC: set if the descriptor is defined to always conform the results in unit of work in read query. |
| public void | setShouldAlwaysRefreshCache(boolean shouldAlwaysRefreshCache)
PUBLIC:
When the |
| public void | setShouldAlwaysRefreshCacheOnRemote(boolean shouldAlwaysRefreshCacheOnRemote)
PUBLIC:
When the |
| public void | setShouldBeReadOnly(boolean shouldBeReadOnly)
PUBLIC: Define if the descriptor reference class is read-only |
| public void | setShouldDisableCacheHits(boolean shouldDisableCacheHits)
PUBLIC: Set if cache hits on primary key read object queries should be disabled. |
| public void | setShouldDisableCacheHitsOnRemote(boolean shouldDisableCacheHitsOnRemote)
PUBLIC: Set if the remote session cache hits on primary key read object queries is allowed or not. |
| public void | setShouldLockForClone(boolean shouldLockForClone)
ADVANCED: When set to false, this setting will allow the UOW to avoid locking the shared cache instance in order to perform a clone. |
| public void | setShouldOnlyRefreshCacheIfNewerVersion(boolean shouldOnlyRefreshCacheIfNewerVersion)
PUBLIC:
When the
|
| public void | setShouldOrderMappings(boolean shouldOrderMappings)
PUBLIC: This is set to turn off the ordering of mappings. |
| public void | setShouldRegisterResultsInUnitOfWork(boolean shouldRegisterResultsInUnitOfWork)
INTERNAL: Set to false to have queries conform to a UnitOfWork without registering any additional objects not already in that UnitOfWork. |
| public void | setTableName(String tableName)
PUBLIC: Specify the table name for the class of objects the receiver describes. |
| public void | setTableNames(Vector<E> tableNames)
PUBLIC: Specify the all table names for the class of objects the receiver describes. |
| public void | setTablePerClassPolicy(TablePerClassPolicy tablePerClassPolicy)
INTERNAL: Sets the table per class policy. |
| public void | |
| public void | |
| public void | setUnitOfWorkCacheIsolationLevel(int unitOfWorkCacheIsolationLevel)
ADVANCED: This setting configures how the session cache will be used in a unit of work. |
| public void | setVirtualAttributeMethods(List<VirtualAttributeMethodInfo> virtualAttributeMethods)
INTERNAL: Set the list of methods used my mappings with virtual access this list is used to determine which methods to weave |
| public void | |
| public boolean | |
| public boolean | shouldAlwaysConformResultsInUnitOfWork()
PUBLIC: Return if the descriptor is defined to always conform the results in unit of work in read query. |
| public boolean | shouldAlwaysRefreshCache()
PUBLIC:
This method returns |
| public boolean | shouldAlwaysRefreshCacheOnRemote()
PUBLIC:
This method returns |
| public boolean | |
| public boolean | shouldDisableCacheHits()
PUBLIC: Return if for cache hits on primary key read object queries to be disabled. |
| public boolean | shouldDisableCacheHitsOnRemote()
PUBLIC: Return if the remote server session cache hits on primary key read object queries is aloowed or not. |
| public boolean | shouldIsolateObjectsInUnitOfWork()
INTERNAL: Return if the unit of work should by-pass the session cache. |
| public boolean | shouldIsolateObjectsInUnitOfWorkEarlyTransaction()
INTERNAL: Return if the unit of work should by-pass the session cache after an early transaction. |
| public boolean | shouldIsolateProtectedObjectsInUnitOfWork()
INTERNAL: Return if the unit of work should by-pass the IsolatedSession cache. |
| public boolean | shouldLockForClone()
ADVANCED: When set to false, this setting will allow the UOW to avoid locking the shared cache instance in order to perform a clone. |
| public boolean | shouldOnlyRefreshCacheIfNewerVersion()
PUBLIC:
This method returns |
| public boolean | |
| public boolean | Returns: true by default.INTERNAL: Allows one to do conforming in a UnitOfWork without registering. |
| public boolean | shouldUseAdditionalJoinExpression()
PUBLIC: Return true if this descriptor should using an additional join expresison. |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | shouldUseHardCacheWeakIdentityMap()
PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap. |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | shouldUseRemoteHardCacheWeakIdentityMap()
PUBLIC: Return true if this descriptor is using HardCacheWeakIdentityMap |
| public boolean | |
| public boolean | shouldUseRemoteSoftCacheWeakIdentityMap()
PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap |
| public boolean | |
| public boolean | |
| public boolean | shouldUseSessionCacheInUnitOfWorkEarlyTransaction()
INTERNAL: Return if the unit of work should use the session cache after an early transaction. |
| public boolean | shouldUseSoftCacheWeakIdentityMap()
PUBLIC: Return true if this descriptor is using SoftCacheWeakIdentityMap. |
| public boolean | |
| public boolean | |
| public boolean | supportsChangeTracking(Project project)
INTERNAL: Returns whether this descriptor is capable of supporting weaved change tracking. |
| protected void | toggleAdditionalTablePrimaryKeyFields()
INTERNAL: Eclipselink needs additionalTablePKFields entries to be associated with tables other than the main (getTables.get(0)) one. |
| public String | toString()
Overrides java. |
| public void | |
| public void | |
| public void | |
| 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. |
| public void | useCloneCopyPolicy(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. |
| public void | useDefaultConstructorInstantiationPolicy()
PUBLIC: Use the default constructor to create new instances of objects built from the database. |
| public void | useFactoryInstantiationPolicy(Class<?> factoryClass, String methodName)
PUBLIC: Use an object factory to create new instances of objects built from the database. |
| public void | useFactoryInstantiationPolicy(String factoryClassName, String methodName)
INTERNAL: Set the factory class name, used by the MW. |
| public void | useFactoryInstantiationPolicy(Class<?> factoryClass, String methodName, String factoryMethodName)
PUBLIC: Use an object factory to create new instances of objects built from the database. |
| public void | useFactoryInstantiationPolicy(String factoryClassName, String methodName, String factoryMethodName)
INTERNAL: Set the factory class name, used by the MW. |
| public void | useFactoryInstantiationPolicy(Object factory, String methodName)
PUBLIC: Use an object factory to create new instances of objects built from the database. |
| public void | |
| public void | useHardCacheWeakIdentityMap()
PUBLIC: Set the class of identity map to be the hard cache weak identity map. |
| 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). |
| public void | useMethodInstantiationPolicy(String staticMethodName)
PUBLIC: Use the specified static method to create new instances of objects built from the database. |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | useRemoteHardCacheWeakIdentityMap()
PUBLIC: Set the class of identity map to be the hard cache weak identity map. |
| public void | |
| public void | useRemoteSoftCacheWeakIdentityMap()
PUBLIC: Set the class of identity map to be the soft cache weak identity map. |
| public void | |
| public void | |
| public void | useSelectedFieldsLocking(Vector<E> fieldNames)
PUBLIC: Set the locking policy a selected fields locking policy. |
| public boolean | usesFieldLocking()
INTERNAL: Return true if the receiver uses either all or changed fields for optimistic locking. |
| public void | useSoftCacheWeakIdentityMap()
PUBLIC: Set the class of identity map to be the soft cache weak identity map. |
| public void | |
| public boolean | |
| public boolean | |
| public boolean | |
| public boolean | |
| public void | useTimestampLocking(String writeLockFieldName)
PUBLIC: Use the Timestamps locking policy and storing the value in the cache key #see useVersionLocking(String) |
| public void | useTimestampLocking(String writeLockFieldName, boolean shouldStoreInCache)
PUBLIC: Set the locking policy to use timestamp version locking. |
| public void | useVersionLocking(String writeLockFieldName)
PUBLIC: Default to use the version locking policy and storing the value in the cache key #see useVersionLocking(String) |
| public void | useVersionLocking(String writeLockFieldName, boolean shouldStoreInCache)
PUBLIC: Set the locking policy to use numeric version locking. |
| public void | |
| protected void | validateAfterInitialization(AbstractSession session)
INTERNAL: Validate the entire post-initialization descriptor. |
| protected void | validateBeforeInitialization(AbstractSession session)
INTERNAL: Validate the entire pre-initialization descriptor. |
| protected void | |
| protected void | |
| protected void | verifyMultipleTablesForeignKeysTables()
INTERNAL: Verify that the tables specified in multipleTablesForeignKeysTables are valid. |
| protected void | verifyTableQualifiers(Platform platform)
INTERNAL: Check that the qualifier on the table names are properly set. |