Class AbstractColumnMapping
- java.lang.Object
- 
- org.eclipse.persistence.core.mappings.CoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
- 
- org.eclipse.persistence.mappings.DatabaseMapping
- 
- org.eclipse.persistence.mappings.foundation.AbstractColumnMapping
 
 
 
- 
- All Implemented Interfaces:
- java.io.Serializable,- java.lang.Cloneable
 - Direct Known Subclasses:
- AbstractDirectMapping,- MultitenantPrimaryKeyMapping
 
 public abstract class AbstractColumnMapping extends DatabaseMapping Purpose: Maps an attribute or some other property to the corresponding database field type. The list of field types that are supported by EclipseLink's direct to field mapping is dependent on the relational database being used.- See Also:
- AbstractDirectMapping,- MultitenantPrimaryKeyMapping, Serialized Form
- Author:
- Guy Pelletier
- Since:
- TopLink/Java 1.0
 
- 
- 
Nested Class Summary- 
Nested classes/interfaces inherited from class org.eclipse.persistence.mappings.DatabaseMappingDatabaseMapping.WriteType
 
- 
 - 
Field SummaryFields Modifier and Type Field Description protected ConverterconverterAllows user defined conversion between the object attribute value and the database value.protected java.lang.StringconverterClassNameprotected org.eclipse.persistence.internal.helper.DatabaseFieldfieldDatabaseField which this mapping represents.protected booleanisInsertableFlag to support insertable JPA settingprotected booleanisUpdatableFlag to support updatable JPA setting- 
Fields inherited from class org.eclipse.persistence.mappings.DatabaseMappingattributeAccessor, attributeName, derivedIdMapping, derivesId, descriptor, fields, isCacheable, isInSopObject, isJPAId, isLazy, isMapKeyMapping, isOptional, isPrimaryKeyMapping, isReadOnly, isRemotelyInitialized, mapsIdValue, NO_FIELDS, NO_WEIGHT, properties, unconvertedProperties, weight, WEIGHT_AGGREGATE, WEIGHT_DIRECT, WEIGHT_TO_ONE, WEIGHT_TRANSFORM
 
- 
 - 
Constructor SummaryConstructors Constructor Description AbstractColumnMapping()Default constructor.
 - 
