org.eclipse.persistence.internal.queries

Class ListContainerPolicy

java.lang.Object

org.eclipse.persistence.internal.queries.ContainerPolicy

org.eclipse.persistence.internal.queries.InterfaceContainerPolicy

org.eclipse.persistence.internal.queries.CollectionContainerPolicy

org.eclipse.persistence.internal.queries.ListContainerPolicy

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, CoreContainerPolicy<AbstractSession>

Direct Known Subclasses:

ArrayListContainerPolicy, IndirectListContainerPolicy, OrderedListContainerPolicy, VectorContainerPolicy

public class ListContainerPolicy
extends CollectionContainerPolicy

Purpose: A ListContainerPolicy is ContainerPolicy whose container class implements the List interface. This signifies that the collection has order

Responsibilities: Provide the functionality to operate on an instance of a List.

See Also:

ContainerPolicy, CollectionContainerPolicy, Serialized Form

Constructor Summary

Constructors

Constructor and Description
ListContainerPolicy() INTERNAL: Construct a new policy.
ListContainerPolicy(java.lang.Class containerClass) INTERNAL: Construct a new policy for the specified class.
ListContainerPolicy(java.lang.String containerClassName) INTERNAL: Construct a new policy for the specified class name.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	get(int index, java.lang.Object container, AbstractSession session) INTERNAL: Returns the element at the specified position in this list.
boolean	hasOrder() INTERNAL: Returns true if the collection has order
int	indexOf(java.lang.Object element, java.lang.Object container, AbstractSession session) INTERNAL: Returns the index in this list of the first occurrence of the specified element, or -1 if this list does not contain this element The session may be required to unwrap for the wrapper policy.
boolean	isListPolicy()
boolean	isValidContainer(java.lang.Object container) INTERNAL: Validate the container type.
void	recordAddToCollectionInChangeRecord(ObjectChangeSet changeSetToAdd, CollectionChangeRecord collectionChangeRecord) This method is used to bridge the behavior between Attribute Change Tracking and deferred change tracking with respect to adding the same instance multiple times.
void	recordRemoveFromCollectionInChangeRecord(ObjectChangeSet changeSetToRemove, CollectionChangeRecord collectionChangeRecord) This method is used to bridge the behavior between Attribute Change Tracking and deferred change tracking with respect to adding the same instance multiple times.
void	updateChangeRecordForSelfMerge(ChangeRecord changeRecord, java.lang.Object source, java.lang.Object target, ForeignReferenceMapping mapping, UnitOfWorkChangeSet parentUOWChangeSet, UnitOfWorkImpl unitOfWork) INTERNAL: Update a ChangeRecord to replace the ChangeSet for the old entity with the changeSet for the new Entity.
java.lang.Object	valueFromPKList(java.lang.Object[] pks, AbstractRecord foreignKeys, ForeignReferenceMapping mapping, AbstractSession session) INTERNAL: This method is used to load a relationship from a list of PKs.

Methods inherited from class org.eclipse.persistence.internal.queries.CollectionContainerPolicy

addInto, buildContainerFromVector, clear, cloneFor, getInterfaceType, isCollectionPolicy, iteratorFor, sizeFor

Methods inherited from class org.eclipse.persistence.internal.queries.InterfaceContainerPolicy

convertClassNamesToClasses, createChangeEvent, createQueryKeyForMapKey, equals, getCloneMethod, getContainerClass, getContainerClassName, getDirectKeyField, hasNext, isMapKeyAttribute, isValidContainerType, setCloneMethod, setContainerClass, setContainerClassName

Methods inherited from class org.eclipse.persistence.internal.queries.ContainerPolicy

