Class DatabaseMapping
- 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
-
- All Implemented Interfaces:
java.io.Serializable,java.lang.Cloneable
- Direct Known Subclasses:
AbstractColumnMapping,AbstractCompositeDirectCollectionMapping,AbstractTransformationMapping,AggregateMapping,ForeignReferenceMapping,XMLAbstractAnyMapping,XMLAnyAttributeMapping,XMLChoiceCollectionMapping,XMLChoiceObjectMapping
public abstract class DatabaseMapping extends CoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField> implements java.lang.Cloneable, java.io.Serializable
Purpose: Defines how an attribute of an object maps to and from the database
Responsibilities:
- Define type of relationship (1:1/1:M/M:M/etc.)
- Define instance variable name and fields names required
- Define any additional properties (ownership, indirection, read only, etc.)
- Control building the value for the instance variable from the database row
- Control building the database fields from the object
- Control any pre/post updating/inserting/deleting required to maintain the relationship
- Merges object changes for unit of work.
- Clones objects for unit of work.
- cache computed information to optimize performance
- See Also:
- Serialized Form
- Author:
- Sati
- Since:
- TOPLink/Java 1.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classDatabaseMapping.WriteType
-
Field Summary
Fields Modifier and Type Field Description protected AttributeAccessorattributeAccessorWrapper to store the reference objects.protected java.lang.StringattributeNamePERF: Cache the mappings attribute name.protected DatabaseMappingderivedIdMappingThe id mapping this mapping derives.protected booleanderivesIdUsed by the CMP3Policy to see if this mapping should be used in processing pk classes for find methodsprotected ClassDescriptordescriptorClassDescriptor to which this mapping belongs toprotected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField>fieldsFields associated with the mappings are cachedprotected booleanisCacheableprotected java.lang.BooleanisInSopObjectIrrelevant (and not set) unless descriptor has SerializedObjectPolicy (SOP).protected booleanisJPAIdprotected java.lang.BooleanisLazySpecifies whether this mapping is lazy, this means not included in the default fetch group.protected booleanisMapKeyMappingRecords if this mapping is being used as a MapKeyMapping.protected booleanisOptionalSpecifies whether this mapping is optional (i.e. field may be null).protected booleanisPrimaryKeyMappingPERF: Used as a quick check to see if this mapping is a primary key mapping, set by the object builder during initialization.protected booleanisReadOnlyMakes this mapping read only.protected booleanisRemotelyInitializedIt is needed only in remote initialization and mapping is in parent descriptorprotected java.lang.StringmapsIdValueA mapsId value.protected static java.util.VectorNO_FIELDSUsed to reduce memory for mappings with no fields.protected static java.lang.IntegerNO_WEIGHTUsed to share integer instance to reduce memory.protected java.util.MappropertiesAllow user defined properties.protected java.util.Map<java.lang.String,java.util.List<java.lang.String>>unconvertedPropertiesAllow the user to defined un-converted properties which will be initialized at runtime.protected java.lang.IntegerweightThis is a TopLink defined attribute that allows us to sort the mappingsprotected static java.lang.IntegerWEIGHT_AGGREGATEprotected static java.lang.IntegerWEIGHT_DIRECTprotected static java.lang.IntegerWEIGHT_TO_ONEprotected static java.lang.IntegerWEIGHT_TRANSFORM
-
Constructor Summary
Constructors Constructor Description DatabaseMapping()PUBLIC: Default constructor.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voidaddUnconvertedProperty(java.lang.String propertyName, java.lang.String propertyValue, java.lang.String propertyType)PUBLIC: Add an unconverted property (to be initialiazed at runtime)abstract voidbuildBackupClone(java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork)INTERNAL: Clone the attribute from the clone and assign it to the backup.java.lang.ObjectbuildBackupCloneForPartObject(java.lang.Object attributeValue, java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork)INTERNAL: Require for cloning, the part must be cloned.org.eclipse.persistence.internal.sessions.ChangeRecordbuildChangeRecord(java.lang.Object newValue, org.eclipse.persistence.internal.sessions.ObjectChangeSet owner, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Directly build a change record without comparisonabstract voidbuildClone(java.lang.Object original, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, java.lang.Object clone, java.lang.Integer refreshCascade, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession)INTERNAL: Clone the attribute from the original and assign it to the clone.java.lang.ObjectbuildCloneForPartObject(java.lang.Object attributeValue, java.lang.Object original, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, java.lang.Object clone, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession, java.lang.Integer refreshCascade, boolean isExisting, boolean isFromSharedCache)INTERNAL: Require for cloning, the part must be cloned.abstract voidbuildCloneFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, java.lang.Object clone, org.eclipse.persistence.internal.identitymaps.CacheKey sharedCacheKey, ObjectBuildingQuery sourceQuery, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork, org.eclipse.persistence.internal.sessions.AbstractSession executionSession)INTERNAL: A combination of readFromRowIntoObject and buildClone.java.lang.ObjectbuildContainerClone(java.lang.Object attributeValue, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession)INTERNAL: Performs a first level clone of the attribute.voidbuildCopy(java.lang.Object copy, java.lang.Object original, CopyGroup group)INTERNAL: Copy of the attribute of the object.ExpressionbuildExpression(java.lang.Object queryObject, QueryByExamplePolicy policy, Expression expressionBuilder, java.util.Map processedObjects, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: In case Query By Example is used, this method builds and returns an expression that corresponds to a single attribue and it's value.ExpressionbuildObjectJoinExpression(Expression base, java.lang.Object value, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Used to allow object level comparisons.ExpressionbuildObjectJoinExpression(Expression base, Expression argument, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Used to allow object level comparisons.voidbuildShallowOriginalFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, java.lang.Object original, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession executionSession)INTERNAL: Builds a shallow original object.voidcalculateDeferredChanges(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Used by AttributeLevelChangeTracking to update a changeRecord with calculated changes as apposed to detected changes.voidcascadeDiscoverAndPersistUnregisteredNewObjects(java.lang.Object object, java.util.Map newObjects, java.util.Map unregisteredExistingObjects, java.util.Map visitedObjects, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Set cascadeErrors)INTERNAL: Cascade discover and persist new objects during commit.abstract voidcascadePerformRemoveIfRequired(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 cascadevoidcascadePerformRemovePrivateOwnedObjectFromChangeSetIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade removal of orphaned private owned objects from the UnitOfWorkChangeSetabstract 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 cascadejava.lang.Objectclone()INTERNAL: Clones itself.protected java.util.VectorcloneFields(java.util.Vector fields)INTERNAL: Helper method to clone vector of fields (used in aggregate initialization cloning).protected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField>collectFields()This method must be overwritten in the subclasses to return a vector of all the fields this mapping represents.voidcollectQueryParameters(java.util.Set<org.eclipse.persistence.internal.helper.DatabaseField> record)INTERNAL: This method is used to store the FK fields that can be cached that correspond to noncacheable mappings the FK field values will be used to re-issue the query when cloning the shared cache entityabstract org.eclipse.persistence.internal.sessions.ChangeRecordcompareForChange(java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.ObjectChangeSet owner, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This method was created in VisualAge.abstract booleancompareObjects(java.lang.Object firstObject, java.lang.Object secondObject, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Compare the attributes belonging to this mapping for the objects.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.protected voidconvertConverterClassNamesToClasses(Converter converter, java.lang.ClassLoader classLoader)Convenience method to ensure converters have an opportunity to convert any class names to classes during project setup.org.eclipse.persistence.internal.indirection.DatabaseValueHoldercreateCloneValueHolder(ValueHolderInterface attributeValue, java.lang.Object original, java.lang.Object clone, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession, boolean buildDirectlyFromRow)INTERNAL: Builder the unit of work value holder.booleanderivesId()ADVANCED: Returns true if the mapping references a JPA ID attribute for the CMP3Policy and JPA ID classes.voidearlyPreDelete(DeleteObjectQuery query, java.lang.Object object)INTERNAL: This method is called to update collection tables prior to commit.protected java.util.List<Expression>extractNestedExpressions(java.util.List<Expression> expressions, ExpressionBuilder newRoot)INTERNAL: Extract the nested attribute expressions that apply to this mapping.protected java.util.List<Expression>extractNestedNonAggregateExpressions(java.util.List<Expression> expressions, ExpressionBuilder newRoot, boolean rootExpressionsAllowed)INTERNAL: Extract the nested attribute expressions that apply to this mapping.abstract 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.voidfixRealObjectReferences(java.lang.Object object, java.util.Map objectInformation, java.util.Map processedObjects, ObjectLevelReadQuery query, DistributedSession session)INTERNAL: At this point, we realize we don't have indirection; so we need to replace the reference object(s) with the corresponding object(s) from the remote session.AttributeAccessorgetAttributeAccessor()ADVANCED: Return the attributeAccessor.java.lang.ClassgetAttributeClassification()PUBLIC: The classification type for the attribute this mapping representsjava.lang.StringgetAttributeName()PUBLIC: Return the name of the attribute set in the mapping.java.lang.ObjectgetAttributeValueFromObject(java.lang.Object object)INTERNAL: Return the value of an attribute which this mapping represents for an object.org.eclipse.persistence.internal.queries.ContainerPolicygetContainerPolicy()INTERNAL: Return the mapping's containerPolicy.DatabaseMappinggetDerivedIdMapping()ADVANCED: Set the maps id valueClassDescriptorgetDescriptor()INTERNAL: Return the descriptor to which this mapping belongsorg.eclipse.persistence.internal.helper.DatabaseFieldgetField()INTERNAL: Return the field associated with this mapping if there is exactly one.java.lang.ClassgetFieldClassification(org.eclipse.persistence.internal.helper.DatabaseField fieldToClassify)INTERNAL: Return the classification for the field contained in the mapping.java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField>getFields()INTERNAL: Returns a vector of all the fields this mapping represents.java.lang.StringgetGetMethodName()PUBLIC: This method is invoked reflectively on the reference object to return the value of the attribute in the object.java.lang.StringgetMapsIdValue()ADVANCED: Set the mapped by id valuejava.lang.ObjectgetObjectCorrespondingTo(java.lang.Object object, DistributedSession session, java.util.Map objectDescriptors, java.util.Map processedObjects, ObjectLevelReadQuery query)INTERNAL: return the object on the client corresponding to the specified object.java.util.List<Expression>getOrderByNormalizedExpressions(Expression base)INTERNAL: Return the list of fields that should be used if this mapping is used in an order by.java.util.MapgetProperties()INTERNAL: used as a temporary store for custom SDK usagejava.lang.ObjectgetProperty(java.lang.Object property)ADVANCED: Allow user defined properties.java.lang.ObjectgetRealAttributeValueFromAttribute(java.lang.Object attributeValue, java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Return the value of an attribute unwrapping value holders if required.java.lang.ObjectgetRealAttributeValueFromObject(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Return the value of an attribute unwrapping value holders if required.java.lang.ObjectgetRealCollectionAttributeValueFromObject(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Return the value of an attribute, unwrapping value holders if necessary.ClassDescriptorgetReferenceDescriptor()PUBLIC: Return the referenceDescriptor.DatabaseMappinggetRelationshipPartner()INTERNAL: Return the relationshipPartner mapping for this bi-directional mapping.java.util.VectorgetSelectFields()INTERNAL: Returns the set of fields that should be selected to build this mapping's value(s).java.util.VectorgetSelectTables()INTERNAL: Returns the table(s) that should be selected to build this mapping's value(s).java.lang.StringgetSetMethodName()PUBLIC: This method is invoked reflectively on the reference object to set the value of the attribute in the object.java.util.Map<java.lang.String,java.util.List<java.lang.String>>getUnconvertedProperties()INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method.java.lang.ObjectgetValueFromRemoteValueHolder(org.eclipse.persistence.internal.sessions.remote.RemoteValueHolder remoteValueHolder)INTERNAL: extract and return the appropriate value from the specified remote value holderjava.lang.IntegergetWeight()INTERNAL: Return the weight of the mapping, used to sort mappings to ensure that DirectToField Mappings get merged firstbooleanhasConstraintDependency()INTERNAL: The returns if the mapping has any constraint dependencies, such as foreign keys and join tables.booleanhasDependency()INTERNAL: Return if the mapping has any ownership or other dependency over its target object(s).booleanhasInverseConstraintDependency()INTERNAL: The returns if the mapping has any inverse constraint dependencies, such as foreign keys and join tables.booleanhasMapsIdValue()ADVANCED: Set the mapped by id valuebooleanhasNestedIdentityReference()INTERNAL: Indicates whether the mapping (or at least one of its nested mappings, at any nested depth) references an entity.protected booleanhasRootExpressionThatShouldUseOuterJoin(java.util.List expressions)INTERNAL: If there is root expression in the list then indicates whether it shouldUseOuterJoin, otherwise return false.booleanhasUnconvertedProperties()INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method.voidinitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Allow for initialization of properties and validation.voidinstantiateAttribute(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Trigger the instantiation of the attribute if lazy.booleanisAbstractColumnMapping()INTERNAL:booleanisAbstractCompositeCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAbstractCompositeDirectCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAbstractCompositeObjectMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAbstractDirectMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAggregateCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAggregateMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAggregateObjectMapping()INTERNAL: Related mapping should implement this method to return true.booleanisAttributeValueFromObjectInstantiated(java.lang.Object object)INTERNAL: Return whether the specified object is instantiated.booleanisCacheable()Used to signal that this mapping references a protected/isolated entity and requires special merge/object building behaviour.booleanisCandidateForPrivateOwnedRemoval()INTERNAL: Returns true if the mapping should be added to the UnitOfWork's list of private owned objects for private owned orphan removal.booleanisCascadedLockingSupported()INTERNAL: Used when determining if a mapping supports cascaded version optimistic locking.booleanisChangeTrackingSupported(Project project)INTERNAL: Return if this mapping supports change tracking.booleanisCloningRequired()INTERNAL: Return if this mapping requires its attribute value to be cloned.booleanisCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisDatabaseMapping()INTERNAL:booleanisDirectCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisDirectMapMapping()INTERNAL: Related mapping should implement this method to return true.booleanisDirectToFieldMapping()INTERNAL: Related mapping should implement this method to return true.booleanisDirectToXMLTypeMapping()INTERNAL: Related mapping should implement this method to return true.booleanisEISMapping()INTERNAL: All EIS mappings should implement this method to return true.booleanisElementCollectionMapping()INTERNAL: Related mapping should implement this method to return true.booleanisForeignReferenceMapping()INTERNAL: Related mapping should implement this method to return true.booleanisInAndOutSopObject()INTERNAL: Indicates whether the mapping is both in and out of SerializedObjectPolicy's sopObject.booleanisInOnlySopObject()INTERNAL: Indicates whether the mapping is in SerializedObjectPolicy's sopObject and not out of it.booleanisInSopObject()INTERNAL: Indicates whether the mapping is in SerializedObjectPolicy's sopObject.booleanisJoiningSupported()INTERNAL: Return if this mapping support joining.booleanisJPAId()INTERNAL: Flags that this mapping is part of a JPA id mapping.booleanisLazy()Return if this mapping is lazy.booleanisLockableMapping()INTERNAL: Return whether this mapping should be traversed when we are lockingbooleanisManyToManyMapping()INTERNAL: Related mapping should implement this method to return true.booleanisManyToOneMapping()INTERNAL: Related mapping should implement this method to return true.booleanisMapKeyMapping()booleanisMultitenantPrimaryKeyMapping()INTERNALbooleanisNestedTableMapping()INTERNAL: Related mapping should implement this method to return true.booleanisObjectReferenceMapping()INTERNAL: Related mapping should implement this method to return true.booleanisOneToManyMapping()INTERNAL: Related mapping should implement this method to return true.booleanisOneToOneMapping()INTERNAL: Related mapping should implement this method to return true.booleanisOptional()Return whether the value of this mapping is optional (that is, can be null).booleanisOutOnlySopObject()INTERNAL: Indicates whether the mapping is out of SerializedObjectPolicy's sopObject and not in it.booleanisOutSopObject()INTERNAL: Indicates whether the mapping is out of SerializedObjectPolicy's sopObject.booleanisOwned()Returns true if this mapping is owned by the parent descriptor.booleanisPrimaryKeyMapping()INTERNAL: Set by the Object builder during initialization returns true if this mapping is used as a primary key mapping.booleanisPrivateOwned()INTERNAL: Return if the mapping has ownership over its target object(s).booleanisReadOnly()INTERNAL: Returns true if mapping is read only else false.booleanisReferenceMapping()INTERNAL: Related mapping should implement this method to return true.booleanisRelationalMapping()INTERNAL: All relational mappings should implement this method to return true.protected booleanisRemotelyInitialized()booleanisStructureMapping()INTERNAL: Related mapping should implement this method to return true.booleanisTransformationMapping()INTERNAL: Related mapping should implement this method to return true.booleanisUnidirectionalOneToManyMapping()INTERNAL:booleanisUsingMethodAccess()PUBLIC: Return if method access is used.booleanisVariableOneToOneMapping()INTERNAL: Related mapping should implement this method to return true.booleanisWriteOnly()INTERNAL: Some mappings support no attribute (transformation and multitenant primary key).booleanisXMLMapping()INTERNAL: All relational mappings should implement this method to return true.abstract voiditerate(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator)INTERNAL: Iterate on the appropriate attribute value.voiditerateOnRealAttributeValue(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator, java.lang.Object realAttributeValue)INTERNAL: Iterate on the attribute value.voidload(java.lang.Object object, org.eclipse.persistence.internal.queries.AttributeItem item, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean fromFetchGroup)Force instantiation of the load group.voidloadAll(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.IdentityHashSet loaded)Force instantiation of all indirections.abstract voidmergeChangesIntoObject(java.lang.Object target, org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, java.lang.Object source, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)INTERNAL: Merge changes from the source to the target object.abstract voidmergeIntoObject(java.lang.Object target, boolean isTargetUninitialized, java.lang.Object source, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)INTERNAL: Merge changes from the source to the target object.voidperformDataModificationEvent(java.lang.Object[] event, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Perform the commit event.voidpostCalculateChanges(ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Overridden by mappings that require additional processing of the change record after the record has been calculated.voidpostCalculateChangesOnDeleted(java.lang.Object deletedObject, org.eclipse.persistence.internal.sessions.UnitOfWorkChangeSet uowChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Overridden by mappings that require objects to be deleted contribute to change set creation.voidpostDelete(DeleteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.voidpostInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Allow for initialization of properties and validation that have dependecies no the descriptor being initialized.voidpostInitializeSourceAndTargetExpressions()INTERNAL: Mapping callback for post-initialization of source and target expression fields created when a mapping's selectionCriteria is created early with uninitialized fields.voidpostInsert(WriteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.voidpostUpdate(WriteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.voidpreDelete(DeleteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.voidpreInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Allow for initialization of properties and validation.voidpreInsert(WriteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.voidprepareCascadeLockingPolicy()INTERNAL: A subclass that supports cascade version optimistic locking should implement this method to properly prepare the locking policy for their mapping type.voidpreUpdate(WriteObjectQuery query)INTERNAL: A subclass should implement this method if it wants different behavior.java.lang.ObjectreadFromResultSetIntoObject(java.sql.ResultSet resultSet, java.lang.Object targetObject, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor, java.sql.ResultSetMetaData metaData, int columnNumber, org.eclipse.persistence.internal.databaseaccess.DatabasePlatform platform)INTERNAL: Extract values directly from the result-set.java.lang.ObjectreadFromRowIntoObject(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, java.lang.Object targetObject, org.eclipse.persistence.internal.identitymaps.CacheKey parentCacheKey, ObjectBuildingQuery sourceQuery, org.eclipse.persistence.internal.sessions.AbstractSession executionSession, boolean isTargetProtected)INTERNAL: Extract value from the row and set the attribute to this value in the object.voidreadOnly()PUBLIC: To make mapping read only.voidreadWrite()PUBLIC: The mapping can be dynamically made either readOnly or readWriteOnly.voidrecordPrivateOwnedRemovals(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Overridden by mappings that require objects to be deleted contribute to change set creation.voidrehashFieldDependancies(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Rehash any hashtables based on fields.voidremoteInitialization(DistributedSession session)INTERNAL: Once descriptors are serialized to the remote session.protected voidremotelyInitialized()Set the mapping to be initialized for the remote session.java.util.MapreplaceValueHoldersIn(java.lang.Object object, org.eclipse.persistence.internal.sessions.remote.RemoteSessionController controller)INTERNAL: replace the value holders in the specified reference object(s)voidsetAttributeAccessor(AttributeAccessor attributeAccessor)ADVANCED: Set the attributeAccessor.voidsetAttributeName(java.lang.String attributeName)PUBLIC: Sets the name of the attribute in the mapping.voidsetAttributeValueInObject(java.lang.Object object, java.lang.Object value)INTERNAL: Set the value of the attribute mapped by this mapping.voidsetChangeListener(java.lang.Object clone, java.beans.PropertyChangeListener listener, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Set the change listener if required.voidsetDerivedIdMapping(DatabaseMapping derivedIdMapping)ADVANCED: Used to indicate the mapping references a JPA ID or MapsId attribute for the CMP3Policy and JPA Id classes (as well as Embeddable Id classes).voidsetDerivesId(boolean derivesId)ADVANCED: Used to indicate the mapping references a JPA ID or MapsId attribute for the CMP3Policy and JPA Id classes (as well as Embeddable Id classes).voidsetDescriptor(ClassDescriptor descriptor)INTERNAL: Set the descriptor to which this mapping belongsprotected voidsetFields(java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> fields)INTERNAL: Set the mapping's field collection.voidsetGetMethodName(java.lang.String methodName)PUBLIC: This method is invoked reflectively on the reference object to return the value of the attribute in the object.voidsetIsCacheable(boolean cacheable)Used to signal that this mapping references a protected/isolated entity and requires special merge/object building behaviour.voidsetIsInAndOutSopObject()INTERNAL: Set the mapping is both in and out of SerializedObjectPolicy's sopObjectvoidsetIsInSopObject()INTERNAL: Set the mapping is in SerializedObjectPolicy's sopObject.voidsetIsJPAId()INTERNAL: Flags that this mapping is part of a JPA id mapping.voidsetIsLazy(boolean isLazy)Set if this mapping is lazy.voidsetIsMapKeyMapping(boolean isMapKeyMapping)voidsetIsOptional(boolean isOptional)Used to specify whether the value of this mapping may be null.voidsetIsOutSopObject()INTERNAL: Set the mapping is out of SerializedObjectPolicy's sopObject.voidsetIsPrimaryKeyMapping(boolean isPrimaryKeyMapping)INTERNAL: Set by the Object builder during initialization returns true if this mapping is used as a primary key mapping.voidsetIsReadOnly(boolean aBoolean)PUBLIC: Set this mapping to be read only.voidsetMapsIdValue(java.lang.String mapsIdValue)ADVANCED: Set the maps id valuevoidsetProperties(java.util.Map properties)INTERNAL: Allow user defined properties.voidsetProperty(java.lang.Object property, java.lang.Object value)ADVANCED: Allow user defined properties.voidsetRealAttributeValueInObject(java.lang.Object object, java.lang.Object value)INTERNAL: Set the value of the attribute mapped by this mapping, placing it inside a value holder if necessary.voidsetSetMethodName(java.lang.String methodName)PUBLIC: Set the methodName used to set the value for the mapping's attribute into the object.voidsetWeight(java.lang.Integer newWeight)ADVANCED: Set the weight of the mapping, used to sort mappings DirectToField Mappings have a default weight of 1 while all other Mappings have a default weight of MAXINT.voidsimpleAddToCollectionChangeRecord(java.lang.Object referenceKey, java.lang.Object changeSetToAdd, org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet, org.eclipse.persistence.internal.sessions.AbstractSession session)ADVANCED: This method is used to add an object to a collection once the changeSet is applied.voidsimpleRemoveFromCollectionChangeRecord(java.lang.Object referenceKey, java.lang.Object changeSetToAdd, org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet, org.eclipse.persistence.internal.sessions.AbstractSession session)ADVANCED: This method is used to remove an object from a collection once the changeSet is applied.java.lang.StringtoString()INTERNAL: Print the mapping attribute name, this is used in error messages.voidupdateChangeRecord(java.lang.Object clone, java.lang.Object newValue, java.lang.Object oldValue, org.eclipse.persistence.internal.sessions.ObjectChangeSet objectChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Either create a new change record or update the change record with the new value.voidupdateCollectionChangeRecord(CollectionChangeEvent event, org.eclipse.persistence.internal.sessions.ObjectChangeSet objectChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Add or removes a new value and its change set to the collection change record based on the event passed in.voidvalidateAfterInitialization(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Allow for subclasses to perform validation.voidvalidateBeforeInitialization(org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Allow for subclasses to perform validation.java.lang.ObjectvalueFromObject(java.lang.Object anObject, org.eclipse.persistence.internal.helper.DatabaseField field, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: A subclass should extract the value from the object for the field, if it does not map the field then it should return null.java.lang.ObjectvalueFromResultSet(java.sql.ResultSet resultSet, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor, java.sql.ResultSetMetaData metaData, int columnNumber, org.eclipse.persistence.internal.databaseaccess.DatabasePlatform platform)INTERNAL: Returns the value for the mapping directly from the result-set.java.lang.ObjectvalueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, boolean isTargetProtected)INTERNAL: A subclass should implement this method if it wants different behavior.java.lang.ObjectvalueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isTargetProtected, java.lang.Boolean[] wasCacheUsed)INTERNAL: A subclass should implement this method if it wants different behavior.booleanverifyDelete(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: To verify if the specified object has been deleted or not.voidwriteFromAttributeIntoRow(java.lang.Object attribute, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: A subclass should implement this method if it wants different behavior.voidwriteFromObjectIntoRow(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session, DatabaseMapping.WriteType writeType)INTERNAL: A subclass should implement this method if it wants different behavior.voidwriteFromObjectIntoRowForShallowInsert(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This row is built for shallow insert which happens in case of bidirectional inserts.voidwriteFromObjectIntoRowForShallowInsertWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This row is built for shallow insert which happens in case of bidirectional inserts.voidwriteFromObjectIntoRowForUpdate(WriteObjectQuery query, org.eclipse.persistence.internal.sessions.AbstractRecord row)INTERNAL:voidwriteFromObjectIntoRowForUpdateAfterShallowInsert(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.DatabaseTable table)INTERNAL: This row is built for update after shallow insert which happens in case of bidirectional inserts.voidwriteFromObjectIntoRowForUpdateBeforeShallowDelete(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.DatabaseTable table)INTERNAL: This row is built for update before shallow delete which happens in case of bidirectional inserts.voidwriteFromObjectIntoRowForWhereClause(ObjectLevelModifyQuery query, org.eclipse.persistence.internal.sessions.AbstractRecord row)INTERNAL: A subclass should implement this method if it wants different behavior.voidwriteFromObjectIntoRowWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session, DatabaseMapping.WriteType writeType)INTERNAL: A subclass should implement this method if it wants different behavior.voidwriteInsertFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Write fields needed for insert into the template for with null values.voidwriteUpdateFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Write fields needed for update into the template for with null values.
-
-
-
Field Detail
-
NO_FIELDS
protected static final java.util.Vector NO_FIELDS
Used to reduce memory for mappings with no fields.
-
NO_WEIGHT
protected static final java.lang.Integer NO_WEIGHT
Used to share integer instance to reduce memory.
-
WEIGHT_DIRECT
protected static final java.lang.Integer WEIGHT_DIRECT
-
WEIGHT_TRANSFORM
protected static final java.lang.Integer WEIGHT_TRANSFORM
-
WEIGHT_AGGREGATE
protected static final java.lang.Integer WEIGHT_AGGREGATE
-
WEIGHT_TO_ONE
protected static final java.lang.Integer WEIGHT_TO_ONE
-
descriptor
protected ClassDescriptor descriptor
ClassDescriptor to which this mapping belongs to
-
attributeAccessor
protected AttributeAccessor attributeAccessor
Wrapper to store the reference objects.
-
isReadOnly
protected boolean isReadOnly
Makes this mapping read only. No write are performed on it. Default is false
-
isOptional
protected boolean isOptional
Specifies whether this mapping is optional (i.e. field may be null). Used for DDL generation.
-
isLazy
protected java.lang.Boolean isLazy
Specifies whether this mapping is lazy, this means not included in the default fetch group.
-
fields
protected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> fields
Fields associated with the mappings are cached
-
isRemotelyInitialized
protected boolean isRemotelyInitialized
It is needed only in remote initialization and mapping is in parent descriptor
-
weight
protected java.lang.Integer weight
This is a TopLink defined attribute that allows us to sort the mappings
-
properties
protected java.util.Map properties
Allow user defined properties.
-
unconvertedProperties
protected java.util.Map<java.lang.String,java.util.List<java.lang.String>> unconvertedProperties
Allow the user to defined un-converted properties which will be initialized at runtime.
-
derivesId
protected boolean derivesId
Used by the CMP3Policy to see if this mapping should be used in processing pk classes for find methods
-
isJPAId
protected boolean isJPAId
-
mapsIdValue
protected java.lang.String mapsIdValue
A mapsId value.
-
derivedIdMapping
protected DatabaseMapping derivedIdMapping
The id mapping this mapping derives. Used by the CMP3Policy to see if this mapping should be used in processing pk classes for find methods.
-
isPrimaryKeyMapping
protected boolean isPrimaryKeyMapping
PERF: Used as a quick check to see if this mapping is a primary key mapping, set by the object builder during initialization.
-
attributeName
protected java.lang.String attributeName
PERF: Cache the mappings attribute name.
-
isMapKeyMapping
protected boolean isMapKeyMapping
Records if this mapping is being used as a MapKeyMapping. This is important for recording main mappings
-
isCacheable
protected boolean isCacheable
-
isInSopObject
protected java.lang.Boolean isInSopObject
Irrelevant (and not set) unless descriptor has SerializedObjectPolicy (SOP). If descriptor has SOP, then ObjectLevelReadQuery (with shouldUseSerializedObjectPolicy flag set to true) reads in row that contain both field/value pairs and sopObject. This flag indicates whether the data for this mapping is contained in the row's sopObject or in fields/values. Boolean.TRUE - sopObject (in sopObject) Boolean.FALSE - fields/values (out sopObject); null - both sopObject and fields/values (both in and out sopObject). While writing to the data base the mapping will be used for writing into sopObject unless this flag is set to Boolean.FALSE;
-
-
Method Detail
-
addUnconvertedProperty
public void addUnconvertedProperty(java.lang.String propertyName, java.lang.String propertyValue, java.lang.String propertyType)PUBLIC: Add an unconverted property (to be initialiazed at runtime)
-
buildBackupClone
public abstract void buildBackupClone(java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork)INTERNAL: Clone the attribute from the clone and assign it to the backup.
-
buildBackupCloneForPartObject
public java.lang.Object buildBackupCloneForPartObject(java.lang.Object attributeValue, java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork)INTERNAL: Require for cloning, the part must be cloned.
-
buildClone
public abstract void buildClone(java.lang.Object original, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, java.lang.Object clone, java.lang.Integer refreshCascade, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession)INTERNAL: Clone the attribute from the original and assign it to the clone.
-
buildCloneFromRow
public abstract void buildCloneFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, java.lang.Object clone, org.eclipse.persistence.internal.identitymaps.CacheKey sharedCacheKey, ObjectBuildingQuery sourceQuery, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork, org.eclipse.persistence.internal.sessions.AbstractSession executionSession)INTERNAL: A combination of readFromRowIntoObject and buildClone.buildClone assumes the attribute value exists on the original and can simply be copied.
readFromRowIntoObject assumes that one is building an original.
Both of the above assumptions are false in this method, and actually attempts to do both at the same time.
Extract value from the row and set the attribute to this value in the working copy clone. In order to bypass the shared cache when in transaction a UnitOfWork must be able to populate working copies directly from the row.
-
buildShallowOriginalFromRow
public void buildShallowOriginalFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, java.lang.Object original, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession executionSession)INTERNAL: Builds a shallow original object. Only direct attributes and primary keys are populated. In this way the minimum original required for instantiating a working copy clone can be built without placing it in the shared cache (no concern over cycles).
-
buildCloneForPartObject
public java.lang.Object buildCloneForPartObject(java.lang.Object attributeValue, java.lang.Object original, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, java.lang.Object clone, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession, java.lang.Integer refreshCascade, boolean isExisting, boolean isFromSharedCache)INTERNAL: Require for cloning, the part must be cloned.
-
buildContainerClone
public java.lang.Object buildContainerClone(java.lang.Object attributeValue, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession)INTERNAL: Performs a first level clone of the attribute. This generally means on the container will be cloned.
-
buildCopy
public void buildCopy(java.lang.Object copy, java.lang.Object original, CopyGroup group)INTERNAL: Copy of the attribute of the object. This is NOT used for unit of work but for templatizing an object.
-
buildExpression
public Expression buildExpression(java.lang.Object queryObject, QueryByExamplePolicy policy, Expression expressionBuilder, java.util.Map processedObjects, org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: In case Query By Example is used, this method builds and returns an expression that corresponds to a single attribue and it's value.
-
buildObjectJoinExpression
public Expression buildObjectJoinExpression(Expression base, java.lang.Object value, org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Used to allow object level comparisons.
-
buildObjectJoinExpression
public Expression buildObjectJoinExpression(Expression base, Expression argument, org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Used to allow object level comparisons.
-
cascadePerformRemoveIfRequired
public abstract void cascadePerformRemoveIfRequired(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
-
cascadePerformRemovePrivateOwnedObjectFromChangeSetIfRequired
public void cascadePerformRemovePrivateOwnedObjectFromChangeSetIfRequired(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Map visitedObjects)INTERNAL: Cascade removal of orphaned private owned objects from the UnitOfWorkChangeSet
-
cascadeRegisterNewIfRequired
public abstract 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
-
cascadeDiscoverAndPersistUnregisteredNewObjects
public void cascadeDiscoverAndPersistUnregisteredNewObjects(java.lang.Object object, java.util.Map newObjects, java.util.Map unregisteredExistingObjects, java.util.Map visitedObjects, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Set cascadeErrors)INTERNAL: Cascade discover and persist new objects during commit.
-
calculateDeferredChanges
public void calculateDeferredChanges(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Used by AttributeLevelChangeTracking to update a changeRecord with calculated changes as apposed to detected changes. If an attribute can not be change tracked it's changes can be detected through this process.
-
clone
public java.lang.Object clone()
INTERNAL: Clones itself.- Overrides:
clonein classjava.lang.Object
-
cloneFields
protected java.util.Vector cloneFields(java.util.Vector fields)
INTERNAL: Helper method to clone vector of fields (used in aggregate initialization cloning).
-
collectFields
protected java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> collectFields()
This method must be overwritten in the subclasses to return a vector of all the fields this mapping represents.
-
collectQueryParameters
public void collectQueryParameters(java.util.Set<org.eclipse.persistence.internal.helper.DatabaseField> record)
INTERNAL: This method is used to store the FK fields that can be cached that correspond to noncacheable mappings the FK field values will be used to re-issue the query when cloning the shared cache entity
-
postInitializeSourceAndTargetExpressions
public void postInitializeSourceAndTargetExpressions()
INTERNAL: Mapping callback for post-initialization of source and target expression fields created when a mapping's selectionCriteria is created early with uninitialized fields.
-
compareForChange
public abstract org.eclipse.persistence.internal.sessions.ChangeRecord compareForChange(java.lang.Object clone, java.lang.Object backup, org.eclipse.persistence.internal.sessions.ObjectChangeSet owner, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This method was created in VisualAge.- Returns:
- prototype.changeset.ChangeRecord
-
compareObjects
public abstract boolean compareObjects(java.lang.Object firstObject, java.lang.Object secondObject, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Compare the attributes belonging to this mapping for the objects.
-
convertClassNamesToClasses
public 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.- Parameters:
classLoader-
-
convertConverterClassNamesToClasses
protected void convertConverterClassNamesToClasses(Converter converter, java.lang.ClassLoader classLoader)
Convenience method to ensure converters have an opportunity to convert any class names to classes during project setup.
-
createCloneValueHolder
public org.eclipse.persistence.internal.indirection.DatabaseValueHolder createCloneValueHolder(ValueHolderInterface attributeValue, java.lang.Object original, java.lang.Object clone, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession cloningSession, boolean buildDirectlyFromRow)
INTERNAL: Builder the unit of work value holder.- Parameters:
buildDirectlyFromRow- indicates that we are building the clone directly from a row as opposed to building the original from the row, putting it in the shared cache, and then cloning the original.
-
derivesId
public boolean derivesId()
ADVANCED: Returns true if the mapping references a JPA ID attribute for the CMP3Policy and JPA ID classes.
-
earlyPreDelete
public void earlyPreDelete(DeleteObjectQuery query, java.lang.Object object)
INTERNAL: This method is called to update collection tables prior to commit.
-
extractNestedExpressions
protected java.util.List<Expression> extractNestedExpressions(java.util.List<Expression> expressions, ExpressionBuilder newRoot)
INTERNAL: Extract the nested attribute expressions that apply to this mapping. This is used for partial objects, and batch fetching.
-
extractNestedNonAggregateExpressions
protected java.util.List<Expression> extractNestedNonAggregateExpressions(java.util.List<Expression> expressions, ExpressionBuilder newRoot, boolean rootExpressionsAllowed)
INTERNAL: Extract the nested attribute expressions that apply to this mapping. This is used for joining, and locking. For aggregates return the nested foreign reference mapping, not the aggregate, as the aggregates are not joined, and share their parent's query.- Parameters:
rootExpressionsAllowed- true if newRoot itself can be one of the expressions returned (used for locking)
-
hasRootExpressionThatShouldUseOuterJoin
protected boolean hasRootExpressionThatShouldUseOuterJoin(java.util.List expressions)
INTERNAL: If there is root expression in the list then indicates whether it shouldUseOuterJoin, otherwise return false.
-
hasUnconvertedProperties
public boolean hasUnconvertedProperties()
INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method.
-
fixObjectReferences
public abstract 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.
-
fixRealObjectReferences
public void fixRealObjectReferences(java.lang.Object object, java.util.Map objectInformation, java.util.Map processedObjects, ObjectLevelReadQuery query, DistributedSession session)INTERNAL: At this point, we realize we don't have indirection; so we need to replace the reference object(s) with the corresponding object(s) from the remote session. The default is to do nothing.
-
getAttributeAccessor
public AttributeAccessor getAttributeAccessor()
ADVANCED: Return the attributeAccessor. The attribute accessor is responsible for setting and retrieving the attribute value from the object for this mapping.- Specified by:
getAttributeAccessorin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getAttributeClassification
public java.lang.Class getAttributeClassification()
PUBLIC: The classification type for the attribute this mapping represents- Specified by:
getAttributeClassificationin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getAttributeName
public java.lang.String getAttributeName()
PUBLIC: Return the name of the attribute set in the mapping.- Specified by:
getAttributeNamein classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getAttributeValueFromObject
public java.lang.Object getAttributeValueFromObject(java.lang.Object object) throws DescriptorExceptionINTERNAL: Return the value of an attribute which this mapping represents for an object.- Specified by:
getAttributeValueFromObjectin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>- Throws:
DescriptorException
-
getContainerPolicy
public org.eclipse.persistence.internal.queries.ContainerPolicy getContainerPolicy()
INTERNAL: Return the mapping's containerPolicy.- Specified by:
getContainerPolicyin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getDerivedIdMapping
public DatabaseMapping getDerivedIdMapping()
ADVANCED: Set the maps id value
-
getDescriptor
public ClassDescriptor getDescriptor()
INTERNAL: Return the descriptor to which this mapping belongs- Specified by:
getDescriptorin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getField
public org.eclipse.persistence.internal.helper.DatabaseField getField()
INTERNAL: Return the field associated with this mapping if there is exactly one. This is required for object relational mapping to print them, but because they are defined in in an Enterprise context they cannot be cast to. Mappings that have a field include direct mappings and object relational mappings.- Specified by:
getFieldin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getFieldClassification
public java.lang.Class getFieldClassification(org.eclipse.persistence.internal.helper.DatabaseField fieldToClassify)
INTERNAL: Return the classification for the field contained in the mapping. This is used to convert the row value to a consistent java value. By default this is unknown.
-
getSelectFields
public java.util.Vector getSelectFields()
INTERNAL: Returns the set of fields that should be selected to build this mapping's value(s). This is used by expressions to determine which fields to include in the select clause for non-object expressions.
-
getSelectTables
public java.util.Vector getSelectTables()
INTERNAL: Returns the table(s) that should be selected to build this mapping's value(s). This is used by expressions to determine which tables to include in the from clause for non-object expressions.
-
getFields
public java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> getFields()
INTERNAL: Returns a vector of all the fields this mapping represents.- Specified by:
getFieldsin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getOrderByNormalizedExpressions
public java.util.List<Expression> getOrderByNormalizedExpressions(Expression base)
INTERNAL: Return the list of fields that should be used if this mapping is used in an order by. null means this mapping does not need to normalize it fields (it is a field).
-
getGetMethodName
public java.lang.String getGetMethodName()
PUBLIC: This method is invoked reflectively on the reference object to return the value of the attribute in the object. This method returns the name of the getMethodName or null if not using method access.
-
hasMapsIdValue
public boolean hasMapsIdValue()
ADVANCED: Set the mapped by id value
-
getMapsIdValue
public java.lang.String getMapsIdValue()
ADVANCED: Set the mapped by id value
-
getObjectCorrespondingTo
public java.lang.Object getObjectCorrespondingTo(java.lang.Object object, DistributedSession session, java.util.Map objectDescriptors, java.util.Map processedObjects, ObjectLevelReadQuery query)INTERNAL: return the object on the client corresponding to the specified object. The default is to simply return the object itself, without worrying about maintaining object identity.
-
getProperties
public java.util.Map getProperties()
INTERNAL: used as a temporary store for custom SDK usage
-
getProperty
public java.lang.Object getProperty(java.lang.Object property)
ADVANCED: Allow user defined properties.
-
getRealAttributeValueFromObject
public java.lang.Object getRealAttributeValueFromObject(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Return the value of an attribute unwrapping value holders if required.- Throws:
DescriptorException
-
getRealAttributeValueFromAttribute
public java.lang.Object getRealAttributeValueFromAttribute(java.lang.Object attributeValue, java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Return the value of an attribute unwrapping value holders if required.- Throws:
DescriptorException
-
instantiateAttribute
public void instantiateAttribute(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Trigger the instantiation of the attribute if lazy.
-
isAttributeValueFromObjectInstantiated
public boolean isAttributeValueFromObjectInstantiated(java.lang.Object object)
INTERNAL: Return whether the specified object is instantiated.
-
getRealCollectionAttributeValueFromObject
public java.lang.Object getRealCollectionAttributeValueFromObject(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Return the value of an attribute, unwrapping value holders if necessary. If the value is null, build a new container.- Throws:
DescriptorException
-
getReferenceDescriptor
public ClassDescriptor getReferenceDescriptor()
PUBLIC: Return the referenceDescriptor. This is a descriptor which is associated with the reference class.- Specified by:
getReferenceDescriptorin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
getRelationshipPartner
public DatabaseMapping getRelationshipPartner()
INTERNAL: Return the relationshipPartner mapping for this bi-directional mapping. If the relationshipPartner is null then this is a uni-directional mapping.
-
getSetMethodName
public java.lang.String getSetMethodName()
PUBLIC: This method is invoked reflectively on the reference object to set the value of the attribute in the object. This method returns the name of the setMethodName or null if not using method access.
-
getUnconvertedProperties
public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getUnconvertedProperties()
INTERNAL: Used to store un-converted properties, which are subsequenctly converted at runtime (through the convertClassNamesToClasses method.
-
getValueFromRemoteValueHolder
public java.lang.Object getValueFromRemoteValueHolder(org.eclipse.persistence.internal.sessions.remote.RemoteValueHolder remoteValueHolder)
INTERNAL: extract and return the appropriate value from the specified remote value holder
-
getWeight
public java.lang.Integer getWeight()
INTERNAL: Return the weight of the mapping, used to sort mappings to ensure that DirectToField Mappings get merged first
-
hasConstraintDependency
public boolean hasConstraintDependency()
INTERNAL: The returns if the mapping has any constraint dependencies, such as foreign keys and join tables.
-
isUsingMethodAccess
public boolean isUsingMethodAccess()
PUBLIC: Return if method access is used.
-
hasDependency
public boolean hasDependency()
INTERNAL: Return if the mapping has any ownership or other dependency over its target object(s).
-
hasInverseConstraintDependency
public boolean hasInverseConstraintDependency()
INTERNAL: The returns if the mapping has any inverse constraint dependencies, such as foreign keys and join tables.
-
initialize
public void initialize(org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Allow for initialization of properties and validation.- Throws:
DescriptorException
-
isAggregateCollectionMapping
public boolean isAggregateCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isAggregateMapping
public boolean isAggregateMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isAggregateObjectMapping
public boolean isAggregateObjectMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isCollectionMapping
public boolean isCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isCollectionMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isDatabaseMapping
public boolean isDatabaseMapping()
INTERNAL:
-
isDirectCollectionMapping
public boolean isDirectCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isDirectMapMapping
public boolean isDirectMapMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isDirectToFieldMapping
public boolean isDirectToFieldMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isDirectToFieldMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isElementCollectionMapping
public boolean isElementCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isForeignReferenceMapping
public boolean isForeignReferenceMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isLockableMapping
public boolean isLockableMapping()
INTERNAL: Return whether this mapping should be traversed when we are locking- Returns:
-
isManyToManyMapping
public boolean isManyToManyMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isMapKeyMapping
public boolean isMapKeyMapping()
- Returns:
- the isMapKeyMapping
-
isMultitenantPrimaryKeyMapping
public boolean isMultitenantPrimaryKeyMapping()
INTERNAL
-
setIsMapKeyMapping
public void setIsMapKeyMapping(boolean isMapKeyMapping)
- Parameters:
isMapKeyMapping- the isMapKeyMapping to set
-
isNestedTableMapping
public boolean isNestedTableMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isObjectReferenceMapping
public boolean isObjectReferenceMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isOneToManyMapping
public boolean isOneToManyMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isOneToOneMapping
public boolean isOneToOneMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isManyToOneMapping
public boolean isManyToOneMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isOptional
public boolean isOptional()
Return whether the value of this mapping is optional (that is, can be null). This is a hint and is used when generating DDL.
-
isOwned
public boolean isOwned()
Returns true if this mapping is owned by the parent descriptor. This is generally based on mapping type
-
isJPAId
public boolean isJPAId()
INTERNAL: Flags that this mapping is part of a JPA id mapping. It should be temporary though, as the CMP3Policy should be able to figure things out on its own. The problem being that the JPA mapped superclass descriptors are not initialized and do not have a CMP3Policy set by default.
-
isLazy
public boolean isLazy()
Return if this mapping is lazy. Lazy has different meaning for different mappings. For basic/direct mappings, this can be used exclude it from the descriptor's default fetch group. This means that queries will not include the field(s) required by this mapping by default. This can only be used if the descriptor has a FetchGroupManager and class implements the FetchGroupTracker interface (or is weaved).For relationship mappings this should normally be the same value as indirection, however for eager relationships this can be used with indirection to allow indirection locking and change tracking, but still always force instantiation.
-
setIsJPAId
public void setIsJPAId()
INTERNAL: Flags that this mapping is part of a JPA id mapping. It should be temporary though, as the CMP3Policy should be able to figure things out on its own. The problem being that the JPA mapped superclass descriptors are not initialized and do not have a CMP3Policy set by default.
-
setIsLazy
public void setIsLazy(boolean isLazy)
Set if this mapping is lazy. This can be used for any mapping type to exclude it from the descriptor's default fetch group. This means that queries will not include the field(s) required by this mapping by default. This can only be used if the descriptor has a FetchGroupManager and class implements the FetchGroupTracker interface (or is weaved). This is not the same as indirection on relationships (lazy relationships), as it defers the loading of the source object fields, not the relationship.
-
isEISMapping
public boolean isEISMapping()
INTERNAL: All EIS mappings should implement this method to return true.
-
isRelationalMapping
public boolean isRelationalMapping()
INTERNAL: All relational mappings should implement this method to return true.
-
isXMLMapping
public boolean isXMLMapping()
INTERNAL: All relational mappings should implement this method to return true.
-
isAbstractDirectMapping
public boolean isAbstractDirectMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isAbstractDirectMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isAbstractColumnMapping
public boolean isAbstractColumnMapping()
INTERNAL:
-
isAbstractCompositeDirectCollectionMapping
public boolean isAbstractCompositeDirectCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isAbstractCompositeDirectCollectionMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isAbstractCompositeObjectMapping
public boolean isAbstractCompositeObjectMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isAbstractCompositeObjectMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isAbstractCompositeCollectionMapping
public boolean isAbstractCompositeCollectionMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isAbstractCompositeCollectionMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isJoiningSupported
public boolean isJoiningSupported()
INTERNAL: Return if this mapping support joining.
-
isCloningRequired
public boolean isCloningRequired()
INTERNAL: Return if this mapping requires its attribute value to be cloned.
-
isPrimaryKeyMapping
public boolean isPrimaryKeyMapping()
INTERNAL: Set by the Object builder during initialization returns true if this mapping is used as a primary key mapping.
-
isCandidateForPrivateOwnedRemoval
public boolean isCandidateForPrivateOwnedRemoval()
INTERNAL: Returns true if the mapping should be added to the UnitOfWork's list of private owned objects for private owned orphan removal.
-
isCascadedLockingSupported
public boolean isCascadedLockingSupported()
INTERNAL: Used when determining if a mapping supports cascaded version optimistic locking.
-
isChangeTrackingSupported
public boolean isChangeTrackingSupported(Project project)
INTERNAL: Return if this mapping supports change tracking.
-
isPrivateOwned
public boolean isPrivateOwned()
INTERNAL: Return if the mapping has ownership over its target object(s).
-
isCacheable
public boolean isCacheable()
Used to signal that this mapping references a protected/isolated entity and requires special merge/object building behaviour.
-
setIsCacheable
public void setIsCacheable(boolean cacheable)
Used to signal that this mapping references a protected/isolated entity and requires special merge/object building behaviour.
-
isReadOnly
public boolean isReadOnly()
INTERNAL: Returns true if mapping is read only else false.- Specified by:
isReadOnlyin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isReferenceMapping
public boolean isReferenceMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isReferenceMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isRemotelyInitialized
protected boolean isRemotelyInitialized()
-
isStructureMapping
public boolean isStructureMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isTransformationMapping
public boolean isTransformationMapping()
INTERNAL: Related mapping should implement this method to return true.- Specified by:
isTransformationMappingin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
isUnidirectionalOneToManyMapping
public boolean isUnidirectionalOneToManyMapping()
INTERNAL:
-
isVariableOneToOneMapping
public boolean isVariableOneToOneMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isDirectToXMLTypeMapping
public boolean isDirectToXMLTypeMapping()
INTERNAL: Related mapping should implement this method to return true.
-
isWriteOnly
public boolean isWriteOnly()
INTERNAL: Some mappings support no attribute (transformation and multitenant primary key).- Specified by:
isWriteOnlyin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
iterate
public abstract void iterate(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator)
INTERNAL: Iterate on the appropriate attribute value.
-
iterateOnRealAttributeValue
public void iterateOnRealAttributeValue(org.eclipse.persistence.internal.descriptors.DescriptorIterator iterator, java.lang.Object realAttributeValue)INTERNAL: Iterate on the attribute value. The value holder has already been processed.
-
load
public void load(java.lang.Object object, org.eclipse.persistence.internal.queries.AttributeItem item, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean fromFetchGroup)Force instantiation of the load group.
-
loadAll
public void loadAll(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.IdentityHashSet loaded)Force instantiation of all indirections.
-
mergeChangesIntoObject
public abstract void mergeChangesIntoObject(java.lang.Object target, org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, java.lang.Object source, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)INTERNAL: Merge changes from the source to the target object.
-
mergeIntoObject
public abstract void mergeIntoObject(java.lang.Object target, boolean isTargetUninitialized, java.lang.Object source, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)INTERNAL: Merge changes from the source to the target object.
-
performDataModificationEvent
public void performDataModificationEvent(java.lang.Object[] event, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DatabaseException, DescriptorExceptionINTERNAL: Perform the commit event. This is used in the uow to delay data modifications.- Throws:
DatabaseExceptionDescriptorException
-
postDelete
public void postDelete(DeleteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to delete the reference objects after the actual object is deleted.- Throws:
DatabaseException
-
postInitialize
public void postInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Allow for initialization of properties and validation that have dependecies no the descriptor being initialized.- Throws:
DescriptorException
-
postInsert
public void postInsert(WriteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to insert the reference objects after the actual object is inserted.- Throws:
DatabaseException
-
postUpdate
public void postUpdate(WriteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to update the reference objects after the actual object is updated.- Throws:
DatabaseException
-
preDelete
public void preDelete(DeleteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to delete the reference objects before the actual object is deleted.- Throws:
DatabaseException
-
preInitialize
public void preInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Allow for initialization of properties and validation.- Throws:
DescriptorException
-
preInsert
public void preInsert(WriteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to insert the reference objects before the actual object is inserted.- Throws:
DatabaseException
-
prepareCascadeLockingPolicy
public void prepareCascadeLockingPolicy()
INTERNAL: A subclass that supports cascade version optimistic locking should implement this method to properly prepare the locking policy for their mapping type.
-
preUpdate
public void preUpdate(WriteObjectQuery query) throws DatabaseException
INTERNAL: A subclass should implement this method if it wants different behavior. Recurse thru the parts to update the reference objects before the actual object is updated.- Throws:
DatabaseException
-
readFromRowIntoObject
public java.lang.Object readFromRowIntoObject(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, java.lang.Object targetObject, org.eclipse.persistence.internal.identitymaps.CacheKey parentCacheKey, ObjectBuildingQuery sourceQuery, org.eclipse.persistence.internal.sessions.AbstractSession executionSession, boolean isTargetProtected) throws DatabaseExceptionINTERNAL: Extract value from the row and set the attribute to this value in the object. return value as this value will have been converted to the appropriate type for the object.- Throws:
DatabaseException
-
readFromResultSetIntoObject
public java.lang.Object readFromResultSetIntoObject(java.sql.ResultSet resultSet, java.lang.Object targetObject, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor, java.sql.ResultSetMetaData metaData, int columnNumber, org.eclipse.persistence.internal.databaseaccess.DatabasePlatform platform) throws java.sql.SQLExceptionINTERNAL: Extract values directly from the result-set. PERF: This is used for optimized object building directly from the result-set.- Throws:
java.sql.SQLException
-
readOnly
public void readOnly()
PUBLIC: To make mapping read only. Read-only mappings can be used if two attributes map to the same field. Read-only mappings cannot be used for the primary key or other required fields.
-
readWrite
public void readWrite()
PUBLIC: The mapping can be dynamically made either readOnly or readWriteOnly. This makes mapping go back to default mode.
-
rehashFieldDependancies
public void rehashFieldDependancies(org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Rehash any hashtables based on fields. This is used to clone descriptors for aggregates, which hammer field names, it is probably better not to hammer the field name and this should be refactored.
-
remoteInitialization
public void remoteInitialization(DistributedSession session)
INTERNAL: Once descriptors are serialized to the remote session. All its mappings and reference descriptors are traversed. Usually mappings are initilaized and serialized reference descriptors are replaced with local descriptors if they already exist on the remote session.
-
remotelyInitialized
protected void remotelyInitialized()
Set the mapping to be initialized for the remote session.
-
replaceValueHoldersIn
public java.util.Map replaceValueHoldersIn(java.lang.Object object, org.eclipse.persistence.internal.sessions.remote.RemoteSessionController controller)INTERNAL: replace the value holders in the specified reference object(s)
-
setAttributeAccessor
public void setAttributeAccessor(AttributeAccessor attributeAccessor)
ADVANCED: Set the attributeAccessor. The attribute accessor is responsible for setting and retrieving the attribute value from the object for this mapping. This can be set to an implementor of AttributeAccessor if the attribute requires advanced conversion of the mapping value, or a real attribute does not exist.- Specified by:
setAttributeAccessorin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
setAttributeName
public void setAttributeName(java.lang.String attributeName)
PUBLIC: Sets the name of the attribute in the mapping.- Specified by:
setAttributeNamein classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
setAttributeValueInObject
public void setAttributeValueInObject(java.lang.Object object, java.lang.Object value) throws DescriptorExceptionINTERNAL: Set the value of the attribute mapped by this mapping.- Specified by:
setAttributeValueInObjectin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>- Throws:
DescriptorException
-
setRealAttributeValueInObject
public void setRealAttributeValueInObject(java.lang.Object object, java.lang.Object value) throws DescriptorExceptionINTERNAL: Set the value of the attribute mapped by this mapping, placing it inside a value holder if necessary.- Throws:
DescriptorException
-
setDescriptor
public void setDescriptor(ClassDescriptor descriptor)
INTERNAL: Set the descriptor to which this mapping belongs- Specified by:
setDescriptorin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
setFields
protected void setFields(java.util.Vector<org.eclipse.persistence.internal.helper.DatabaseField> fields)
INTERNAL: Set the mapping's field collection.- Specified by:
setFieldsin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
setGetMethodName
public void setGetMethodName(java.lang.String methodName)
PUBLIC: This method is invoked reflectively on the reference object to return the value of the attribute in the object. This method sets the name of the getMethodName.
-
setIsOptional
public void setIsOptional(boolean isOptional)
Used to specify whether the value of this mapping may be null. This is used when generating DDL.
-
setIsPrimaryKeyMapping
public void setIsPrimaryKeyMapping(boolean isPrimaryKeyMapping)
INTERNAL: Set by the Object builder during initialization returns true if this mapping is used as a primary key mapping.
-
setIsReadOnly
public void setIsReadOnly(boolean aBoolean)
PUBLIC: Set this mapping to be read only. Read-only mappings can be used if two attributes map to the same field. Read-only mappings cannot be used for the primary key or other required fields.
-
setMapsIdValue
public void setMapsIdValue(java.lang.String mapsIdValue)
ADVANCED: Set the maps id value
-
setProperties
public void setProperties(java.util.Map properties)
INTERNAL: Allow user defined properties.
-
setProperty
public void setProperty(java.lang.Object property, java.lang.Object value)ADVANCED: Allow user defined properties.
-
setSetMethodName
public void setSetMethodName(java.lang.String methodName)
PUBLIC: Set the methodName used to set the value for the mapping's attribute into the object.
-
setWeight
public void setWeight(java.lang.Integer newWeight)
ADVANCED: Set the weight of the mapping, used to sort mappings DirectToField Mappings have a default weight of 1 while all other Mappings have a default weight of MAXINT. Ordering of Mappings can be achieved by setting the weight of a particular mapping to a value within the above mentioned limits. By ordering mappings the user can control what order relationships are processed by TopLink.
-
simpleAddToCollectionChangeRecord
public void simpleAddToCollectionChangeRecord(java.lang.Object referenceKey, java.lang.Object changeSetToAdd, org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionADVANCED: This method is used to add an object to a collection once the changeSet is applied. The referenceKey parameter should only be used for direct Maps.- Throws:
DescriptorException
-
simpleRemoveFromCollectionChangeRecord
public void simpleRemoveFromCollectionChangeRecord(java.lang.Object referenceKey, java.lang.Object changeSetToAdd, org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionADVANCED: This method is used to remove an object from a collection once the changeSet is applied. The referenceKey parameter should only be used for direct Maps.- Throws:
DescriptorException
-
toString
public java.lang.String toString()
INTERNAL: Print the mapping attribute name, this is used in error messages.- Overrides:
toStringin classjava.lang.Object
-
validateAfterInitialization
public void validateAfterInitialization(org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Allow for subclasses to perform validation.- Throws:
DescriptorException
-
validateBeforeInitialization
public void validateBeforeInitialization(org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Allow for subclasses to perform validation.- Throws:
DescriptorException
-
valueFromObject
public java.lang.Object valueFromObject(java.lang.Object anObject, org.eclipse.persistence.internal.helper.DatabaseField field, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: A subclass should extract the value from the object for the field, if it does not map the field then it should return null. Return the Value from the object.- Specified by:
valueFromObjectin classCoreMapping<AttributeAccessor,org.eclipse.persistence.internal.sessions.AbstractSession,org.eclipse.persistence.internal.queries.ContainerPolicy,ClassDescriptor,org.eclipse.persistence.internal.helper.DatabaseField>
-
valueFromRow
public java.lang.Object valueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, boolean isTargetProtected) throws DatabaseExceptionINTERNAL: A subclass should implement this method if it wants different behavior. Returns the value for the mapping from the database row.- Throws:
DatabaseException
-
valueFromRow
public java.lang.Object valueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager, ObjectBuildingQuery query, org.eclipse.persistence.internal.identitymaps.CacheKey cacheKey, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isTargetProtected, java.lang.Boolean[] wasCacheUsed) throws DatabaseExceptionINTERNAL: A subclass should implement this method if it wants different behavior. Returns the value for the mapping from the database row. The execution session is the session the query was executed on, and its platform should be used for data conversion.- Throws:
DatabaseException
-
isInSopObject
public boolean isInSopObject()
INTERNAL: Indicates whether the mapping is in SerializedObjectPolicy's sopObject.
-
isInOnlySopObject
public boolean isInOnlySopObject()
INTERNAL: Indicates whether the mapping is in SerializedObjectPolicy's sopObject and not out of it.
-
isOutSopObject
public boolean isOutSopObject()
INTERNAL: Indicates whether the mapping is out of SerializedObjectPolicy's sopObject.
-
isOutOnlySopObject
public boolean isOutOnlySopObject()
INTERNAL: Indicates whether the mapping is out of SerializedObjectPolicy's sopObject and not in it.
-
isInAndOutSopObject
public boolean isInAndOutSopObject()
INTERNAL: Indicates whether the mapping is both in and out of SerializedObjectPolicy's sopObject.
-
setIsInSopObject
public void setIsInSopObject()
INTERNAL: Set the mapping is in SerializedObjectPolicy's sopObject.
-
setIsOutSopObject
public void setIsOutSopObject()
INTERNAL: Set the mapping is out of SerializedObjectPolicy's sopObject.
-
setIsInAndOutSopObject
public void setIsInAndOutSopObject()
INTERNAL: Set the mapping is both in and out of SerializedObjectPolicy's sopObject
-
hasNestedIdentityReference
public boolean hasNestedIdentityReference()
INTERNAL: Indicates whether the mapping (or at least one of its nested mappings, at any nested depth) references an entity. To return true the mapping (or nested mapping) should be ForeignReferenceMapping with non-null and non-aggregate reference descriptor.
-
valueFromResultSet
public java.lang.Object valueFromResultSet(java.sql.ResultSet resultSet, ObjectBuildingQuery query, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor, java.sql.ResultSetMetaData metaData, int columnNumber, org.eclipse.persistence.internal.databaseaccess.DatabasePlatform platform) throws java.sql.SQLExceptionINTERNAL: Returns the value for the mapping directly from the result-set. PERF: Used for optimized object building.- Throws:
java.sql.SQLException
-
verifyDelete
public boolean verifyDelete(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DatabaseExceptionINTERNAL: To verify if the specified object has been deleted or not.- Throws:
DatabaseException
-
writeFromAttributeIntoRow
public void writeFromAttributeIntoRow(java.lang.Object attribute, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: A subclass should implement this method if it wants different behavior. Write the foreign key values from the attribute to the row.
-
writeFromObjectIntoRow
public void writeFromObjectIntoRow(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session, DatabaseMapping.WriteType writeType)INTERNAL: A subclass should implement this method if it wants different behavior. Write the attribute value from the object to the row.
-
writeFromObjectIntoRowForShallowInsert
public void writeFromObjectIntoRowForShallowInsert(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This row is built for shallow insert which happens in case of bidirectional inserts. If mapping overrides this method it must override writeFromObjectIntoRowForUpdateAfterShallowInsert method, too.
-
writeFromObjectIntoRowForUpdateAfterShallowInsert
public void writeFromObjectIntoRowForUpdateAfterShallowInsert(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.DatabaseTable table)INTERNAL: This row is built for update after shallow insert which happens in case of bidirectional inserts. It contains the foreign keys with non null values that were set to null for shallow insert. If mapping overrides writeFromObjectIntoRowForShallowInsert method it must override this one, too.
-
writeFromObjectIntoRowForUpdateBeforeShallowDelete
public void writeFromObjectIntoRowForUpdateBeforeShallowDelete(java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, org.eclipse.persistence.internal.helper.DatabaseTable table)INTERNAL: This row is built for update before shallow delete which happens in case of bidirectional inserts. It contains the same fields as the row built by writeFromObjectIntoRowForUpdateAfterShallowInsert, but all the values are null.
-
writeFromObjectIntoRowWithChangeRecord
public void writeFromObjectIntoRowWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session, DatabaseMapping.WriteType writeType)INTERNAL: A subclass should implement this method if it wants different behavior. Write the attribute value from the object to the row.
-
writeFromObjectIntoRowForShallowInsertWithChangeRecord
public void writeFromObjectIntoRowForShallowInsertWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: This row is built for shallow insert which happens in case of bidirectional inserts.
-
writeFromObjectIntoRowForUpdate
public void writeFromObjectIntoRowForUpdate(WriteObjectQuery query, org.eclipse.persistence.internal.sessions.AbstractRecord row)
INTERNAL:
-
writeFromObjectIntoRowForWhereClause
public void writeFromObjectIntoRowForWhereClause(ObjectLevelModifyQuery query, org.eclipse.persistence.internal.sessions.AbstractRecord row)
INTERNAL: A subclass should implement this method if it wants different behavior. Write the attribute value from the object to the row.
-
writeInsertFieldsIntoRow
public void writeInsertFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Write fields needed for insert into the template for with null values.
-
writeUpdateFieldsIntoRow
public void writeUpdateFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session)INTERNAL: Write fields needed for update into the template for with null values. By default inserted fields are used.
-
updateChangeRecord
public void updateChangeRecord(java.lang.Object clone, java.lang.Object newValue, java.lang.Object oldValue, org.eclipse.persistence.internal.sessions.ObjectChangeSet objectChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow) throws DescriptorExceptionINTERNAL: Either create a new change record or update the change record with the new value. This is used by attribute change tracking.- Throws:
DescriptorException
-
updateCollectionChangeRecord
public void updateCollectionChangeRecord(CollectionChangeEvent event, org.eclipse.persistence.internal.sessions.ObjectChangeSet objectChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow) throws DescriptorException
INTERNAL: Add or removes a new value and its change set to the collection change record based on the event passed in. This is used by attribute change tracking.- Throws:
DescriptorException
-
setChangeListener
public void setChangeListener(java.lang.Object clone, java.beans.PropertyChangeListener listener, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Set the change listener if required. This is required for collections and aggregates or other change tracked mutable objects. This is used for resuming or flushing units of work.
-
setDerivesId
public void setDerivesId(boolean derivesId)
ADVANCED: Used to indicate the mapping references a JPA ID or MapsId attribute for the CMP3Policy and JPA Id classes (as well as Embeddable Id classes). This is different from isPrimaryKeyMapping, as an ID mapping is user specified and can be read only, as long as another writable mapping for the field exists.
-
setDerivedIdMapping
public void setDerivedIdMapping(DatabaseMapping derivedIdMapping)
ADVANCED: Used to indicate the mapping references a JPA ID or MapsId attribute for the CMP3Policy and JPA Id classes (as well as Embeddable Id classes). This is different from isPrimaryKeyMapping, as an ID mapping is user specified and can be read only, as long as another writable mapping for the field exists.
-
buildChangeRecord
public org.eclipse.persistence.internal.sessions.ChangeRecord buildChangeRecord(java.lang.Object newValue, org.eclipse.persistence.internal.sessions.ObjectChangeSet owner, org.eclipse.persistence.internal.sessions.AbstractSession session) throws DescriptorExceptionINTERNAL: Directly build a change record without comparison- Throws:
DescriptorException
-
postCalculateChanges
public void postCalculateChanges(ChangeRecord changeRecord, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)
INTERNAL: Overridden by mappings that require additional processing of the change record after the record has been calculated.
-
postCalculateChangesOnDeleted
public void postCalculateChangesOnDeleted(java.lang.Object deletedObject, org.eclipse.persistence.internal.sessions.UnitOfWorkChangeSet uowChangeSet, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Overridden by mappings that require objects to be deleted contribute to change set creation.
-
recordPrivateOwnedRemovals
public void recordPrivateOwnedRemovals(java.lang.Object object, org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow)INTERNAL: Overridden by mappings that require objects to be deleted contribute to change set creation.
-
-