org.eclipse.persistence.mappings.structures

Class ObjectRelationalDataTypeDescriptor

java.lang.Object

org.eclipse.persistence.core.descriptors.CoreDescriptor<AttributeGroup,DescriptorEventManager,DatabaseField,InheritancePolicy,InstantiationPolicy,java.util.Vector,ObjectBuilder>

org.eclipse.persistence.descriptors.ClassDescriptor

org.eclipse.persistence.descriptors.RelationalDescriptor

org.eclipse.persistence.mappings.structures.ObjectRelationalDataTypeDescriptor

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class ObjectRelationalDataTypeDescriptor
extends RelationalDescriptor

Purpose: Differentiates object-relational descriptors from normal relational descriptors. The object-relational descriptor describes a type not a table, (although there is normally a table associated with the type, unless it is aggregate).

See Also:

Serialized Form

Field Summary

Fields inherited from class org.eclipse.persistence.descriptors.ClassDescriptor

DO_NOT_SEND_CHANGES, INVALIDATE_CHANGED_OBJECTS, ISOLATE_CACHE_AFTER_TRANSACTION, ISOLATE_CACHE_ALWAYS, ISOLATE_FROM_CLIENT_SESSION, ISOLATE_NEW_DATA_AFTER_TRANSACTION, SEND_NEW_OBJECTS_WITH_CHANGES, SEND_OBJECT_CHANGES, shouldUseFullChangeSetsForNewObjects, UNDEFINED_ISOLATATION, UNDEFINED_OBJECT_CHANGE_BEHAVIOR, USE_SESSION_CACHE_AFTER_TRANSACTION

Constructor Summary

Constructors

Constructor and Description
ObjectRelationalDataTypeDescriptor()

Method Summary

Modifier and Type	Method and Description
void	addFieldOrdering(java.lang.String fieldName) PUBLIC: Order the fields in a specific Add the field ordering, this will order the fields in the order this method is called.
static java.lang.Object	buildArrayObjectFromArray(java.lang.Object array) INTERNAL: Build array of objects for Array data type.
static java.lang.Object	buildArrayObjectFromStruct(java.lang.Object structure) INTERNAL: Build array of objects for Struct data type.
static java.lang.Object	buildContainerFromArray(java.sql.Array fieldValue, ObjectRelationalDatabaseField arrayField, AbstractSession session) INTERNAL: Build and return the nested rows from the specified field value.
java.util.Vector	buildDirectValuesFromFieldValue(java.lang.Object fieldValue) INTERNAL: Extract the direct values from the specified field value.
java.lang.Object	buildFieldValueFromDirectValues(java.util.Vector directValues, java.lang.String elementDataTypeName, AbstractSession session) INTERNAL: Build the appropriate field value for the specified set of direct values.
java.lang.Object	buildFieldValueFromNestedRow(AbstractRecord nestedRow, AbstractSession session) INTERNAL: Build and return the field value from the specified nested database row.
java.lang.Object	buildFieldValueFromNestedRows(java.util.Vector nestedRows, java.lang.String structureName, AbstractSession session) INTERNAL: Build and return the appropriate field value for the specified set of nested rows.
AbstractRecord	buildNestedRowFromFieldValue(java.lang.Object fieldValue) INTERNAL: Build and return the nested database row from the specified field value.
java.util.Vector	buildNestedRowsFromFieldValue(java.lang.Object fieldValue, AbstractSession session) INTERNAL: Build and return the nested rows from the specified field value.
AbstractRecord	buildRowFromStructure(java.sql.Struct structure) INTERNAL: Build a row representation from the ADT structure field array.
java.sql.Struct	buildStructureFromRow(AbstractRecord row, AbstractSession session, java.sql.Connection connection) INTERNAL: Build a ADT structure from the row data.
java.util.Vector	getOrderedFields() INTERNAL: Return the field order.
java.sql.Ref	getRef(java.lang.Object object, AbstractSession session) INTERNAL: Get the ref for the object.
java.lang.String	getStructureName() PUBLIC: Return the name of the structure.
void	initialize(AbstractSession session) INTERNAL: Auto-Default orderedFields to fields
boolean	isObjectRelationalDataTypeDescriptor() PUBLIC: Return if this is an ObjectRelationalDataTypeDescriptor.
boolean	requiresInitialization(AbstractSession session) INTERNAL: Aggregates obj-rel are initialized normally as no cloning is required.
void	setOrderedFields(java.util.Vector orderedFields) INTERNAL: Set the field order.
void	setStructureName(java.lang.String structureName) PUBLIC: Set the name of the structure.

Methods inherited from class org.eclipse.persistence.descriptors.RelationalDescriptor

