Module org.eclipse.persistence.core

Package org.eclipse.persistence.mappings.structures

Interface ArrayCollectionMapping

All Superinterfaces:

ContainerMapping

All Known Implementing Classes:

AbstractCompositeCollectionMapping, AbstractCompositeDirectCollectionMapping, ArrayMapping, EISCompositeCollectionMapping, EISCompositeDirectCollectionMapping, ObjectArrayMapping, XMLBinaryDataCollectionMapping, XMLCompositeCollectionMapping, XMLCompositeDirectCollectionMapping, XMLFragmentCollectionMapping, XMLVariableXPathCollectionMapping

public interface ArrayCollectionMapping
extends ContainerMapping

Interface used by the ArrayCollectionMappingHelper to interact with the assorted array collection mappings.

See Also:

• ArrayCollectionMappingHelper

Method Summary

Modifier and Type	Method	Description
Object	buildAddedElementFromChangeSet(Object changeSet, MergeManager mergeManager, AbstractSession targetSession)	Build and return a newly-added element based on the change set.
Object	buildChangeSet(Object element, ObjectChangeSet owner, AbstractSession session)	Build and return a change set for the specified element.
Object	buildElementFromElement(Object element, MergeManager mergeManager, AbstractSession targetSession)	Build and return a new element based on the specified element.
Object	buildRemovedElementFromChangeSet(Object changeSet, MergeManager mergeManager, AbstractSession targetSession)	Build and return a recently-removed element based on the change set.
boolean	compareElements(Object element1, Object element2, AbstractSession session)	Compare the non-null elements and return true if they are alike.
boolean	compareElementsForChange(Object element1, Object element2, AbstractSession session)	Compare the non-null elements and return true if they are alike.
String	getAttributeName()	Return the mapping's attribute name.
Object	getRealCollectionAttributeValueFromObject(Object object, AbstractSession session)	Return the attribute value from the specified object, unwrapping the value holder if necessary.
boolean	mapKeyHasChanged(Object element, AbstractSession session)	Return whether the element's user-defined Map key has changed since it was cloned from the original version.
void	setRealAttributeValueInObject(Object object, Object attributeValue)	Set the attribute value for the specified object, wrapping it in a value holder if necessary.

Methods inherited from interface org.eclipse.persistence.mappings.ContainerMapping

getContainerPolicy, setContainerPolicy, useCollectionClass, useCollectionClassName, useListClassName, useMapClass, useMapClassName

Method Details

buildAddedElementFromChangeSet

Object buildAddedElementFromChangeSet(Object changeSet,
 MergeManager mergeManager,
 AbstractSession targetSession)

Build and return a newly-added element based on the change set.

buildChangeSet

Object buildChangeSet(Object element,
 ObjectChangeSet owner,
 AbstractSession session)

Build and return a change set for the specified element.

buildElementFromElement

Object buildElementFromElement(Object element,
 MergeManager mergeManager,
 AbstractSession targetSession)

Build and return a new element based on the specified element.

buildRemovedElementFromChangeSet

Object buildRemovedElementFromChangeSet(Object changeSet,
 MergeManager mergeManager,
 AbstractSession targetSession)

Build and return a recently-removed element based on the change set.

compareElements

boolean compareElements(Object element1,
 Object element2,
 AbstractSession session)

Compare the non-null elements and return true if they are alike.

compareElementsForChange

boolean compareElementsForChange(Object element1,
 Object element2,
 AbstractSession session)

Compare the non-null elements and return true if they are alike. This is used to build a change record.

getAttributeName

String getAttributeName()

Return the mapping's attribute name.

getRealCollectionAttributeValueFromObject

Object getRealCollectionAttributeValueFromObject(Object object,
 AbstractSession session)

Return the attribute value from the specified object, unwrapping the value holder if necessary. If the value is null, build a new container.

mapKeyHasChanged

boolean mapKeyHasChanged(Object element,
 AbstractSession session)

Return whether the element's user-defined Map key has changed since it was cloned from the original version.

setRealAttributeValueInObject

void setRealAttributeValueInObject(Object object,
 Object attributeValue)

Set the attribute value for the specified object, wrapping it in a value holder if necessary.