Module org.eclipse.persistence.core

Package org.eclipse.persistence.queries

Class ObjectLevelModifyQuery

java.lang.Object

org.eclipse.persistence.queries.DatabaseQuery

org.eclipse.persistence.queries.ModifyQuery

org.eclipse.persistence.queries.ObjectLevelModifyQuery

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

DeleteObjectQuery, WriteObjectQuery

public abstract class ObjectLevelModifyQuery
extends ModifyQuery

Purpose: Abstract class for all object modify queries.

Responsibilities:

• Stores & retrieves the object to modify.
• Stores & retrieves the primary key of the objects.

Since:

TOPLink/Java 1.0

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.persistence.queries.DatabaseQuery

DatabaseQuery.ParameterType

Field Summary

Fields

Modifier and Type	Field	Description
protected Object	backupClone
protected Object	object
protected ObjectChangeSet	objectChangeSet
protected Object	primaryKey

Fields inherited from class org.eclipse.persistence.queries.ModifyQuery

forceBatchStatementExecution, isBatchExecutionSupported, modifyRow

Fields inherited from class org.eclipse.persistence.queries.DatabaseQuery

accessors, allowNativeSQLQuery, argumentFields, argumentParameterTypes, arguments, argumentTypeNames, argumentTypes, argumentValues, BATCH_FETCH_PROPERTY, CascadeAggregateDelete, CascadeAllParts, CascadeByMapping, CascadeDependentParts, cascadePolicy, CascadePrivateParts, descriptor, descriptors, doNotRedirect, executionSession, flushOnExecute, hintString, isCustomQueryUsed, isExecutionClone, isNativeConnectionRequired, isPrepared, isUserDefined, isUserDefinedSQLCall, monitorName, name, NoCascading, nullableArguments, parameterDelimiter, partitioningPolicy, properties, queryMechanism, queryTimeout, queryTimeoutUnit, redirector, session, sessionName, shouldBindAllParameters, shouldCacheStatement, shouldCloneCall, shouldMaintainCache, shouldPrepare, shouldRetrieveBypassCache, shouldReturnGeneratedKeys, shouldStoreBypassCache, shouldUseWrapperPolicy, shouldValidateUpdateCallCacheUse, sourceMapping, translationRow

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ObjectLevelModifyQuery()	PUBLIC: Initialize the state of the query.

Method Summary

Modifier and Type	Method	Description
void	checkDescriptor(AbstractSession session)	INTERNAL: Ensure that the descriptor has been set.
Object	executeInUnitOfWork(UnitOfWorkImpl unitOfWork, AbstractRecord translationRow)	INTERNAL: All have done is move code from UnitOfWork.internalExecuteQuery
protected Object	executeInUnitOfWorkObjectLevelModifyQuery(UnitOfWorkImpl unitOfWork, AbstractRecord translationRow)	INTERNAL: This code was moved from UnitOfWork.internalExecuteQuery.
Object	getBackupClone()	INTERNAL: Return the backup clone of the object from the unit of work.
Object	getObject()	PUBLIC: Return the object required for modification.
ObjectChangeSet	getObjectChangeSet()	PUBLIC: Return the ObjectChangeSet representing the object being changed
Object	getPrimaryKey()	INTERNAL: Get the primary key for the query
Class<?>	getReferenceClass()	Return the domain class associated with this query.
String	getReferenceClassName()	INTERNAL: Return the reference class for a query Note: Although the API is designed to avoid classpath dependencies for the MW, since the object is specified at runtime, this will not be an issue.
boolean	isObjectLevelModifyQuery()	PUBLIC: Return if this is an object level modify query.
protected void	prepare()	INTERNAL: Prepare the receiver for execution in a session.
void	prepareForExecution()	INTERNAL: Prepare the receiver for execution in a session.
void	resetMonitorName()	INTERNAL: Return the name to use for the query in performance monitoring.
void	setBackupClone(Object backupClone)	INTERNAL: Set the backup clone of the object from the unit of work.
void	setObject(Object object)	PUBLIC: (REQUIRED) Set the object required for modification.
void	setObjectChangeSet(ObjectChangeSet changeSet)	INTERNAL: Set the ObjectChangeSet representing the object to be written
void	setPrimaryKey(Object primaryKey)	INTERNAL: Set the primary key for the query.
String	toString()

Methods inherited from class org.eclipse.persistence.queries.ModifyQuery