addTableName, getTableName, getTableNames, isRelationalDescriptor, setDefaultTableName, setTableName, setTableNames, setTableQualifier

Methods inherited from class org.eclipse.persistence.descriptors.ClassDescriptor

addAbstractQueryKey, addCascadeLockingPolicy, addConstraintDependencies, addConstraintDependency, addDirectMapping, addDirectMapping, addDirectQueryKey, addForeignKeyFieldForMultipleTable, addForeignKeyFieldNameForMultipleTable, addMapping, addMappingsPostCalculateChanges, addMappingsPostCalculateChangesOnDeleted, addPreDeleteMapping, addPrimaryKeyField, addPrimaryKeyFieldName, addQueryKey, addTable, addUnconvertedProperty, adjustMultipleTableInsertOrder, alwaysConformResultsInUnitOfWork, alwaysRefreshCache, alwaysRefreshCacheOnRemote, applyAmendmentMethod, applyAmendmentMethod, arePrimaryKeyFields, buildBatchCriteriaByPK, buildCallFromStatement, buildField, buildField, buildField, buildFieldValueFromForeignKeys, checkInheritanceTreeAggregateSettings, clone, convertClassNamesToClasses, createCopyPolicy, createInstantiationPolicy, descriptorIsAggregate, descriptorIsAggregateCollection, descriptorIsForInterface, descriptorIsNormal, disableCacheHits, disableCacheHitsOnRemote, dontAlwaysConformResultsInUnitOfWork, dontAlwaysRefreshCache, dontAlwaysRefreshCacheOnRemote, dontDisableCacheHits, dontDisableCacheHitsOnRemote, dontOnlyRefreshCacheIfNewerVersion, getAccessorTree, getAdditionalAggregateCollectionKeyFields, getAdditionalTablePrimaryKeyFields, getAdditionalWritableMapKeyFields, getAlias, getAllFields, getAllSelectionFields, getAllSelectionFields, getAmendmentClass, getAmendmentClassName, getAmendmentMethodName, getAttributeGroup, getAttributeGroups, getCacheInterceptorClass, getCacheInterceptorClassName, getCacheInvalidationPolicy, getCacheIsolation, getCacheKeyType, getCachePolicy, getCacheSynchronizationType, getCascadeLockingPolicies, getCMPPolicy, getConstraintDependencies, getCopyPolicy, getCopyPolicyClassName, getDefaultDeleteObjectQueryRedirector, getDefaultFetchGroup, getDefaultInsertObjectQueryRedirector, getDefaultQueryRedirector, getDefaultReadAllQueryRedirector, getDefaultReadObjectQueryRedirector, getDefaultReportQueryRedirector, getDefaultTable, getDefaultUpdateObjectQueryRedirector, getDerivesIdMappinps, getDescriptorCustomizerClassName, getDescriptorEventManager, getDescriptorInheritancePolicy, getDescriptorQueryManager, getDescriptorType, getDescriptorTypeValue, getEventManager, getFetchGroupManager, getFields, getForeignKeyValuesForCaching, getFullyMergeEntity, getHistoryPolicy, getIdentityMapClass, getIdentityMapSize, getIdValidation, getInheritancePolicy, getInheritancePolicyOrNull, getInstantiationPolicy, getInterfacePolicy, getInterfacePolicyOrNull, getJavaClass, getJavaClassName, getLockableMappings, getMappingForAttributeName, getMappings, getMappingsPostCalculateChanges, getMappingsPostCalculateChangesOnDeleted, getMultipleTableForeignKeyAssociations, getMultipleTableForeignKeys, getMultipleTableInsertOrder, getMultipleTablePrimaryKeyAssociations, getMultitenantPolicy, getObjectBuilder, getObjectChangePolicy, getObjectChangePolicyInternal, getOptimisticLockingPolicy, getPartitioningPolicy, getPartitioningPolicyName, getPreDeleteMappings, getPrimaryKeyFieldNames, getPrimaryKeyFields, getPrimaryKeyIdValidations, getProperties, getProperty, getQueryKeyNamed, getQueryKeys, getQueryManager, getRemoteIdentityMapClass, getRemoteIdentityMapSize, getReturningPolicy, getRootDescriptor, getSelectionFields, getSelectionFields, getSequence, getSequenceNumberField, getSequenceNumberFieldName, getSequenceNumberName, getSerializedObjectPolicy, getSessionName, getTable, getTablePerClassPolicy, getTables, getTypedField, getUnconvertedProperties, getUnitOfWorkCacheIsolationLevel, getVirtualAttributeMethods, getWrapperPolicy, hasCascadeLockingPolicies, hasCMPPolicy, hasDependencyOnParts, hasDerivedId, hasEventManager, hasFetchGroupManager, hasInheritance, hasInterfacePolicy, hasMappingsPostCalculateChanges, hasMappingsPostCalculateChangesOnDeleted, hasMultipleTableConstraintDependecy, hasMultipleTables, hasMultitenantPolicy, hasNestedIdentityReference, hasNoncacheableMappings, hasPessimisticLockingPolicy, hasPreDeleteMappings, hasPrivatelyOwnedParts, hasQueryKeyOrMapping, hasRelationships, hasRelationshipsExceptBackpointer, hasReturningPolicy, hasSerializedObjectPolicy, hasSimplePrimaryKey, hasTablePerClassPolicy, hasTablePerMultitenantPolicy, hasTargetForeignKeyMapping, hasUnconvertedProperties, hasWrapperPolicy, initialize, initializeAggregateInheritancePolicy, initializeMultipleTablePrimaryKeyFields, interfaceInitialization, isAbstract, isAggregateCollectionDescriptor, isAggregateDescriptor, isCascadeOnDeleteSetOnDatabaseOnSecondaryTables, isChildDescriptor, isDescriptorForInterface, isDescriptorTypeAggregate, isDescriptorTypeNormal, isEISDescriptor, isFullyInitialized, isInterfaceChildDescriptor, isInvalid, isIsolated, isMultipleTableDescriptor, isNativeConnectionRequired, isPrimaryKeySetAfterInsert, isProtectedIsolation, isReturnTypeRequiredForReturningPolicy, isSharedIsolation, isXMLDescriptor, newAggregateCollectionMapping, newAggregateMapping, newDirectCollectionMapping, newDirectMapping, newManyToManyMapping, newManyToOneMapping, newOneToManyMapping, newOneToOneMapping, newUnidirectionalOneToManyMapping, notifyReferencingDescriptorsOfIsolation, onlyRefreshCacheIfNewerVersion, postInitialize, preInitialize, preInterfaceInitialization, rehashFieldDependancies, reInitializeJoinedAttributes, remoteInitialization, removeMappingForAttributeName, removeProperty, setAccessorTree, setAdditionalTablePrimaryKeyFields, setAlias, setAmendmentClass, setAmendmentClassName, setAmendmentMethodName, setCacheable, setCacheInterceptorClass, setCacheInterceptorClassName, setCacheInvalidationPolicy, setCacheIsolation, setCacheKeyType, setCachePolicy, setCacheSynchronizationType, setCMPPolicy, setConstraintDependencies, setCopyPolicy, setCopyPolicyClassName, setDefaultDeleteObjectQueryRedirector, setDefaultDeleteObjectQueryRedirectorClassName, setDefaultInsertObjectQueryRedirector, setDefaultInsertObjectQueryRedirectorClassName, setDefaultQueryRedirector, setDefaultQueryRedirectorClassName, setDefaultReadAllQueryRedirector, setDefaultReadAllQueryRedirectorClassName, setDefaultReadObjectQueryRedirector, setDefaultReadObjectQueryRedirectorClassName, setDefaultReportQueryRedirector, setDefaultReportQueryRedirectorClassName, setDefaultTable, setDefaultUpdateObjectQueryRedirector, setDefaultUpdateObjectQueryRedirectorClassName, setDescriptorCustomizerClassName, setDescriptorType, setDescriptorTypeValue, setEventManager, setExistenceChecking, setFetchGroupManager, setFields, setForeignKeyFieldNamesForMultipleTable, setFullyMergeEntity, setHasMultipleTableConstraintDependecy, setHasRelationships, setHasSimplePrimaryKey, setHistoryPolicy, setIdentityMapClass, setIdentityMapSize, setIdValidation, setInheritancePolicy, setInstantiationPolicy, setInterfacePolicy, setInternalDefaultTable, setInternalDefaultTable, setIsCascadeOnDeleteSetOnDatabaseOnSecondaryTables, setIsIsolated, setIsNativeConnectionRequired, setJavaClass, setJavaClassName, setJavaInterface, setJavaInterfaceName, setLockableMappings, setMappings, setMultipleTableInsertOrder, setMultitenantPolicy, setObjectChangePolicy, setOptimisticLockingPolicy, setPartitioningPolicy, setPartitioningPolicyName, setPrimaryKeyFieldName, setPrimaryKeyFieldNames, setPrimaryKeyFields, setPrimaryKeyIdValidations, setProperties, setProperty, setQueryKeys, setQueryManager, setReadOnly, setRemoteIdentityMapClass, setRemoteIdentityMapSize, setReturningPolicy, setSequence, setSequenceNumberField, setSequenceNumberFieldName, setSequenceNumberName, setSerializedObjectPolicy, setShouldAcquireCascadedLocks, setShouldAlwaysConformResultsInUnitOfWork, setShouldAlwaysRefreshCache, setShouldAlwaysRefreshCacheOnRemote, setShouldBeReadOnly, setShouldDisableCacheHits, setShouldDisableCacheHitsOnRemote, setShouldLockForClone, setShouldOnlyRefreshCacheIfNewerVersion, setShouldOrderMappings, setShouldRegisterResultsInUnitOfWork, setTablePerClassPolicy, setTables, setUnitOfWorkCacheIsolationLevel, setVirtualAttributeMethods, setWrapperPolicy, shouldAcquireCascadedLocks, shouldAlwaysConformResultsInUnitOfWork, shouldAlwaysRefreshCache, shouldAlwaysRefreshCacheOnRemote, shouldBeReadOnly, shouldDisableCacheHits, shouldDisableCacheHitsOnRemote, shouldIsolateObjectsInUnitOfWork, shouldIsolateObjectsInUnitOfWorkEarlyTransaction, shouldIsolateProtectedObjectsInUnitOfWork, shouldLockForClone, shouldOnlyRefreshCacheIfNewerVersion, shouldOrderMappings, shouldRegisterResultsInUnitOfWork, shouldUseAdditionalJoinExpression, shouldUseCacheIdentityMap, shouldUseFullChangeSetsForNewObjects, shouldUseFullIdentityMap, shouldUseHardCacheWeakIdentityMap, shouldUseNoIdentityMap, shouldUseRemoteCacheIdentityMap, shouldUseRemoteFullIdentityMap, shouldUseRemoteHardCacheWeakIdentityMap, shouldUseRemoteNoIdentityMap, shouldUseRemoteSoftCacheWeakIdentityMap, shouldUseRemoteSoftIdentityMap, shouldUseRemoteWeakIdentityMap, shouldUseSessionCacheInUnitOfWorkEarlyTransaction, shouldUseSoftCacheWeakIdentityMap, shouldUseSoftIdentityMap, shouldUseWeakIdentityMap, supportsChangeTracking, toString, useAllFieldsLocking, useCacheIdentityMap, useChangedFieldsLocking, useCloneCopyPolicy, useCloneCopyPolicy, useDefaultConstructorInstantiationPolicy, useFactoryInstantiationPolicy, useFactoryInstantiationPolicy, useFactoryInstantiationPolicy, useFactoryInstantiationPolicy, useFactoryInstantiationPolicy, useFullIdentityMap, useHardCacheWeakIdentityMap, useInstantiationCopyPolicy, useMethodInstantiationPolicy, useNoIdentityMap, usePropertyAccessForWeaving, useRemoteCacheIdentityMap, useRemoteFullIdentityMap, useRemoteHardCacheWeakIdentityMap, useRemoteNoIdentityMap, useRemoteSoftCacheWeakIdentityMap, useRemoteSoftIdentityMap, useRemoteWeakIdentityMap, useSelectedFieldsLocking, usesFieldLocking, useSoftCacheWeakIdentityMap, useSoftIdentityMap, usesOptimisticLocking, usesPropertyAccessForWeaving, usesSequenceNumbers, usesVersionLocking, useTimestampLocking, useTimestampLocking, useVersionLocking, useVersionLocking, useWeakIdentityMap