Method SummaryAll Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voidcascadePerformRemoveIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade perform delete through mappings that require the cascade.voidcascadeRegisterNewIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade registerNew for Create through mappings that require the cascade.java.lang.Objectclone()INTERNAL: The mapping clones itself to create deep copy.protected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField>collectFields()Returns the field this mapping represents.voidconvertClassNamesToClasses(java.lang.ClassLoader classLoader)INTERNAL: Convert all the class-name-based settings in this mapping to actual class-based settings This method is implemented by subclasses as necessary.voidfixObjectReferences(java.lang.Object object, java.util.Map objectDescriptors, java.util.Map processedObjects, ObjectLevelReadQuery query, DistributedSession session)INTERNAL: An object has been serialized from the server to the client.ConvertergetConverter()PUBLIC: Return the converter on the mapping.org.eclipse.persistence.internal.helper.DatabaseFieldgetField()INTERNAL: Returns the field which this mapping represents.abstract java.lang.ObjectgetFieldValue(java.lang.Object objectValue, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Convert the object (attribute or property) value to a field value.abstract java.lang.ObjectgetObjectValue(java.lang.Object fieldValue, Session session)INTERNAL: Allows for subclasses to convert the the attribute or property value.booleanhasConverter()Indicates if the mapping has a converter set on it.booleanisAbstractColumnMapping()INTERNAL:protected booleanisInsertable()INTERNAL: Return true if this mapping is insertable.protected booleanisUpdatable()INTERNAL: Return true if this mapping is updatable.voiditerate(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator)INTERNAL: Iterate on the appropriate attribute.voidsetConverter(Converter converter)PUBLIC: Set the converter on the mapping.voidsetConverterClassName(java.lang.String converterClassName)PUBLIC: Set the converter class name on the mapping.voidsetField(org.eclipse.persistence.internal.helper.DatabaseField theField)ADVANCED: Set the field in the mapping.java.lang.StringtoString()INTERNAL:protected abstract voidwriteValueIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.helper.DatabaseField field, java.lang.Object value)INTERNAL:- 
Methods inherited from class org.eclipse.persistence.mappings.DatabaseMappingaddUnconvertedProperty, buildBackupClone, buildBackupCloneForPartObject, buildChangeRecord, buildClone, buildCloneForPartObject, buildCloneFromRow, buildContainerClone, buildCopy, buildExpression, buildObjectJoinExpression, buildObjectJoinExpression, buildShallowOriginalFromRow, calculateDeferredChanges, cascadeDiscoverAndPersistUnregisteredNewObjects, cascadePerformRemovePrivateOwnedObjectFromChangeSetIfRequired, cloneFields, collectQueryParameters, compareForChange, compareObjects, convertConverterClassNamesToClasses, createCloneValueHolder, derivesId, earlyPreDelete, extractNestedExpressions, extractNestedNonAggregateExpressions, fixRealObjectReferences, getAttributeAccessor, getAttributeClassification, getAttributeName, getAttributeValueFromObject, getContainerPolicy, getDerivedIdMapping, getDescriptor, getFieldClassification, getFields, getGetMethodName, getMapsIdValue, getObjectCorrespondingTo, getOrderByNormalizedExpressions, getProperties, getProperty, getRealAttributeValueFromAttribute, getRealAttributeValueFromObject, getRealCollectionAttributeValueFromObject, getReferenceDescriptor, getRelationshipPartner, getSelectFields, getSelectTables, getSetMethodName, getUnconvertedProperties, getValueFromRemoteValueHolder, getWeight, hasConstraintDependency, hasDependency, hasInverseConstraintDependency, hasMapsIdValue, hasNestedIdentityReference, hasRootExpressionThatShouldUseOuterJoin, hasUnconvertedProperties, initialize, instantiateAttribute, isAbstractCompositeCollectionMapping, isAbstractCompositeDirectCollectionMapping, isAbstractCompositeObjectMapping, isAbstractDirectMapping, isAggregateCollectionMapping, isAggregateMapping, isAggregateObjectMapping, isAttributeValueFromObjectInstantiated, isCacheable, isCandidateForPrivateOwnedRemoval, isCascadedLockingSupported, isChangeTrackingSupported, isCloningRequired, isCollectionMapping, isDatabaseMapping, isDirectCollectionMapping, isDirectMapMapping, isDirectToFieldMapping, isDirectToXMLTypeMapping, isEISMapping, isElementCollectionMapping, isForeignReferenceMapping, isInAndOutSopObject, isInOnlySopObject, isInSopObject, isJoiningSupported, isJPAId, isLazy, isLockableMapping, isManyToManyMapping, isManyToOneMapping, isMapKeyMapping, isMultitenantPrimaryKeyMapping, isNestedTableMapping, isObjectReferenceMapping, isOneToManyMapping, isOneToOneMapping, isOptional, isOutOnlySopObject, isOutSopObject, isOwned, isPrimaryKeyMapping, isPrivateOwned, isReadOnly, isReferenceMapping, isRelationalMapping, isRemotelyInitialized, isStructureMapping, isTransformationMapping, isUnidirectionalOneToManyMapping, isUsingMethodAccess, isVariableOneToOneMapping, isWriteOnly, isXMLMapping, iterateOnRealAttributeValue, load, loadAll, mergeChangesIntoObject, mergeIntoObject, performDataModificationEvent, postCalculateChanges, postCalculateChangesOnDeleted, postDelete, postInitialize, postInitializeSourceAndTargetExpressions, postInsert, postUpdate, preDelete, preInitialize, preInsert, prepareCascadeLockingPolicy, preUpdate, readFromResultSetIntoObject, readFromRowIntoObject, readOnly, readWrite, recordPrivateOwnedRemovals, rehashFieldDependancies, remoteInitialization, remotelyInitialized, replaceValueHoldersIn, setAttributeAccessor, setAttributeName, setAttributeValueInObject, setChangeListener, setDerivedIdMapping, setDerivesId, setDescriptor, setFields, setGetMethodName, setIsCacheable, setIsInAndOutSopObject, setIsInSopObject, setIsJPAId, setIsLazy, setIsMapKeyMapping, setIsOptional, setIsOutSopObject, setIsPrimaryKeyMapping, setIsReadOnly, setMapsIdValue, setProperties, setProperty, setRealAttributeValueInObject, setSetMethodName, setWeight, simpleAddToCollectionChangeRecord, simpleRemoveFromCollectionChangeRecord, updateChangeRecord, updateCollectionChangeRecord, validateAfterInitialization, validateBeforeInitialization, valueFromObject, valueFromResultSet, valueFromRow, valueFromRow, verifyDelete, writeFromAttributeIntoRow, writeFromObjectIntoRow, writeFromObjectIntoRowForShallowInsert, writeFromObjectIntoRowForShallowInsertWithChangeRecord, writeFromObjectIntoRowForUpdate, writeFromObjectIntoRowForUpdateAfterShallowInsert, writeFromObjectIntoRowForUpdateBeforeShallowDelete, writeFromObjectIntoRowForWhereClause, writeFromObjectIntoRowWithChangeRecord, writeInsertFieldsIntoRow, writeUpdateFieldsIntoRow
 
