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, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)	Build and return a newly-added element based on the change set.
Object	buildChangeSet(Object element, org.eclipse.persistence.internal.sessions.ObjectChangeSet owner, org.eclipse.persistence.internal.sessions.AbstractSession session)	Build and return a change set for the specified element.
Object	buildElementFromElement(Object element, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)	Build and return a new element based on the specified element.
Object	buildRemovedElementFromChangeSet(Object changeSet, org.eclipse.persistence.internal.sessions.MergeManager mergeManager, org.eclipse.persistence.internal.sessions.AbstractSession targetSession)	Build and return a recently-removed element based on the change set.
boolean	compareElements(Object element1, Object element2, org.eclipse.persistence.internal.sessions.AbstractSession session)	Compare the non-null elements and return true if they are alike.
boolean	compareElementsForChange(Object element1, Object element2, org.eclipse.persistence.internal.sessions.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, org.eclipse.persistence.internal.sessions.AbstractSession session)	Return the attribute value from the specified object, unwrapping the value holder if necessary.
boolean	mapKeyHasChanged(Object element, org.eclipse.persistence.internal.sessions.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,
 org.eclipse.persistence.internal.sessions.MergeManager mergeManager,
 org.eclipse.persistence.internal.sessions.AbstractSession targetSession)

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

buildChangeSet

Object buildChangeSet(Object element,
 org.eclipse.persistence.internal.sessions.ObjectChangeSet owner,
 org.eclipse.persistence.internal.sessions.AbstractSession session)

Build and return a change set for the specified element.

buildElementFromElement

Object buildElementFromElement(Object element,
 org.eclipse.persistence.internal.sessions.MergeManager mergeManager,
 org.eclipse.persistence.internal.sessions.AbstractSession targetSession)

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

buildRemovedElementFromChangeSet

Object buildRemovedElementFromChangeSet(Object changeSet,
 org.eclipse.persistence.internal.sessions.MergeManager mergeManager,
 org.eclipse.persistence.internal.sessions.AbstractSession targetSession)

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

compareElements

boolean compareElements(Object element1,
 Object element2,
 org.eclipse.persistence.internal.sessions.AbstractSession session)

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

compareElementsForChange

boolean compareElementsForChange(Object element1,
 Object element2,
 org.eclipse.persistence.internal.sessions.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,
 org.eclipse.persistence.internal.sessions.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,
 org.eclipse.persistence.internal.sessions.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.