addAdditionalFieldsToQuery, addAll, addAll, addFieldsForMapKey, addInto, addInto, addInto, addNestedJoinsQueriesForMapKey, addNextValueFromIteratorInto, buildChangeSetForNewObjectInCollection, buildCloneForKey, buildCollectionEntry, buildDefaultPolicy, buildKey, buildKeyFromJoinedRow, buildPolicyFor, buildPolicyFor, buildReferencesPKList, buildSelectionQueryForDirectCollectionMapping, cascadeDiscoverAndPersistUnregisteredNewObjects, cascadePerformRemoveIfRequired, cascadeRegisterNewIfRequired, clone, clone, compareCollectionsForChange, compareKeys, concatenateContainers, containerInstance, containerInstance, contains, copyMapDataToRow, createWrappedObjectFromExistingWrappedObject, deleteWrappedObject, execute, getAdditionalFieldsForJoin, getAdditionalTablesForJoinQuery, getChangeValuesFrom, getCloneDataFromChangeSet, getDefaultContainerClass, getDescriptorForMapKey, getElementDescriptor, getIdentityFieldsForMapKey, getKeyMappingDataForWriteQuery, getKeySelectionCriteria, getKeyType, hasElementDescriptor, initialize, initializeConstructor, isCursoredStreamPolicy, isCursorPolicy, isDirectMapPolicy, isEmpty, isMapKeyObject, isMappedKeyMapPolicy, isMapPolicy, isOrderedListPolicy, isScrollableCursorPolicy, iterateOnMapKey, keyFrom, keyFromEntry, keyFromIterator, mergeCascadeParts, mergeChanges, next, nextEntry, nextEntry, overridesRead, postCalculateChanges, postCalculateChanges, postInitialize, prepare, prepareForExecution, processAdditionalWritableMapKeyFields, propagatesEventsToCollection, propogatePostDelete, propogatePostInsert, propogatePostUpdate, propogatePreDelete, propogatePreInsert, propogatePreUpdate, recordPrivateOwnedRemovals, recordUpdateToCollectionInChangeRecord, remoteExecute, removeFrom, removeFrom, requiresDataModificationEvents, setDefaultContainerClass, setElementDescriptor, setKeyName, setKeyName, shouldAddAll, shouldIncludeKeyInDeleteEvent, shouldUpdateForeignKeysPostInsert, toString, unwrapElement, unwrapIteratorResult, updateJoinedMappingIndexesForMapKey, vectorFor

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ListContainerPolicy

public ListContainerPolicy()

INTERNAL: Construct a new policy.

ListContainerPolicy

public ListContainerPolicy(java.lang.Class containerClass)

INTERNAL: Construct a new policy for the specified class.

ListContainerPolicy

public ListContainerPolicy(java.lang.String containerClassName)

INTERNAL: Construct a new policy for the specified class name.

Method Detail

get

public java.lang.Object get(int index,
                            java.lang.Object container,
                            AbstractSession session)

INTERNAL: Returns the element at the specified position in this list. The session may be required to unwrap for the wrapper policy.

isValidContainer

public boolean isValidContainer(java.lang.Object container)

INTERNAL: Validate the container type.

Overrides:

isValidContainer in class CollectionContainerPolicy

See Also:

CollectionContainerPolicy.isValidContainer(Object), MapContainerPolicy.isValidContainer(Object)

hasOrder

public boolean hasOrder()

INTERNAL: Returns true if the collection has order

Overrides:

hasOrder in class CollectionContainerPolicy

See Also:

ContainerPolicy.iteratorFor(java.lang.Object)

isListPolicy

public boolean isListPolicy()

Specified by:

isListPolicy in interface CoreContainerPolicy<AbstractSession>

Overrides:

isListPolicy in class ContainerPolicy

indexOf

public int indexOf(java.lang.Object element,
                   java.lang.Object container,
                   AbstractSession session)

INTERNAL: Returns the index in this list of the first occurrence of the specified element, or -1 if this list does not contain this element The session may be required to unwrap for the wrapper policy.

recordAddToCollectionInChangeRecord

public void recordAddToCollectionInChangeRecord(ObjectChangeSet changeSetToAdd,
                                                CollectionChangeRecord collectionChangeRecord)

This method is used to bridge the behavior between Attribute Change Tracking and deferred change tracking with respect to adding the same instance multiple times. Each ContainerPolicy type will implement specific behavior for the collection type it is wrapping. These methods are only valid for collections containing object references

Overrides:

recordAddToCollectionInChangeRecord in class ContainerPolicy

recordRemoveFromCollectionInChangeRecord

public void recordRemoveFromCollectionInChangeRecord(ObjectChangeSet changeSetToRemove,
                                                     CollectionChangeRecord collectionChangeRecord)

This method is used to bridge the behavior between Attribute Change Tracking and deferred change tracking with respect to adding the same instance multiple times. Each ContainerPolicy type will implement specific behavior for the collection type it is wrapping. These methods are only valid for collections containing object references

Overrides:

recordRemoveFromCollectionInChangeRecord in class ContainerPolicy

updateChangeRecordForSelfMerge

public void updateChangeRecordForSelfMerge(ChangeRecord changeRecord,
                                           java.lang.Object source,
                                           java.lang.Object target,
                                           ForeignReferenceMapping mapping,
                                           UnitOfWorkChangeSet parentUOWChangeSet,
                                           UnitOfWorkImpl unitOfWork)

INTERNAL: Update a ChangeRecord to replace the ChangeSet for the old entity with the changeSet for the new Entity. This is used when an Entity is merged into itself and the Entity reference new or detached entities.

Overrides:

updateChangeRecordForSelfMerge in class ContainerPolicy

valueFromPKList

public java.lang.Object valueFromPKList(java.lang.Object[] pks,
                                        AbstractRecord foreignKeys,
                                        ForeignReferenceMapping mapping,
                                        AbstractSession session)

INTERNAL: This method is used to load a relationship from a list of PKs. This list may be available if the relationship has been cached.

Overrides:

valueFromPKList in class ContainerPolicy