- 
 
- 
- 
- 
Field Detail- 
fieldprotected org.eclipse.persistence.internal.helper.DatabaseField field DatabaseField which this mapping represents.
 - 
converterprotected Converter converter Allows user defined conversion between the object attribute value and the database value.
 - 
converterClassNameprotected java.lang.String converterClassName 
 - 
isInsertableprotected boolean isInsertable Flag to support insertable JPA setting
 - 
isUpdatableprotected boolean isUpdatable Flag to support updatable JPA setting
 
- 
 - 
Method Detail- 
cascadePerformRemoveIfRequiredpublic void cascadePerformRemoveIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade perform delete through mappings that require the cascade.- Specified by:
- cascadePerformRemoveIfRequiredin class- DatabaseMapping
 
 - 
cascadeRegisterNewIfRequiredpublic void cascadeRegisterNewIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade registerNew for Create through mappings that require the cascade.- Specified by:
- cascadeRegisterNewIfRequiredin class- DatabaseMapping
 
 - 
clonepublic java.lang.Object clone() INTERNAL: The mapping clones itself to create deep copy.- Overrides:
- clonein class- DatabaseMapping
 
 - 
collectFieldsprotected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> collectFields() Returns the field this mapping represents.- Overrides:
- collectFieldsin class- DatabaseMapping
 
 - 
convertClassNamesToClassespublic void convertClassNamesToClasses(java.lang.ClassLoader classLoader) INTERNAL: Convert all the class-name-based settings in this mapping to actual class-based settings This method is implemented by subclasses as necessary.- Overrides:
- convertClassNamesToClassesin class- DatabaseMapping
 
 - 
fixObjectReferencespublic void fixObjectReferences(java.lang.Object object, java.util.Map objectDescriptors, java.util.Map processedObjects, ObjectLevelReadQuery query, DistributedSession session)INTERNAL: An object has been serialized from the server to the client. Replace the transient attributes of the remote value holders with client-side objects.- Specified by:
- fixObjectReferencesin class- DatabaseMapping
 
 - 
getConverterpublic Converter getConverter() PUBLIC: Return the converter on the mapping. A converter can be used to convert between the object's value and database value of the attribute.
 - 
getFieldpublic org.eclipse.persistence.internal.helper.DatabaseField getField() INTERNAL: Returns the field which this mapping represents.- Overrides:
- getFieldin class- DatabaseMapping
 
 - 
getFieldValuepublic abstract java.lang.Object getFieldValue(java.lang.Object objectValue, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Convert the object (attribute or property) value to a field value.
 - 
getObjectValuepublic abstract java.lang.Object getObjectValue(java.lang.Object fieldValue, Session session)INTERNAL: Allows for subclasses to convert the the attribute or property value.
 - 
hasConverterpublic boolean hasConverter() Indicates if the mapping has a converter set on it.- Returns:
- true if there is a converter set on the mapping, false otherwise.
 
 - 
isAbstractColumnMappingpublic boolean isAbstractColumnMapping() INTERNAL:- Overrides:
- isAbstractColumnMappingin class- DatabaseMapping
 
 - 
isInsertableprotected boolean isInsertable() INTERNAL: Return true if this mapping is insertable.
 - 
isUpdatableprotected boolean isUpdatable() INTERNAL: Return true if this mapping is updatable.
 - 
iteratepublic void iterate(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator) INTERNAL: Iterate on the appropriate attribute.- Specified by:
- iteratein class- DatabaseMapping
 
 - 
setConverterpublic void setConverter(Converter converter) PUBLIC: Set the converter on the mapping. A converter can be used to convert between the object's value and database value of the attribute.
 - 
setConverterClassNamepublic void setConverterClassName(java.lang.String converterClassName) PUBLIC: Set the converter class name on the mapping. It will be instantiated during the convertClassNamesToClasses. A converter can be used to convert between the object's value and database value of the attribute.
 - 
setFieldpublic void setField(org.eclipse.persistence.internal.helper.DatabaseField theField) ADVANCED: Set the field in the mapping. This can be used for advanced field types, such as XML nodes, or to set the field type.
 - 
toStringpublic java.lang.String toString() INTERNAL:- Overrides:
- toStringin class- DatabaseMapping
 
 - 
writeValueIntoRowprotected abstract void writeValueIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.helper.DatabaseField field, java.lang.Object value)INTERNAL:
 
- 
 
-