Methods inherited from class org.eclipse.persistence.core.descriptors.CoreDescriptor

addAttributeGroup

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectRelationalDataTypeDescriptor

public ObjectRelationalDataTypeDescriptor()

Method Detail

initialize

public void initialize(AbstractSession session)
                throws DescriptorException

INTERNAL: Auto-Default orderedFields to fields

Overrides:

initialize in class ClassDescriptor

Throws:

DescriptorException

addFieldOrdering

public void addFieldOrdering(java.lang.String fieldName)

PUBLIC: Order the fields in a specific Add the field ordering, this will order the fields in the order this method is called.

Parameters:

fieldName - the name of the field to add ordering on.

buildDirectValuesFromFieldValue

public java.util.Vector buildDirectValuesFromFieldValue(java.lang.Object fieldValue)
                                                 throws DatabaseException

INTERNAL: Extract the direct values from the specified field value. Return them in a vector. The field value better be an Array.

Overrides:

buildDirectValuesFromFieldValue in class ClassDescriptor

Throws:

DatabaseException

buildFieldValueFromDirectValues

public java.lang.Object buildFieldValueFromDirectValues(java.util.Vector directValues,
                                                        java.lang.String elementDataTypeName,
                                                        AbstractSession session)
                                                 throws DatabaseException

