org.eclipse.persistence.mappings.structures
Interface ArrayCollectionMapping

All Superinterfaces:
ContainerMapping
All Known Implementing Classes:
ArrayMapping, ObjectArrayMapping

public interface ArrayCollectionMapping
extends ContainerMapping

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

See Also:
ArrayCollectionMappingHelper

Method Summary
 Object buildAddedElementFromChangeSet(Object changeSet, org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
          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)
          Build and return a new element based on the specified element.
 Object buildRemovedElementFromChangeSet(Object changeSet, org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
          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, useMapClass
 

Method Detail

buildAddedElementFromChangeSet

Object buildAddedElementFromChangeSet(Object changeSet,
                                      org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
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)
Build and return a new element based on the specified element.


buildRemovedElementFromChangeSet

Object buildRemovedElementFromChangeSet(Object changeSet,
                                        org.eclipse.persistence.internal.sessions.MergeManager mergeManager)
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.