forceBatchStatementExecution, getModifyRow, isBatchExecutionSupported, isModifyQuery, setForceBatchStatementExecution, setIsBatchExecutionSupported, setModifyRow

Methods inherited from class org.eclipse.persistence.queries.DatabaseQuery

addArgument, addArgument, addArgument, addArgument, addArgument, addArgument, addArgumentByTypeName, addArgumentValue, addArgumentValues, addCall, addStatement, bindAllParameters, buildArgumentFields, buildSelectionCriteria, cacheStatement, cascadeAllParts, cascadeByMapping, cascadeOnlyDependentParts, cascadePrivateParts, checkEarlyReturn, checkForCustomQuery, checkPrepare, checkPrepare, clone, clonedQueryExecutionComplete, convertClassNamesToClasses, copyFromQuery, dontBindAllParameters, dontCacheStatement, dontCascadeParts, dontMaintainCache, execute, executeDatabaseQuery, extractRemoteResult, getAccessor, getAccessors, getArgumentParameterTypes, getArguments, getArgumentTypeNames, getArgumentTypes, getArgumentValues, getBatchObjects, getCall, getCascadePolicy, getDatasourceCall, getDatasourceCalls, getDefaultRedirector, getDescriptor, getDescriptors, getDomainClassNounName, getDoNotRedirect, getEJBQLString, getExecutionSession, getFlushOnExecute, getHintString, getJPQLString, getMonitorName, getName, getNullableArguments, getParameterDelimiter, getParameterDelimiterChar, getPartitioningPolicy, getProperties, getProperty, getQueryMechanism, getQueryNounName, getQueryTimeout, getQueryTimeoutUnit, getRedirector, getRedirectorForQuery, getSelectionCriteria, getSensorName, getSession, getSessionName, getShouldBindAllParameters, getSourceMapping, getSQLStatement, getSQLString, getSQLStrings, getTranslatedSQLString, getTranslatedSQLStrings, getTranslationRow, hasAccessor, hasArguments, hasNullableArguments, hasProperties, hasQueryMechanism, hasSessionName, ignoreBindAllParameters, ignoreCacheStatement, isCallQuery, isCascadeOfAggregateDelete, isCustomQueryUsed, isCustomSelectionQuery, isDataModifyQuery, isDataReadQuery, isDefaultPropertiesQuery, isDeleteAllQuery, isDeleteObjectQuery, isDirectReadQuery, isExecutionClone, isExpressionQuery, isInsertObjectQuery, isJPQLCallQuery, isModifyAllQuery, isNativeConnectionRequired, isObjectBuildingQuery, isObjectLevelReadQuery, isPrepared, isReadAllQuery, isReadObjectQuery, isReadQuery, isReportQuery, isResultSetMappingQuery, isSQLCallQuery, isUpdateAllQuery, isUpdateObjectQuery, isUserDefined, isUserDefinedSQLCall, isValueReadQuery, isWriteObjectQuery, maintainCache, prepareCall, prepareCustomQuery, prepareForRemoteExecution, prepareFromQuery, prepareInternal, redirectQuery, remoteExecute, remoteExecute, removeProperty, replaceValueHoldersIn, retrieveBypassCache, rowFromArguments, setAccessor, setAccessors, setAllowNativeSQLQuery, setArguments, setArgumentTypeNames, setArgumentTypes, setArgumentValues, setBatchObjects, setCall, setCascadePolicy, setDatasourceCall, setDescriptor, setDoNotRedirect, setEJBQLString, setExecutionSession, setFlushOnExecute, setHintString, setIsCustomQueryUsed, setIsExecutionClone, setIsNativeConnectionRequired, setIsPrepared, setIsUserDefined, setIsUserDefinedSQLCall, setJPQLString, setName, setNullableArguments, setParameterDelimiter, setPartitioningPolicy, setProperties, setProperty, setQueryMechanism, setQueryTimeout, setQueryTimeoutUnit, setRedirector, setSelectionCriteria, setSession, setSessionName, setShouldBindAllParameters, setShouldBindAllParameters, setShouldCacheStatement, setShouldMaintainCache, setShouldPrepare, setShouldRetrieveBypassCache, setShouldReturnGeneratedKeys, setShouldStoreBypassCache, setShouldUseWrapperPolicy, setShouldValidateUpdateCallCacheUse, setSourceMapping, setSQLStatement, setSQLString, setTranslationRow, shouldAllowNativeSQLQuery, shouldBindAllParameters, shouldCacheStatement, shouldCascadeAllParts, shouldCascadeByMapping, shouldCascadeOnlyDependentParts, shouldCascadeParts, shouldCascadePrivateParts, shouldCloneCall, shouldIgnoreBindAllParameters, shouldIgnoreCacheStatement, shouldMaintainCache, shouldPrepare, shouldPrepare, shouldRetrieveBypassCache, shouldReturnGeneratedKeys, shouldStoreBypassCache, shouldUseWrapperPolicy, shouldValidateUpdateCallCacheUse, storeBypassCache