INTERNAL: Build the appropriate field value for the specified set of direct values. The database better be expecting an ARRAY.

Overrides:

buildFieldValueFromDirectValues in class ClassDescriptor

Throws:

DatabaseException

buildFieldValueFromNestedRow

public java.lang.Object buildFieldValueFromNestedRow(AbstractRecord nestedRow,
                                                     AbstractSession session)
                                              throws DatabaseException

INTERNAL: Build and return the field value from the specified nested database row. The database better be expecting a Struct.

Overrides:

buildFieldValueFromNestedRow in class ClassDescriptor

Throws:

DatabaseException

buildFieldValueFromNestedRows

public java.lang.Object buildFieldValueFromNestedRows(java.util.Vector nestedRows,
                                                      java.lang.String structureName,
                                                      AbstractSession session)
                                               throws DatabaseException

INTERNAL: Build and return the appropriate field value for the specified set of nested rows. The database better be expecting an ARRAY. It looks like we can ignore inheritance here....

Overrides:

buildFieldValueFromNestedRows in class ClassDescriptor

Throws:

DatabaseException

buildContainerFromArray

public static java.lang.Object buildContainerFromArray(java.sql.Array fieldValue,
                                                       ObjectRelationalDatabaseField arrayField,
                                                       AbstractSession session)
                                                throws DatabaseException

