Top Description Fields Constructors Methods
org.eclipse.persistence.mappings.structures

public Class ObjectArrayMapping

extends AbstractCompositeCollectionMapping
Class Inheritance
Imports
org.eclipse.persistence.exceptions.*, org.eclipse.persistence.internal.identitymaps.CacheKey, org.eclipse.persistence.internal.queries.JoinedAttributeManager, org.eclipse.persistence.internal.sessions.AbstractSession, .AbstractRecord, org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping, org.eclipse.persistence.queries.ObjectBuildingQuery, org.eclipse.persistence.descriptors.ClassDescriptor

Purpose: In an object-relational data model, structures can contain "Arrays" or collections of other data-types. In Oracle 8i, a Varray is typically used to represent a collection of primitive data or aggregate structures. These arrays are stored with their parent structure in the same table.

ArrayMapping is used to map a collection of primitive data

ObjectArrayMapping is used to map a collection of Oracle data-type

Note

Only Oracle8i supports Varray type.

Author
King (Yaoping) Wang
Since
TOPLink/Java 3.0
See Also
ArrayMapping

Field Summary

Modifier and TypeField and Description
protected String
structureName

Arrays require a structure name, this is the ADT defined for the VARRAY.

Inherited from org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping:
converterfield

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
protected Object
protected AbstractRecord
public String
public void
public boolean
public void
setFieldName(String fieldName)

public void
setStructureName(String structureName)

PUBLIC: Set the name of the structure.

Inherited from org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping:
buildAddedElementFromChangeSetbuildBackupClonePartbuildChangeSetbuildClonePartbuildCopyOfAttributeValuebuildElementFromChangeSetbuildElementFromElementbuildExpressionbuildRemovedElementFromChangeSetcascadeDiscoverAndPersistUnregisteredNewObjectscascadePerformRemoveIfRequiredcascadeRegisterNewIfRequiredcollectFieldscompareElementscompareElementsForChangecompareForChangecompareObjectsconvertClassNamesToClassesconvertToChangeRecordcreateMapComponentFromRowfixAttributeValuegetAttributeValueFromBackupClonegetContainerPolicygetConvertergetFieldgetRealCollectionAttributeValueFromObjecthasConverterisAbstractCompositeCollectionMappingisCollectionMappingiterateOnAttributeValuemapKeyHasChangedmergeChangesIntoObjectmergeIntoObjectpostDeleteAttributeValuepostInsertAttributeValuepostUpdateAttributeValuepreDeleteAttributeValuepreInsertAttributeValuepreUpdateAttributeValuesetContainerPolicysetConvertersetFieldsimpleAddToCollectionChangeRecordsimpleRemoveFromCollectionChangeRecorduseCollectionClassuseCollectionClassNameuseListClassNameuseMapClassuseMapClassNamevalueFromRowverifyDeleteOfAttributeValuewriteFromObjectIntoRowwriteFromObjectIntoRowForUpdatewriteFromObjectIntoRowWithChangeRecordwriteInsertFieldsIntoRow

Field Detail

structureNameback to summary
protected String structureName

Arrays require a structure name, this is the ADT defined for the VARRAY.

Constructor Detail

ObjectArrayMappingback to summary
public ObjectArrayMapping()

Method Detail

buildCompositeObjectback to summary
protected Object buildCompositeObject(ClassDescriptor descriptor, AbstractRecord nestedRow, ObjectBuildingQuery query, CacheKey parentCacheKey, JoinedAttributeManager joinManager, AbstractSession targetSession)

Implements abstract org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping.buildCompositeObject.

Annotations
@Override
buildCompositeRowback to summary
protected AbstractRecord buildCompositeRow(Object attributeValue, AbstractSession session, AbstractRecord parentRow, DatabaseMapping.WriteType writeType)

Implements abstract org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping.buildCompositeRow.

Annotations
@Override
getStructureNameback to summary
public String getStructureName()

Overrides org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping.getStructureName.

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

Annotations
@Override
initializeback to summary
public void initialize(AbstractSession session) throws DescriptorException

Overrides org.eclipse.persistence.mappings.foundation.AbstractCompositeCollectionMapping.initialize.

INTERNAL: Initialize the mapping.

Annotations
@Override
isRelationalMappingback to summary
public boolean isRelationalMapping()

Overrides org.eclipse.persistence.mappings.DatabaseMapping.isRelationalMapping.

INTERNAL:

Annotations
@Override
setFieldNameback to summary
public void setFieldName(String fieldName)
setStructureNameback to summary
public void setStructureName(String structureName)

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