org.eclipse.persistence.internal.queries

Class InterfaceContainerPolicy

java.lang.Object

org.eclipse.persistence.internal.queries.ContainerPolicy

org.eclipse.persistence.internal.queries.InterfaceContainerPolicy

All Implemented Interfaces:

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

Direct Known Subclasses:

CollectionContainerPolicy, 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

Constructor Summary

Constructors

Constructor and Description
InterfaceContainerPolicy() INTERNAL: Construct a new policy.
InterfaceContainerPolicy(java.lang.Class containerClass) INTERNAL: Construct a new policy for the specified class.
InterfaceContainerPolicy(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	buildContainerFromVector(java.util.Vector vector, AbstractSession session) INTERNAL: Return a container populated with the contents of the specified Vector.
java.lang.Object	cloneFor(java.lang.Object container) INTERNAL: Return a clone of the specified container.
void	convertClassNamesToClasses(java.lang.ClassLoader classLoader) INTERNAL: Convert all the class-name-based settings in this ContainerPolicy to actual class-based settings.
CollectionChangeEvent	createChangeEvent(java.lang.Object collectionOwner, java.lang.String propertyName, java.lang.Object collectionChanged, java.lang.Object elementChanged, int changeType, java.lang.Integer index, boolean isChangeApplied) INTERNAL: Creates a CollectionChangeEvent for the container
QueryKey	createQueryKeyForMapKey() INTERNAL: Create a query key that links to the map key InterfaceContainerPolicy does not support maps, so this method will return null subclasses will extend this method.
boolean	equals(java.lang.Object object) INTERNAL: Return if the policy is equal to the other.
java.lang.reflect.Method	getCloneMethod() INTERNAL: Return the 'clone()' Method for the container class.
java.lang.Class	getContainerClass() INTERNAL: Returns the container class to be used with this policy.
java.lang.String	getContainerClassName() INTERNAL: Used by the MW
DatabaseField	getDirectKeyField(CollectionMapping mapping) INTERNAL: Return the DatabaseField that represents the key in a DirectMapMapping.
abstract java.lang.Class	getInterfaceType()
boolean	hasNext(java.lang.Object iterator) INTERNAL: Return whether the iterator has more objects,
boolean	isMapKeyAttribute() INTERNAL: Return whether a map key this container policy represents is an attribute By default this method will return false since only subclasses actually represent maps.
boolean	isValidContainerType(java.lang.Class containerType) INTERNAL: Validate the container type.
void	setCloneMethod(java.lang.reflect.Method cloneMethod) INTERNAL: Set the Method that will return a clone of an instance of the containerClass.
void	setContainerClass(java.lang.Class containerClass) INTERNAL: Set the class to use as the container.
void	setContainerClassName(java.lang.String containerClassName) INTERNAL: Used by the MW

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

addAdditionalFieldsToQuery, addAll, addAll, addFieldsForMapKey, addInto, addInto, addInto, addInto, addNestedJoinsQueriesForMapKey, addNextValueFromIteratorInto, buildChangeSetForNewObjectInCollection, buildCloneForKey, buildCollectionEntry, buildDefaultPolicy, buildKey, buildKeyFromJoinedRow, buildPolicyFor, buildPolicyFor, buildReferencesPKList, buildSelectionQueryForDirectCollectionMapping, cascadeDiscoverAndPersistUnregisteredNewObjects, cascadePerformRemoveIfRequired, cascadeRegisterNewIfRequired, clear, clone, clone, compareCollectionsForChange, compareKeys, concatenateContainers, containerInstance, containerInstance, contains, copyMapDataToRow, createWrappedObjectFromExistingWrappedObject, deleteWrappedObject, execute, getAdditionalFieldsForJoin, getAdditionalTablesForJoinQuery, getChangeValuesFrom, getCloneDataFromChangeSet, getDefaultContainerClass, getDescriptorForMapKey, getElementDescriptor, getIdentityFieldsForMapKey, getKeyMappingDataForWriteQuery, getKeySelectionCriteria, getKeyType, hasElementDescriptor, hasOrder, initialize, initializeConstructor, isCollectionPolicy, isCursoredStreamPolicy, isCursorPolicy, isDirectMapPolicy, isEmpty, isListPolicy, isMapKeyObject, isMappedKeyMapPolicy, isMapPolicy, isOrderedListPolicy, isScrollableCursorPolicy, isValidContainer, iterateOnMapKey, iteratorFor, 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, sizeFor, toString, unwrapElement, unwrapIteratorResult, updateChangeRecordForSelfMerge, updateJoinedMappingIndexesForMapKey, valueFromPKList, vectorFor

Methods inherited from class java.lang.Object

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

Constructor Detail

InterfaceContainerPolicy

public InterfaceContainerPolicy()

INTERNAL: Construct a new policy.

InterfaceContainerPolicy

public InterfaceContainerPolicy(java.lang.Class containerClass)

INTERNAL: Construct a new policy for the specified class.

InterfaceContainerPolicy

public InterfaceContainerPolicy(java.lang.String containerClassName)

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

Method Detail

equals

public boolean equals(java.lang.Object object)

INTERNAL: Return if the policy is equal to the other. By default if they are the same class, they are considered equal. This is used for query parse caching.

Overrides:

equals in class ContainerPolicy

cloneFor

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

INTERNAL: Return a clone of the specified container.

Overrides:

cloneFor in class ContainerPolicy

convertClassNamesToClasses

public void convertClassNamesToClasses(java.lang.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 -

createChangeEvent

public CollectionChangeEvent createChangeEvent(java.lang.Object collectionOwner,
                                               java.lang.String propertyName,
                                               java.lang.Object collectionChanged,
                                               java.lang.Object elementChanged,
                                               int changeType,
                                               java.lang.Integer index,
                                               boolean isChangeApplied)

INTERNAL: Creates a CollectionChangeEvent for the container

Specified by:

createChangeEvent in class ContainerPolicy

createQueryKeyForMapKey

public QueryKey createQueryKeyForMapKey()

INTERNAL: Create a query key that links to the map key InterfaceContainerPolicy does not support maps, so this method will return null subclasses will extend this method.

getCloneMethod

public java.lang.reflect.Method getCloneMethod()

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

getContainerClass

public java.lang.Class getContainerClass()

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

Overrides:

getContainerClass in class ContainerPolicy

getContainerClassName

public java.lang.String getContainerClassName()

Description copied from class: ContainerPolicy

INTERNAL: Used by the MW

Overrides:

getContainerClassName in class ContainerPolicy

getDirectKeyField

public DatabaseField getDirectKeyField(CollectionMapping mapping)

INTERNAL: Return the DatabaseField that represents the key in a DirectMapMapping. If the keyMapping is not a DirectMapping, this will return null.

getInterfaceType

public abstract java.lang.Class getInterfaceType()

hasNext

public boolean hasNext(java.lang.Object iterator)

INTERNAL: Return whether the iterator has more objects,

Specified by:

hasNext in interface CoreContainerPolicy<AbstractSession>

Specified by:

hasNext in class ContainerPolicy

See Also:

ContainerPolicy.iteratorFor(java.lang.Object)

isMapKeyAttribute

public boolean isMapKeyAttribute()

INTERNAL: Return whether a map key this container policy represents is an attribute By default this method will return false since only subclasses actually represent maps.

isValidContainerType

public boolean isValidContainerType(java.lang.Class containerType)

INTERNAL: Validate the container type.

Overrides:

isValidContainerType in class ContainerPolicy

setCloneMethod

public void setCloneMethod(java.lang.reflect.Method cloneMethod)

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

setContainerClass

public void setContainerClass(java.lang.Class containerClass)

INTERNAL: Set the class to use as the container.

Specified by:

setContainerClass in interface CoreContainerPolicy<AbstractSession>

Overrides:

setContainerClass in class ContainerPolicy

setContainerClassName

public void setContainerClassName(java.lang.String containerClassName)

Description copied from class: ContainerPolicy

INTERNAL: Used by the MW

Overrides:

setContainerClassName in class ContainerPolicy

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