INTERNAL: Build and return the nested rows from the specified field value. This method allows the field value to be an ARRAY containing other structures such as arrays or Struct, or direct values.

Throws:

DatabaseException

buildNestedRowFromFieldValue

public AbstractRecord buildNestedRowFromFieldValue(java.lang.Object fieldValue)
                                            throws DatabaseException

INTERNAL: Build and return the nested database row from the specified field value. The field value better be an Struct.

Overrides:

buildNestedRowFromFieldValue in class ClassDescriptor

Throws:

DatabaseException

buildNestedRowsFromFieldValue

public java.util.Vector buildNestedRowsFromFieldValue(java.lang.Object fieldValue,
                                                      AbstractSession session)
                                               throws DatabaseException

INTERNAL: Build and return the nested rows from the specified field value. The field value better be an ARRAY.

Overrides:

buildNestedRowsFromFieldValue in class ClassDescriptor

Throws:

DatabaseException

buildRowFromStructure

public AbstractRecord buildRowFromStructure(java.sql.Struct structure)
                                     throws DatabaseException

INTERNAL: Build a row representation from the ADT structure field array. TopLink will then build the object from the row.

Throws:

DatabaseException

buildStructureFromRow

public java.sql.Struct buildStructureFromRow(AbstractRecord row,
                                             AbstractSession session,
                                             java.sql.Connection connection)
                                      throws DatabaseException

INTERNAL: Build a ADT structure from the row data.

Throws:

DatabaseException

buildArrayObjectFromArray

public static java.lang.Object buildArrayObjectFromArray(java.lang.Object array)
                                                  throws DatabaseException

INTERNAL: Build array of objects for Array data type.

Throws:

DatabaseException

buildArrayObjectFromStruct

public static java.lang.Object buildArrayObjectFromStruct(java.lang.Object structure)
                                                   throws DatabaseException

INTERNAL: Build array of objects for Struct data type.

Throws:

DatabaseException

getOrderedFields

public java.util.Vector getOrderedFields()

INTERNAL: Return the field order.

getRef

public java.sql.Ref getRef(java.lang.Object object,
                           AbstractSession session)

INTERNAL: Get the ref for the object. This is required for use by Refs, there might be a better way to do it when objID are supported. (i.e. getting it from the object or identity map).

getStructureName

public java.lang.String getStructureName()

PUBLIC: Return the name of the structure. This is the name of the user defined data type as defined on the database.

isObjectRelationalDataTypeDescriptor

public boolean isObjectRelationalDataTypeDescriptor()

PUBLIC: Return if this is an ObjectRelationalDataTypeDescriptor.

Overrides:

isObjectRelationalDataTypeDescriptor in class ClassDescriptor

requiresInitialization

public boolean requiresInitialization(AbstractSession session)

INTERNAL: Aggregates obj-rel are initialized normally as no cloning is required.

Overrides:

requiresInitialization in class ClassDescriptor

setOrderedFields

public void setOrderedFields(java.util.Vector orderedFields)

INTERNAL: Set the field order.

setStructureName

public void setStructureName(java.lang.String structureName)

PUBLIC: Set the name of the structure. This is the name of the user defined data type as defined on the database.