oracle.toplink.essentials.internal.queryframework

Class InterfaceContainerPolicy

java.lang.Object

oracle.toplink.essentials.internal.queryframework.ContainerPolicy

oracle.toplink.essentials.internal.queryframework.InterfaceContainerPolicy

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

CollectionContainerPolicy, DirectMapContainerPolicy, IndirectListContainerPolicy, MapContainerPolicy

public abstract class InterfaceContainerPolicy
extends ContainerPolicy

Purpose: The abstract class for ContainerPolicy's whose container class implements a container interface.

See Also:

CollectionContainerPolicy, MapContainerPolicy, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Method	cloneMethod The method which will return a clone of an instance of the containerClass.
protected Class	containerClass The concrete container class.
protected String	containerClassName

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

constructor, elementDescriptor

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Object	cloneFor(Object container) INTERNAL: Return a clone of the specified container.
void	convertClassNamesToClasses(ClassLoader classLoader) INTERNAL: Convert all the class-name-based settings in this ContainerPolicy to actual class-based settings.
Method	getCloneMethod() INTERNAL: Return the 'clone()' Method for the container class.
protected Method	getCloneMethod(Class javaClass) INTERNAL: Return the 'clone()' Method for the specified class.
Class	getContainerClass() INTERNAL: Returns the container class to be used with this policy.
String	getContainerClassName() INTERNAL: Used by the MW
abstract Class	getInterfaceType()
boolean	hasNext(Object iterator) INTERNAL: Return whether the iterator has more objects,
protected Object	invokeCloneMethodOn(Method method, Object container) INTERNAL: Invoke the specified clone method on the container, handling the necessary exceptions.
boolean	isValidContainerType(Class containerType) INTERNAL: Validate the container type.
protected Object	next(Object iterator) INTERNAL: Return the next object on the queue.
void	setCloneMethod(Method cloneMethod) INTERNAL: Set the Method that will return a clone of an instance of the containerClass.
void	setContainerClass(Class containerClass) INTERNAL: Set the class to use as the container.
void	setContainerClassName(String containerClassName) INTERNAL: Used by the MW
protected Object	toStringInfo()

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

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

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

containerClass

protected Class containerClass

The concrete container class.

containerClassName

protected String containerClassName

cloneMethod

protected transient Method cloneMethod

The method which will return a clone of an instance of the containerClass.

Constructor Detail

InterfaceContainerPolicy

public InterfaceContainerPolicy()

INTERNAL: Construct a new policy.

InterfaceContainerPolicy

public InterfaceContainerPolicy(Class containerClass)

INTERNAL: Construct a new policy for the specified class.

InterfaceContainerPolicy

public InterfaceContainerPolicy(String containerClassName)

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

Method Detail

cloneFor

public Object cloneFor(Object container)

INTERNAL: Return a clone of the specified container.

Overrides:

cloneFor in class ContainerPolicy

convertClassNamesToClasses

public void convertClassNamesToClasses(ClassLoader classLoader)

INTERNAL: Convert all the class-name-based settings in this ContainerPolicy to actual class-based settings. This method is used when converting a project that has been built with class names to a project with classes.

Overrides:

convertClassNamesToClasses in class ContainerPolicy

Parameters:

classLoader -

getCloneMethod

public Method getCloneMethod()

INTERNAL: Return the 'clone()' Method for the container class. Lazy initialization is used, so we can serialize these things.

getCloneMethod

protected Method getCloneMethod(Class javaClass)

INTERNAL: Return the 'clone()' Method for the specified class. Return null if the method does not exist anywhere in the hierarchy

getContainerClass

public Class getContainerClass()

INTERNAL: Returns the container class to be used with this policy.

Overrides:

getContainerClass in class ContainerPolicy

getContainerClassName

public String getContainerClassName()

Description copied from class: ContainerPolicy

INTERNAL: Used by the MW

Overrides:

getContainerClassName in class ContainerPolicy

getInterfaceType

public abstract Class getInterfaceType()

hasNext

public boolean hasNext(Object iterator)

INTERNAL: Return whether the iterator has more objects,

Specified by:

hasNext in class ContainerPolicy

See Also:

ContainerPolicy.iteratorFor(java.lang.Object)

invokeCloneMethodOn

protected Object invokeCloneMethodOn(Method method,
                                     Object container)

INTERNAL: Invoke the specified clone method on the container, handling the necessary exceptions.

isValidContainerType

public boolean isValidContainerType(Class containerType)

INTERNAL: Validate the container type.

Overrides:

isValidContainerType in class ContainerPolicy

next

protected Object next(Object iterator)

INTERNAL: Return the next object on the queue. Valid for some subclasses only.

Specified by:

next in class ContainerPolicy

See Also:

ContainerPolicy.iteratorFor(java.lang.Object)

setCloneMethod

public void setCloneMethod(Method cloneMethod)

INTERNAL: Set the Method that will return a clone of an instance of the containerClass.

setContainerClass

public void setContainerClass(Class containerClass)

INTERNAL: Set the class to use as the container.

Overrides:

setContainerClass in class ContainerPolicy

setContainerClassName

public void setContainerClassName(String containerClassName)

Description copied from class: ContainerPolicy

INTERNAL: Used by the MW

Overrides:

setContainerClassName in class ContainerPolicy

toStringInfo

protected Object toStringInfo()

Overrides:

toStringInfo in class ContainerPolicy