oracle.toplink.essentials.queryframework

Class DataModifyQuery

java.lang.Object

oracle.toplink.essentials.queryframework.DatabaseQuery

oracle.toplink.essentials.queryframework.ModifyQuery

oracle.toplink.essentials.queryframework.DataModifyQuery

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, FalseUndefinedTrue

public class DataModifyQuery
extends ModifyQuery

Purpose: Concrete class used for executing non selecting SQL strings.

Responsibilities:

• Execute a non selecting raw SQL string.

Since:

TOPLink/Java 1.0

Author:

Yvon Lavoie

See Also:

Serialized Form

Field Summary

Fields inherited from class oracle.toplink.essentials.queryframework.ModifyQuery

forceBatchStatementExecution, modifyRow

Fields inherited from class oracle.toplink.essentials.queryframework.DatabaseQuery

accessor, arguments, argumentTypeNames, argumentTypes, argumentValues, CascadeAggregateDelete, CascadeAllParts, CascadeByMapping, CascadeDependentParts, cascadePolicy, CascadePrivateParts, descriptor, flushOnExecute, isPrepared, isUserDefined, name, NoCascading, properties, queryMechanism, session, sessionName, shouldBindAllParameters, shouldCacheStatement, shouldCloneCall, shouldMaintainCache, shouldPrepare, shouldUseWrapperPolicy, translationRow

Fields inherited from interface oracle.toplink.essentials.internal.helper.FalseUndefinedTrue

False, True, Undefined

Constructor Summary

Constructors

Constructor and Description
DataModifyQuery()
DataModifyQuery(Call call)
DataModifyQuery(java.lang.String sqlString)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	executeDatabaseQuery() INTERNAL: Perform the work to execute the SQL call.
boolean	isDataModifyQuery() PUBLIC: Return if this is a data 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.

Methods inherited from class oracle.toplink.essentials.queryframework.ModifyQuery

forceBatchStatementExecution, getModifyRow, isModifyQuery, setForceBatchStatementExecution, setModifyRow

Methods inherited from class oracle.toplink.essentials.queryframework.DatabaseQuery

addArgument, addArgument, addArgument, addArgumentByTypeName, addArgumentValue, addArgumentValues, addCall, addStatement, bindAllParameters, buildSelectionCriteria, cacheStatement, cascadeAllParts, cascadeByMapping, cascadeOnlyDependentParts, cascadePrivateParts, checkDescriptor, checkEarlyReturn, checkForCustomQuery, checkPrepare, clone, clonedQueryExecutionComplete, convertClassNamesToClasses, deploymentSetShouldMaintainCache, deploymentShouldMaintainCache, dontBindAllParameters, dontCacheStatement, dontCascadeParts, dontMaintainCache, execute, executeInUnitOfWork, getAccessor, getArguments, getArgumentTypeNames, getArgumentTypes, getArgumentValues, getCall, getCascadePolicy, getDatasourceCall, getDatasourceCalls, getDescriptor, getEJBQLString, getFlushOnExecute, getName, getProperties, getProperty, getQueryMechanism, getReferenceClass, getReferenceClassName, getSelectionCriteria, getSession, getSessionName, getShouldBindAllParameters, getSQLStatement, getSQLString, getSQLStrings, getTranslatedSQLString, getTranslatedSQLStrings, getTranslationRow, hasAccessor, hasProperties, hasQueryMechanism, hasSessionName, ignoreBindAllParameters, ignoreCacheStatement, isCallQuery, isCascadeOfAggregateDelete, isDataReadQuery, isDeleteAllQuery, isDeleteObjectQuery, isExpressionQuery, isInsertObjectQuery, isModifyAllQuery, isObjectBuildingQuery, isObjectLevelModifyQuery, isObjectLevelReadQuery, isPrepared, isReadAllQuery, isReadObjectQuery, isReadQuery, isReportQuery, isSQLCallQuery, isUpdateAllQuery, isUpdateObjectQuery, isUserDefined, isWriteObjectQuery, maintainCache, prepareCall, prepareCustomQuery, prepareForRemoteExecution, removeProperty, rowFromArguments, setAccessor, setArguments, setArgumentTypeNames, setArgumentTypes, setArgumentValues, setCall, setCascadePolicy, setDatasourceCall, setDescriptor, setEJBQLString, setFlushOnExecute, setIsPrepared, setIsUserDefined, setName, setProperties, setProperty, setQueryMechanism, setSelectionCriteria, setSession, setSessionName, setShouldBindAllParameters, setShouldBindAllParameters, setShouldCacheStatement, setShouldMaintainCache, setShouldPrepare, setShouldUseWrapperPolicy, setSQLStatement, setSQLString, setTranslationRow, shouldBindAllParameters, shouldCacheStatement, shouldCascadeAllParts, shouldCascadeByMapping, shouldCascadeOnlyDependentParts, shouldCascadeParts, shouldCascadePrivateParts, shouldCloneCall, shouldIgnoreBindAllParameters, shouldIgnoreCacheStatement, shouldMaintainCache, shouldPrepare, shouldUseWrapperPolicy, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

DataModifyQuery

public DataModifyQuery()

DataModifyQuery

public DataModifyQuery(java.lang.String sqlString)

DataModifyQuery

public DataModifyQuery(Call call)

Method Detail

executeDatabaseQuery

public java.lang.Object executeDatabaseQuery()
                                      throws DatabaseException

INTERNAL: Perform the work to execute the SQL call. Return the row count of the number of rows effected by the SQL call.

Specified by:

executeDatabaseQuery in class DatabaseQuery

Returns:

- the result of executing the query.

Throws:

DatabaseException - - an error has occurred on the database.

isDataModifyQuery

public boolean isDataModifyQuery()

PUBLIC: Return if this is a data modify query.

Overrides:

isDataModifyQuery in class DatabaseQuery

prepare

protected void prepare()

INTERNAL: Prepare the receiver for execution in a session.

Overrides:

prepare in class DatabaseQuery

prepareForExecution

public void prepareForExecution()
                         throws QueryException

INTERNAL: Prepare the receiver for execution in a session. In particular, set the descriptor of the receiver to the Descriptor for the appropriate class for the receiver's object.

Overrides:

prepareForExecution in class DatabaseQuery

Throws:

QueryException