oracle.toplink.essentials.internal.queryframework

Class CallQueryMechanism

java.lang.Object

oracle.toplink.essentials.internal.queryframework.DatabaseQueryMechanism

oracle.toplink.essentials.internal.queryframework.DatasourceCallQueryMechanism

oracle.toplink.essentials.internal.queryframework.CallQueryMechanism

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

StatementQueryMechanism

public class CallQueryMechanism
extends DatasourceCallQueryMechanism

Purpose: Mechanism used for custom SQL and stored procedure queries.

Responsibilities: Executes the appropriate call.

Since:

TOPLink/Java 2.0

Author:

James Sutherland

See Also:

Serialized Form

Field Summary

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

call, calls

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

query

Constructor Summary

Constructors

Constructor and Description
CallQueryMechanism(DatabaseQuery query) Initialize the state of the query
CallQueryMechanism(DatabaseQuery query, DatabaseCall call) Initialize the state of the query

Method Summary

Modifier and Type	Method and Description
DatabaseCall	getDatabaseCall() Return the call.
void	prepareCall() INTERNAL: This is different from 'prepareForExecution' in that this is called on the original query, and the other is called on the copy of the query.
void	prepareDeleteAll() Pre-build configure the SQL call.
void	prepareDeleteObject() Pre-build configure the SQL call.
void	prepareDoesExist(DatabaseField field) Pre-build configure the SQL call.
void	prepareExecuteSelect() Pre-build configure the SQL call.
void	prepareSelectAllRows() Pre-build configure the SQL call.
void	prepareSelectOneRow() Pre-build configure the SQL call.
void	prepareUpdateObject() Pre-build configure the SQL call.
void	setCallHasCustomSQLArguments() INTERNAL: Configure the call to be a dynamic custom SQL call, so that it ignore the # token.
protected void	updateForeignKeyFieldShallow(WriteObjectQuery writeQuery) Update the foreign key fields when resolving a bi-directonal reference in a UOW.

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

addCall, cursorSelectAllRows, deleteAll, deleteAllUsingTempTables, deleteObject, executeCall, executeCall, executeNoSelect, executeNoSelectCall, executeSelect, executeSelectCall, getCall, getCalls, hasMultipleCalls, insertObject, isCallQueryMechanism, prepare, prepareCursorSelectAllRows, prepareExecuteNoSelect, prepareInsertObject, prepareReportQueryItems, prepareReportQuerySelectAllRows, prepareReportQuerySubSelect, prepareUpdateAll, selectAllReportQueryRows, selectAllRows, selectOneRow, selectRowForDoesExist, setCall, setCalls, updateAll, updateAllUsingTempTables, updateObject

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

addObjectDeletedDuringCommit, addWriteLockFieldForInsert, buildObjectsFromRows, buildSelectionCriteria, checkCacheForObject, clone, clone, deleteObjectForWrite, executeWrite, executeWriteWithChangeSet, getDescriptor, getModifyRow, getQuery, getReadObjectQuery, getSelectionCriteria, getSession, getTranslationRow, getWriteObjectQuery, insertObject, insertObjectForWrite, insertObjectForWriteWithChangeSet, isEJBQLCallQueryMechanism, isExpressionQueryMechanism, isQueryByExampleMechanism, isStatementQueryMechanism, performUserDefinedDelete, performUserDefinedInsert, performUserDefinedUpdate, performUserDefinedWrite, prepareForExecution, registerObjectInIdentityMap, setQuery, shallowDeleteObjectForWrite, shallowInsertObjectForWrite, updateChangeSet, updateChangeSet, updateChangeSet, updateChangeSet, updateForeignKeyFieldAfterInsert, updateForeignKeyFieldBeforeDelete, updateObjectAndRowWithReturnRow, updateObjectAndRowWithSequenceNumber, updateObjectForWrite, updateObjectForWriteWithChangeSet

Methods inherited from class java.lang.Object

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

Constructor Detail

CallQueryMechanism

public CallQueryMechanism(DatabaseQuery query)

Initialize the state of the query

Parameters:

query - - owner of mechanism

CallQueryMechanism

public CallQueryMechanism(DatabaseQuery query,
                          DatabaseCall call)

Initialize the state of the query

Parameters:

query - - owner of mechanism

call - - sql call

Method Detail

getDatabaseCall

public DatabaseCall getDatabaseCall()

Return the call.

prepareCall

public void prepareCall()
                 throws QueryException

INTERNAL: This is different from 'prepareForExecution' in that this is called on the original query, and the other is called on the copy of the query. This query is copied for concurrency so this prepare can only setup things that will apply to any future execution of this query.

Overrides:

prepareCall in class DatasourceCallQueryMechanism

Throws:

QueryException

prepareDeleteAll

public void prepareDeleteAll()

Pre-build configure the SQL call.

Overrides:

prepareDeleteAll in class DatasourceCallQueryMechanism

prepareDeleteObject

public void prepareDeleteObject()

Pre-build configure the SQL call.

Overrides:

prepareDeleteObject in class DatasourceCallQueryMechanism

prepareDoesExist

public void prepareDoesExist(DatabaseField field)

Pre-build configure the SQL call.

Overrides:

prepareDoesExist in class DatasourceCallQueryMechanism

prepareExecuteSelect

public void prepareExecuteSelect()

Pre-build configure the SQL call.

Overrides:

prepareExecuteSelect in class DatasourceCallQueryMechanism

prepareSelectAllRows

public void prepareSelectAllRows()

Pre-build configure the SQL call.

Overrides:

prepareSelectAllRows in class DatasourceCallQueryMechanism

prepareSelectOneRow

public void prepareSelectOneRow()

Pre-build configure the SQL call.

Overrides:

prepareSelectOneRow in class DatasourceCallQueryMechanism

prepareUpdateObject

public void prepareUpdateObject()

Pre-build configure the SQL call.

Overrides:

prepareUpdateObject in class DatasourceCallQueryMechanism

setCallHasCustomSQLArguments

public void setCallHasCustomSQLArguments()

INTERNAL: Configure the call to be a dynamic custom SQL call, so that it ignore the # token.

updateForeignKeyFieldShallow

protected void updateForeignKeyFieldShallow(WriteObjectQuery writeQuery)

Update the foreign key fields when resolving a bi-directonal reference in a UOW. This must always be dynamic as it is called within an insert or delete query and is really part of the write operation and does not fire update events or worry about locking.

Overrides:

updateForeignKeyFieldShallow in class DatasourceCallQueryMechanism