|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.eclipse.persistence.mappings.DatabaseMapping
org.eclipse.persistence.mappings.ForeignReferenceMapping
org.eclipse.persistence.mappings.CollectionMapping
org.eclipse.persistence.eis.mappings.EISOneToManyMapping
public class EISOneToManyMapping
An EIS one-to-many mapping is a reference mapping that represents the relationship between a single source object and a collection of mapped persistent Java objects. The source object usually contains a foreign key (pointer) to the target objects (key on source); alternatively, the target objects may contiain a foreign key to the source object (key on target). Because both the source and target objects use interactions, they must all be configured as root object types.
| Record Type | Description |
|---|---|
| Indexed | Ordered collection of record elements. The indexed record EIS format enables Java class attribute values to be retreived by position or index. |
| Mapped | Key-value map based representation of record elements. The mapped record EIS format enables Java class attribute values to be retreived by an object key. |
| XML | Record/Map representation of an XML DOM element. |
EISDescriptor.useIndexedRecordFormat(),
EISDescriptor.useMappedRecordFormat(),
EISDescriptor.useXMLRecordFormat(),
Serialized Form| Field Summary | |
|---|---|
protected XMLField |
foreignKeyGroupingElement
The grouping-element field. |
protected boolean |
isForeignKeyRelationship
Keeps track if any of the fields are foreign keys. |
protected java.util.List |
sourceForeignKeyFields
The (typically primary) source key fields that are referenced by the targetForeignKeyFields. |
protected java.util.Map |
sourceForeignKeysToTargetKeys
This maps the source foreign key fields to the corresponding (primary) target key fields. |
protected java.util.List |
targetForeignKeyFields
The target foreign key fields that reference the sourceKeyFields. |
| Fields inherited from class org.eclipse.persistence.mappings.CollectionMapping |
|---|
containerPolicy, deleteAllQuery, hasCustomDeleteAllQuery, hasOrderBy |
| Fields inherited from class org.eclipse.persistence.mappings.ForeignReferenceMapping |
|---|
cascadeMerge, cascadePersist, cascadeRefresh, cascadeRemove, forceInitializationOfSelectionCriteria, hasCustomSelectionQuery, indirectionPolicy, INNER_JOIN, isPrivateOwned, joinFetch, NONE, OUTER_JOIN, referenceClass, referenceClassName, referenceDescriptor, relationshipPartner, relationshipPartnerAttributeName, requiresTransientWeavedFields, selectionQuery, tempInitSession, usesBatchReading |
| Fields inherited from class org.eclipse.persistence.mappings.DatabaseMapping |
|---|
attributeAccessor, attributeName, descriptor, fields, isLazy, isOptional, isPrimaryKeyMapping, isReadOnly, isRemotelyInitialized, NO_FIELDS, NO_WEIGHT, properties, weight, WEIGHT_1 |
| Constructor Summary | |
|---|---|
EISOneToManyMapping()
|
|
| Method Summary | |
|---|---|
void |
addAscendingOrdering(java.lang.String queryKeyName)
INTERNAL: This method is not supported in an EIS environment. |
void |
addDescendingOrdering(java.lang.String queryKeyName)
INTERNAL: This method is not supported in an EIS environment. |
void |
addForeignKeyField(org.eclipse.persistence.internal.helper.DatabaseField sourceForeignKeyField,
org.eclipse.persistence.internal.helper.DatabaseField targetKeyField)
PUBLIC: Define the source foreign key relationship in the one-to-many mapping. |
void |
addForeignKeyFieldName(java.lang.String sourceForeignKeyFieldName,
java.lang.String targetKeyFieldName)
PUBLIC: Define the source foreign key relationship in the one-to-many mapping. |
java.lang.Object |
buildAddedElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
INTERNAL: Build and return a new element based on the change set. |
java.lang.Object |
buildChangeSet(java.lang.Object element,
org.eclipse.persistence.internal.sessions.ObjectChangeSet owner,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Build and return a change set for the specified element. |
protected java.lang.Object |
buildElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
Build and return a new element based on the change set. |
java.lang.Object |
buildElementFromElement(java.lang.Object element,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
INTERNAL: Build and return a new element based on the specified element. |
java.lang.Object |
buildRemovedElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
INTERNAL: Build and return a new element based on the change set. |
java.lang.Object |
clone()
INTERNAL: Clone the appropriate attributes. |
protected java.util.Vector |
collectFields()
Return all the fields mapped by the mapping. |
boolean |
compareElements(java.lang.Object element1,
java.lang.Object element2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Compare the non-null elements and return true if they are alike. |
boolean |
compareElementsForChange(java.lang.Object element1,
java.lang.Object element2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Compare the non-null elements and return true if they are alike. |
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: Compare the changes between two collections. |
boolean |
compareObjects(java.lang.Object object1,
java.lang.Object object2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Compare the attributes belonging to this mapping for the objects. |
protected void |
deleteAll(DeleteObjectQuery query)
Delete all the reference objects. |
protected void |
deleteAll(DeleteObjectQuery query,
java.lang.Object referenceObjects)
Delete all the reference objects. |
protected void |
deleteReferenceObjectsLeftOnDatabase(DeleteObjectQuery query)
This method will make sure that all the records privately owned by this mapping are actually removed. |
void |
dontUseBatchReading()
INTERNAL: This method is not supported in an EIS environment. |
protected java.lang.Object |
executeBatchQueryForPessimisticLocking(DatabaseQuery query,
org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork,
org.eclipse.persistence.internal.sessions.AbstractRecord argumentRow)
INTERNAL: This method is not supported in an EIS environment. |
protected XMLRecord |
extractKeyRowFromReferenceObject(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractSession session,
XMLRecord parentRecord)
Build and return a database row that contains a foreign key for the specified reference object. |
ModifyQuery |
getDeleteAllQuery()
|
XMLField |
getForeignKeyGroupingElement()
Get the grouping element field on the mapping. |
java.util.Vector |
getForeignKeyRows(org.eclipse.persistence.internal.sessions.AbstractRecord row)
INTERNAL: |
java.util.List |
getSourceForeignKeyFields()
INTERNAL: Return the source foreign key fields. |
java.util.Map |
getSourceForeignKeysToTargetKeys()
INTERNAL: Sets the target foreign key fields. |
java.util.List |
getTargetForeignKeyFields()
INTERNAL: Return the source foreign key fields. |
boolean |
hasCustomDeleteAllQuery()
|
boolean |
hasInverseConstraintDependency()
INTERNAL: Return whether the mapping has any inverse constraint dependencies, such as foreign keys. |
void |
initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Initialize the mapping. |
protected void |
initializeDeleteAllQuery()
Initialize the delete all query. |
protected void |
initializeSourceForeignKeysToTargetKeys()
|
boolean |
isEISMapping()
INTERNAL: |
boolean |
isForeignKeyRelationship()
INTERNAL: Return if the 1-M mapping has a foreign key dependency to its target. |
boolean |
mapKeyHasChanged(java.lang.Object element,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Return whether the element's user-defined Map key has changed since it was cloned from the original version. |
protected boolean |
mustDeleteReferenceObjectsOneByOne()
Return whether the reference objects must be deleted one by one, as opposed to with a single DELETE statement. |
void |
postDelete(DeleteObjectQuery query)
INTERNAL: Delete the reference objects. |
void |
postInsert(WriteObjectQuery query)
INTERNAL: Insert the reference objects. |
void |
postUpdate(WriteObjectQuery query)
INTERNAL: Update the reference objects. |
void |
preDelete(DeleteObjectQuery query)
INTERNAL: Delete the reference objects. |
void |
preInsert(WriteObjectQuery query)
INTERNAL: Insert privately owned parts |
void |
preUpdate(WriteObjectQuery query)
INTERNAL: Update the privately owned parts. |
void |
setDeleteAllCall(Call call)
PUBLIC: The default delete all call for this mapping can be overridden by specifying the new call. |
void |
setDeleteAllSQLString(java.lang.String sqlString)
INTERNAL: This method is not supported in an EIS environment. |
void |
setForeignKeyGroupingElement(java.lang.String xpath)
Set the grouping element field on the mapping. |
void |
setForeignKeyGroupingElement(XMLField field)
Set if the grouping element field on the mapping. |
void |
setIsForeignKeyRelationship(boolean isForeignKeyRelationship)
INTERNAL: Set if the 1-M mapping has a foreign key dependency to its target. |
void |
setSelectionCriteria(Expression anExpression)
INTERNAL: This method is not supported in an EIS environment. |
void |
setSelectionSQLString(java.lang.String sqlString)
INTERNAL: This method is not supported in an EIS environment. |
void |
setSourceForeignKeyFields(java.util.List fields)
INTERNAL: Sets the source foreign key fields. |
void |
setSourceForeignKeysToTargetKeys(java.util.Map sourceToTargetKeyFields)
INTERNAL: Set the source keys to target keys fields association. |
void |
setTargetForeignKeyFields(java.util.List fields)
INTERNAL: Sets the target foreign key fields. |
void |
setUsesBatchReading(boolean usesBatchReading)
INTERNAL: This method is not supported in an EIS environment. |
protected boolean |
shouldObjectModifyCascadeToParts(ObjectLevelModifyQuery query)
Return whether any process leading to object modification should also affect its parts. |
boolean |
shouldUseBatchReading()
INTERNAL: This method is not supported in an EIS environment. |
void |
simpleAddToCollectionChangeRecord(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 have an object add to a collection once the changeSet is applied The referenceKey parameter should only be used for direct Maps. |
void |
simpleRemoveFromCollectionChangeRecord(java.lang.Object referenceKey,
java.lang.Object changeSetToRemove,
org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet,
org.eclipse.persistence.internal.sessions.AbstractSession session)
ADVANCED: This method is used to have an object removed from a collection once the changeSet is applied The referenceKey parameter should only be used for direct Maps. |
void |
useBatchReading()
INTERNAL: This method is not supported in an EIS environment. |
java.lang.Object |
valueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager,
ObjectBuildingQuery sourceQuery,
org.eclipse.persistence.internal.sessions.AbstractSession executionSession)
INTERNAL: Return the value of the reference attribute or a value holder. |
boolean |
verifyDelete(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Used to verify whether the specified object is deleted or not. |
void |
writeFromObjectIntoRow(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Get the appropriate attribute value from the object and put it in the appropriate field of the database row. |
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. |
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. |
void |
writeFromObjectIntoRowForUpdate(WriteObjectQuery writeQuery,
org.eclipse.persistence.internal.sessions.AbstractRecord row)
INTERNAL: If any of the references objects has changed, write out all the keys. |
void |
writeFromObjectIntoRowWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Get the appropriate attribute value from the object and put it in the appropriate field of the database row. |
void |
writeInsertFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Write fields needed for insert into the template for with null values. |
| Methods inherited from class java.lang.Object |
|---|
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
protected boolean isForeignKeyRelationship
protected transient java.util.List targetForeignKeyFields
protected transient java.util.List sourceForeignKeyFields
protected transient java.util.Map sourceForeignKeysToTargetKeys
protected XMLField foreignKeyGroupingElement
| Constructor Detail |
|---|
public EISOneToManyMapping()
| Method Detail |
|---|
public boolean isEISMapping()
isEISMapping in class DatabaseMapping
public void addForeignKeyField(org.eclipse.persistence.internal.helper.DatabaseField sourceForeignKeyField,
org.eclipse.persistence.internal.helper.DatabaseField targetKeyField)
public void addForeignKeyFieldName(java.lang.String sourceForeignKeyFieldName,
java.lang.String targetKeyFieldName)
public boolean isForeignKeyRelationship()
public void setIsForeignKeyRelationship(boolean isForeignKeyRelationship)
public XMLField getForeignKeyGroupingElement()
public void setForeignKeyGroupingElement(java.lang.String xpath)
public boolean hasCustomDeleteAllQuery()
hasCustomDeleteAllQuery in class CollectionMappingpublic ModifyQuery getDeleteAllQuery()
getDeleteAllQuery in class CollectionMappingpublic void setDeleteAllCall(Call call)
setDeleteAllCall in class CollectionMappingpublic void setForeignKeyGroupingElement(XMLField field)
public java.util.List getSourceForeignKeyFields()
public void setSourceForeignKeyFields(java.util.List fields)
public java.util.List getTargetForeignKeyFields()
public void setTargetForeignKeyFields(java.util.List fields)
public java.util.Map getSourceForeignKeysToTargetKeys()
public void setSourceForeignKeysToTargetKeys(java.util.Map sourceToTargetKeyFields)
public boolean hasInverseConstraintDependency()
hasInverseConstraintDependency in class DatabaseMapping
public void initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
throws DescriptorException
initialize in class CollectionMappingDescriptorException
protected void initializeSourceForeignKeysToTargetKeys()
throws DescriptorException
DescriptorExceptionprotected void initializeDeleteAllQuery()
protected boolean mustDeleteReferenceObjectsOneByOne()
mustDeleteReferenceObjectsOneByOne in class CollectionMappingprotected boolean shouldObjectModifyCascadeToParts(ObjectLevelModifyQuery query)
shouldObjectModifyCascadeToParts in class ForeignReferenceMapping
public boolean verifyDelete(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractSession session)
throws DatabaseException
verifyDelete in class CollectionMappingDatabaseException
public void postInsert(WriteObjectQuery query)
throws DatabaseException,
OptimisticLockException
postInsert in class DatabaseMappingDatabaseException
OptimisticLockException
public void postUpdate(WriteObjectQuery query)
throws DatabaseException,
OptimisticLockException
postUpdate in class DatabaseMappingDatabaseException
OptimisticLockException
public void postDelete(DeleteObjectQuery query)
throws DatabaseException,
OptimisticLockException
postDelete in class DatabaseMappingDatabaseException
OptimisticLockException
public void preDelete(DeleteObjectQuery query)
throws DatabaseException,
OptimisticLockException
preDelete in class DatabaseMappingDatabaseException
OptimisticLockException
public void preInsert(WriteObjectQuery query)
throws DatabaseException,
OptimisticLockException
preInsert in class DatabaseMappingDatabaseException
OptimisticLockException
public void preUpdate(WriteObjectQuery query)
throws DatabaseException,
OptimisticLockException
preUpdate in class DatabaseMappingDatabaseException
OptimisticLockException
public java.lang.Object buildAddedElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
public java.lang.Object buildChangeSet(java.lang.Object element,
org.eclipse.persistence.internal.sessions.ObjectChangeSet owner,
org.eclipse.persistence.internal.sessions.AbstractSession session)
protected java.lang.Object buildElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
public java.lang.Object buildElementFromElement(java.lang.Object element,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
public java.lang.Object buildRemovedElementFromChangeSet(java.lang.Object changeSet,
org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
public java.lang.Object clone()
clone in class CollectionMappingprotected java.util.Vector collectFields()
collectFields in class DatabaseMapping
public boolean compareElements(java.lang.Object element1,
java.lang.Object element2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
public boolean mapKeyHasChanged(java.lang.Object element,
org.eclipse.persistence.internal.sessions.AbstractSession session)
public boolean compareElementsForChange(java.lang.Object element1,
java.lang.Object element2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
public 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)
compareForChange in class CollectionMapping
public boolean compareObjects(java.lang.Object object1,
java.lang.Object object2,
org.eclipse.persistence.internal.sessions.AbstractSession session)
compareObjects in class CollectionMapping
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)
simpleAddToCollectionChangeRecord in class CollectionMapping
public void simpleRemoveFromCollectionChangeRecord(java.lang.Object referenceKey,
java.lang.Object changeSetToRemove,
org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet,
org.eclipse.persistence.internal.sessions.AbstractSession session)
simpleRemoveFromCollectionChangeRecord in class CollectionMapping
protected void deleteAll(DeleteObjectQuery query,
java.lang.Object referenceObjects)
throws DatabaseException
DatabaseException
protected void deleteAll(DeleteObjectQuery query)
throws DatabaseException
DatabaseException
protected void deleteReferenceObjectsLeftOnDatabase(DeleteObjectQuery query)
throws DatabaseException,
OptimisticLockException
DatabaseException
OptimisticLockException
protected XMLRecord extractKeyRowFromReferenceObject(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractSession session,
XMLRecord parentRecord)
public java.lang.Object valueFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.queries.JoinedAttributeManager joinManager,
ObjectBuildingQuery sourceQuery,
org.eclipse.persistence.internal.sessions.AbstractSession executionSession)
throws DatabaseException
valueFromRow in class ForeignReferenceMappingDatabaseExceptionpublic java.util.Vector getForeignKeyRows(org.eclipse.persistence.internal.sessions.AbstractRecord row)
public void writeFromObjectIntoRow(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
writeFromObjectIntoRow in class DatabaseMapping
public void writeFromObjectIntoRowForShallowInsert(java.lang.Object object,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
writeFromObjectIntoRowForShallowInsert in class DatabaseMapping
public void writeFromObjectIntoRowForShallowInsertWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
writeFromObjectIntoRowForShallowInsertWithChangeRecord in class DatabaseMapping
public void writeFromObjectIntoRowForUpdate(WriteObjectQuery writeQuery,
org.eclipse.persistence.internal.sessions.AbstractRecord row)
throws DescriptorException
writeFromObjectIntoRowForUpdate in class DatabaseMappingDescriptorException
public void writeFromObjectIntoRowWithChangeRecord(org.eclipse.persistence.internal.sessions.ChangeRecord changeRecord,
org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
writeFromObjectIntoRowWithChangeRecord in class DatabaseMapping
public void writeInsertFieldsIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
writeInsertFieldsIntoRow in class DatabaseMapping
protected java.lang.Object executeBatchQueryForPessimisticLocking(DatabaseQuery query,
org.eclipse.persistence.internal.sessions.UnitOfWorkImpl unitOfWork,
org.eclipse.persistence.internal.sessions.AbstractRecord argumentRow)
public void setSelectionSQLString(java.lang.String sqlString)
setSelectionSQLString in class ForeignReferenceMappingpublic void setSelectionCriteria(Expression anExpression)
setSelectionCriteria in class ForeignReferenceMappingpublic void setUsesBatchReading(boolean usesBatchReading)
setUsesBatchReading in class ForeignReferenceMappingpublic boolean shouldUseBatchReading()
shouldUseBatchReading in class ForeignReferenceMappingpublic void useBatchReading()
useBatchReading in class ForeignReferenceMappingpublic void dontUseBatchReading()
dontUseBatchReading in class ForeignReferenceMappingpublic void addAscendingOrdering(java.lang.String queryKeyName)
addAscendingOrdering in class CollectionMappingpublic void addDescendingOrdering(java.lang.String queryKeyName)
addDescendingOrdering in class CollectionMappingpublic void setDeleteAllSQLString(java.lang.String sqlString)
setDeleteAllSQLString in class CollectionMapping
|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||