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 and 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 Detail

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.