oracle.toplink.essentials.internal.queryframework

Class CollectionContainerPolicy

java.lang.Object

oracle.toplink.essentials.internal.queryframework.ContainerPolicy

oracle.toplink.essentials.internal.queryframework.InterfaceContainerPolicy

oracle.toplink.essentials.internal.queryframework.CollectionContainerPolicy

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

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

Field Summary

Fields inherited from class oracle.toplink.essentials.internal.queryframework.InterfaceContainerPolicy

cloneMethod, containerClass, containerClassName

Fields inherited from class oracle.toplink.essentials.internal.queryframework.ContainerPolicy

constructor, elementDescriptor

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) 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.
protected boolean	contains(java.lang.Object element, java.lang.Object container) INTERNAL: Return the true if element exists in 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.
protected boolean	removeFrom(java.lang.Object key, java.lang.Object element, java.lang.Object container) INTERNAL: Remove element from container which implements the Collection interface.
int	sizeFor(java.lang.Object container) INTERNAL: Return the size of container.

Methods inherited from class oracle.toplink.essentials.internal.queryframework.InterfaceContainerPolicy

cloneFor, convertClassNamesToClasses, getCloneMethod, getCloneMethod, getContainerClass, getContainerClassName, hasNext, invokeCloneMethodOn, isValidContainerType, next, setCloneMethod, setContainerClass, setContainerClassName, toStringInfo

Methods inherited from class oracle.toplink.essentials.internal.queryframework.ContainerPolicy

addInto, addInto, addIntoWithOrder, addIntoWithOrder, addIntoWithOrder, buildPolicyFor, buildPolicyFor, clone, clone, compareCollectionsForChange, compareKeys, concatenateContainers, containerInstance, containerInstance, contains, containsKey, execute, getConstructor, getElementDescriptor, hasElementDescriptor, initializeConstructor, isCursoredStreamPolicy, isCursorPolicy, isCursorStreamPolicy, isDirectMapPolicy, isEmpty, isListPolicy, isMapPolicy, isScrollableCursorPolicy, keyFrom, mergeCascadeParts, mergeChanges, next, overridesRead, prepare, prepareForExecution, recordAddToCollectionInChangeRecord, recordRemoveFromCollectionInChangeRecord, remoteExecute, removeAllElements, removeFrom, removeFrom, removeFromWithOrder, setConstructor, setElementDescriptor, setKeyName, toString, validateElementAndRehashIfRequired, vectorFor

Methods inherited from class java.lang.Object

equals, finalize, 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)

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

Overrides:

addInto in class ContainerPolicy

Parameters:

element - java.lang.Object

container - java.lang.Object

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 ContainerPolicy

clear

public void clear(java.lang.Object container)

INTERNAL: Remove all the elements from container.

Overrides:

clear in class ContainerPolicy

Parameters:

container - java.lang.Object

contains

protected boolean contains(java.lang.Object element,
                           java.lang.Object container)

INTERNAL: Return the true if element exists in container.

Overrides:

contains in class ContainerPolicy

Parameters:

element - java.lang.Object

container - java.lang.Object

Returns:

boolean true if container 'contains' element

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 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)

removeFrom

protected boolean removeFrom(java.lang.Object key,
                             java.lang.Object element,
                             java.lang.Object container)

INTERNAL: Remove element from container which implements the Collection interface.

Overrides:

removeFrom in class ContainerPolicy

Parameters:

key - java.lang.Object This param represents the key that would be used by this object in a map, may be null

element - java.lang.Object

container - java.lang.Object

sizeFor

public int sizeFor(java.lang.Object container)

INTERNAL: Return the size of container.

Overrides:

sizeFor in class ContainerPolicy

Parameters:

anObject - java.lang.Object

Returns:

int The size of the container.