Methods inherited from class java.lang.Object

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

Field Details

primaryKey

protected Object primaryKey

object

protected Object object

objectChangeSet

protected ObjectChangeSet objectChangeSet

backupClone

protected Object backupClone

Constructor Details

ObjectLevelModifyQuery

protected ObjectLevelModifyQuery()

PUBLIC: Initialize the state of the query.

Method Details

checkDescriptor

public void checkDescriptor(AbstractSession session)
                     throws QueryException

INTERNAL: Ensure that the descriptor has been set.

Overrides:

checkDescriptor in class DatabaseQuery

Throws:

QueryException

executeInUnitOfWork

public Object executeInUnitOfWork(UnitOfWorkImpl unitOfWork,
 AbstractRecord translationRow)
                           throws DatabaseException

INTERNAL: All have done is move code from UnitOfWork.internalExecuteQuery

Overrides:

executeInUnitOfWork in class DatabaseQuery

Parameters:

unitOfWork - - the session in which the receiver will be executed.

translationRow - - the arguments

Returns:

An object, the result of executing the query.

Throws:

DatabaseException - - an error has occurred on the database.

executeInUnitOfWorkObjectLevelModifyQuery

protected Object executeInUnitOfWorkObjectLevelModifyQuery(UnitOfWorkImpl unitOfWork,
 AbstractRecord translationRow)
                                                    throws DatabaseException,
OptimisticLockException

INTERNAL: This code was moved from UnitOfWork.internalExecuteQuery.

Throws:

DatabaseException

OptimisticLockException

getBackupClone

public Object getBackupClone()

INTERNAL: Return the backup clone of the object from the unit of work.

getObject

public Object getObject()

PUBLIC: Return the object required for modification.

getObjectChangeSet

public ObjectChangeSet getObjectChangeSet()

PUBLIC: Return the ObjectChangeSet representing the object being changed

getPrimaryKey

public Object getPrimaryKey()

INTERNAL: Get the primary key for the query

getReferenceClass

public Class<?> getReferenceClass()

Return the domain class associated with this query.

Overrides:

getReferenceClass in class DatabaseQuery

getReferenceClassName

public String getReferenceClassName()

INTERNAL: Return the reference class for a query Note: Although the API is designed to avoid classpath dependencies for the MW, since the object is specified at runtime, this will not be an issue.

Overrides:

getReferenceClassName in class DatabaseQuery

resetMonitorName

public void resetMonitorName()

INTERNAL: Return the name to use for the query in performance monitoring.

Overrides:

resetMonitorName in class DatabaseQuery

isObjectLevelModifyQuery

public boolean isObjectLevelModifyQuery()

PUBLIC: Return if this is an object level modify query.

Overrides:

isObjectLevelModifyQuery in class DatabaseQuery

prepare

protected void prepare()
                throws QueryException

INTERNAL: Prepare the receiver for execution in a session. In particular check that the tables on the descriptor are set.

Overrides:

prepare in class DatabaseQuery

Throws:

QueryException

prepareForExecution

public void prepareForExecution()
                         throws QueryException

INTERNAL: Prepare the receiver for execution in a session. In particular check that the tables on the descriptor are set.

Overrides:

prepareForExecution in class DatabaseQuery

Throws:

QueryException

setBackupClone

public void setBackupClone(Object backupClone)

INTERNAL: Set the backup clone of the object from the unit of work.

setObject

public void setObject(Object object)

PUBLIC: (REQUIRED) Set the object required for modification.

setObjectChangeSet

public void setObjectChangeSet(ObjectChangeSet changeSet)

INTERNAL: Set the ObjectChangeSet representing the object to be written

setPrimaryKey

public void setPrimaryKey(Object primaryKey)

INTERNAL: Set the primary key for the query.

toString

public String toString()

Overrides:

toString in class DatabaseQuery