org.eclipse.persistence.internal.queries

Class CollectionContainerPolicy

java.lang.Object

org.eclipse.persistence.internal.queries.ContainerPolicy

org.eclipse.persistence.internal.queries.InterfaceContainerPolicy

org.eclipse.persistence.internal.queries.CollectionContainerPolicy

All Implemented Interfaces:

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

Direct Known Subclasses:

ListContainerPolicy, SortedCollectionContainerPolicy

public class CollectionContainerPolicy
extends InterfaceContainerPolicy

Purpose: A CollectionContainerPolicy is ContainerPolicy whose container class implements the Collection interface.

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

See Also:

ContainerPolicy, MapContainerPolicy, Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
boolean	addInto(java.lang.Object key, java.lang.Object element, java.lang.Object container, AbstractSession session) INTERNAL: Add element into a container which implements the Collection interface.
java.lang.Object	buildContainerFromVector(java.util.Vector vector, AbstractSession session) INTERNAL: Return a container populated with the contents of the specified Vector.
void	clear(java.lang.Object container) INTERNAL: Remove all the elements from container.
java.lang.Object	cloneFor(java.lang.Object container) INTERNAL: Return a clone of the specified container.
java.lang.Class	getInterfaceType()
boolean	hasOrder() INTERNAL: Return whether the collection has order.
boolean	isCollectionPolicy()
boolean	isValidContainer(java.lang.Object container) INTERNAL: Validate the container type.
java.lang.Object	iteratorFor(java.lang.Object container) INTERNAL: Return an iterator for the given container.
int	sizeFor(java.lang.Object container) INTERNAL: Return the size of container.

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, isListPolicy, 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, recordAddToCollectionInChangeRecord, recordPrivateOwnedRemovals, recordRemoveFromCollectionInChangeRecord, recordUpdateToCollectionInChangeRecord, remoteExecute, removeFrom, removeFrom, requiresDataModificationEvents, setDefaultContainerClass, setElementDescriptor, setKeyName, setKeyName, shouldAddAll, shouldIncludeKeyInDeleteEvent, shouldUpdateForeignKeysPostInsert, toString, unwrapElement, unwrapIteratorResult, updateChangeRecordForSelfMerge, updateJoinedMappingIndexesForMapKey, valueFromPKList, vectorFor

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionContainerPolicy

public CollectionContainerPolicy()

INTERNAL: Construct a new policy.

CollectionContainerPolicy

public CollectionContainerPolicy(java.lang.Class containerClass)

INTERNAL: Construct a new policy for the specified class.

CollectionContainerPolicy

public CollectionContainerPolicy(java.lang.String containerClassName)

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

Method Detail

addInto

public boolean addInto(java.lang.Object key,
                       java.lang.Object element,
                       java.lang.Object container,
                       AbstractSession session)

INTERNAL: Add element into a container which implements the Collection interface.

Specified by:

addInto in interface CoreContainerPolicy<AbstractSession>

Overrides:

addInto in class ContainerPolicy

Returns:

boolean indicating whether the container changed.

buildContainerFromVector

public java.lang.Object buildContainerFromVector(java.util.Vector vector,
                                                 AbstractSession session)

INTERNAL: Return a container populated with the contents of the specified Vector.

Overrides:

buildContainerFromVector in class InterfaceContainerPolicy

clear

public void clear(java.lang.Object container)

INTERNAL: Remove all the elements from container.

Specified by:

clear in interface CoreContainerPolicy<AbstractSession>

Overrides:

clear in class ContainerPolicy

Parameters:

container - java.lang.Object

cloneFor

public java.lang.Object cloneFor(java.lang.Object container)

INTERNAL: Return a clone of the specified container.

Overrides:

cloneFor in class InterfaceContainerPolicy

getInterfaceType

public java.lang.Class getInterfaceType()

Specified by:

getInterfaceType in class InterfaceContainerPolicy

hasOrder

public boolean hasOrder()

INTERNAL: Return whether the collection has order. SortedSets cannot be indexed, but they are order-sensitive.

Overrides:

hasOrder in class ContainerPolicy

isValidContainer

public boolean isValidContainer(java.lang.Object container)

INTERNAL: Validate the container type.

Overrides:

isValidContainer in class ContainerPolicy

See Also:

isValidContainer(Object), MapContainerPolicy.isValidContainer(Object)

isCollectionPolicy

public boolean isCollectionPolicy()

Overrides:

isCollectionPolicy in class ContainerPolicy

iteratorFor

public java.lang.Object iteratorFor(java.lang.Object container)

INTERNAL: Return an iterator for the given container.

Specified by:

iteratorFor in interface CoreContainerPolicy<AbstractSession>

Specified by:

iteratorFor in class ContainerPolicy

Parameters:

container - java.lang.Object

Returns:

java.util.Enumeration/java.util.Iterator

See Also:

ContainerPolicy.hasNext(java.lang.Object), ContainerPolicy.next(java.lang.Object)

sizeFor

public int sizeFor(java.lang.Object container)

INTERNAL: Return the size of container.

Specified by:

sizeFor in interface CoreContainerPolicy<AbstractSession>

Overrides:

sizeFor in class ContainerPolicy

Parameters:

anObject - java.lang.Object

Returns:

int The size of the container.