oracle.adf.model.generic.toplink
Class ToplinkDataControl

java.lang.Object
  java.util.AbstractMap
      oracle.jbo.common.JboAbstractMap
          oracle.adf.model.binding.DCDataControl
              oracle.adf.model.generic.DCGenericDataControl
                  oracle.adf.model.generic.toplink.ToplinkDataControl

All Implemented Interfaces:

DataControl, java.util.Map

public class ToplinkDataControl

extends DCGenericDataControl

Nested Class Summary

Nested classes inherited from class java.util.Map

java.util.Map.Entry

Field Summary

static java.lang.String	QUERY_SPEL_IDENTIFIER
static java.lang.String	READ_ALL_QUERY_SPELL_IDENTIFIER

Fields inherited from class oracle.adf.model.generic.DCGenericDataControl

DC_ROOT_ACC_NAME, mDef, mRSIs, mStructureDefs

Fields inherited from class oracle.adf.model.binding.DCDataControl

ABSTRACT, JCLIENT, mBindingContainerList, mDataProvider, mErrorHandler, mErrorHandlerActive, mErrorHandlerThrow, mIsRoot, mLocaleCtx, mName, mParent, mRootApplication, mStatusBarList, mTxnListeners, mUserData, OPER_CTRL_BINDING_VALIDATION, OPER_DATA_ROW_CREATE, OPER_DATA_ROW_REMOVE, OPER_DATA_ROW_UPDATE, OPER_EXECUTE, OPER_FIND_MODE, OPER_SORT_COLLECTION, PNAME_Type, REL_ALL_REFS, REL_DATA_REFS, REL_VIEW_REFS, REL_WEAK_DATA_REFS

Constructor Summary

ToplinkDataControl(java.lang.String name, java.util.Map params, java.lang.String beanClassName, boolean root)

Method Summary

void	commitTransaction() This method handles committing client changes in the TopLink UnitOfWork, creating a new UnitOfWork for the next transaction, restoring all RowSetIterators, and delegating to DCGenericDataControl to handle any bean level commit responsibilities.
java.lang.Object	createRowData(DCRowContext ctx) Create a new row for the iterator associated with the given iterator-binding at the given index, registers it with the TopLink UnitOfWork, and return the new row's provider object.
ClientSession	getClientSession() Returns the active TopLink ClientSession for this ToplinkDataControl instance.
Server	getServerSession() Returns the active parent TopLink ServerSession from which the ClientSession was created.
UnitOfWork	getUnitOfWork() Returns the current TopLink UnitOfWork associated with this transaction.
java.lang.Object	invokeMethod(DCInvokeMethodDef methodInfo, java.util.ArrayList params) Handles method and TopLink named query execution as TopLink named queries are expressed as method bindings.
boolean	isOperationSupported(DCIteratorBinding iterBinding, byte oper) Returns true for create, remove operations.
java.lang.Object	registerDataProvider(DCRowContext ctx) Registers the client object contained in the Row with UnitOfWork and returns the working copy (clone).
void	release(int flags) Overridden from DCDataControl to handle cleanup of TopLink related resources in the event of a data release.
boolean	removeRowData(DCRowContext ctx) Return true if the row at the given index is removed from the the iterator associated with the given iterator-binding.
void	rollbackTransaction() This method handles rolling back client changes in the TopLink UnitOfWork, creating a new UnitOfWork for the next transaction, restoring all RowSetIterators, and delegating to DCGenericDataControl to handle any bean level rollbact responsibilities.

Methods inherited from class oracle.adf.model.generic.DCGenericDataControl

applySortCriteria, createRowSetIteratorImpl, executeIteratorBinding, executeIteratorBindingIfNeeded, executeMethodIterators, fetchProperty, fetchProviderProperty, fetchRowSetIterator, findOrCreateAccessorRowSetIterator, findOrCreateMethodRowSetIterator, findRootRowSetIterator, findStructureDef, getAccessorDefs, getAccessorValue, getAttributeDefs, getAttributeDefs, getEstimatedRowCount, getRowSetIterator, getSortCriteria, initializeBindingContainer, initializeRSIs, isTransactionDirty, restoreRSIs, setCurrentRowWithKey, setCurrentRowWithKeyValue

Methods inherited from class oracle.adf.model.binding.DCDataControl

addBindingContainer, addBindingContainer, addBindingContainer, addBindingContainerRef, addBindingWithExc, addOrCreateBindingContainer, addStatusBarInterface, addTransactionStateListener, beginRequest, callCommitTransaction, cleanup, connect, createAccessorRowSetIterator, createAccessorRowSetIterator, createBindingContainer, createBindingContainerInstance, createRowSetIteratorImpl, displayStatus, displayStatus, doneCommit, doneRollback, endRequest, findBindingContainer, findOrCreateRowSetIteratorImpl, focusGained, get, getApplicationModule, getBindingContext, getCurrentErrorHandler, getDataProvider, getDef, getErrorHandlerActive, getLocaleContext, getMethodResults, getMethodResultUseCount, getName, getParent, getRootDataControl, getSessionContext, getSessionContextManager, getUserData, hasBindingsWithExc, hashCode, initialize, initializeContainerFromDef, internalGet, isClientTier, isJClientApp, isRoot, isTransactionModified, rebuildIteratorIfNeeded, release, removeBindingContainer, removeBindingWithExc, removeRowDataFromCollection, removeStatusBarInterface, removeTransactionStateListener, reportException, resetState, resolveAttributeDefs, setBindingContext, setClientApp, setDataProvider, setDef, setErrorHandler, setErrorHandlerActive, setLocaleContext, setName, setSessionContext, setTransactionModified, sync, syncNeeded, toString, transactionStateChanged, validate

Methods inherited from class oracle.jbo.common.JboAbstractMap

entrySet, equals

Methods inherited from class java.util.AbstractMap

clear, clone, containsKey, containsValue, isEmpty, keySet, put, putAll, remove, size, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, isEmpty, keySet, put, putAll, remove, size, values

Field Detail

QUERY_SPEL_IDENTIFIER

public static final java.lang.String QUERY_SPEL_IDENTIFIER

See Also:

Constant Field Values

READ_ALL_QUERY_SPELL_IDENTIFIER

public static final java.lang.String READ_ALL_QUERY_SPELL_IDENTIFIER

See Also:

Constant Field Values

Constructor Detail

ToplinkDataControl

public ToplinkDataControl(java.lang.String name,
                          java.util.Map params,
                          java.lang.String beanClassName,
                          boolean root)

Method Detail

registerDataProvider

public java.lang.Object registerDataProvider(DCRowContext ctx)

Registers the client object contained in the Row with UnitOfWork and returns the working copy (clone).

Overrides:

registerDataProvider in class DCDataControl

Parameters:

ctx -

Returns:

commitTransaction

public void commitTransaction()

This method handles committing client changes in the TopLink UnitOfWork, creating a new UnitOfWork for the next transaction, restoring all RowSetIterators, and delegating to DCGenericDataControl to handle any bean level commit responsibilities.

Overrides:

commitTransaction in class DCGenericDataControl

rollbackTransaction

public void rollbackTransaction()

This method handles rolling back client changes in the TopLink UnitOfWork, creating a new UnitOfWork for the next transaction, restoring all RowSetIterators, and delegating to DCGenericDataControl to handle any bean level rollbact responsibilities.

Overrides:

rollbackTransaction in class DCGenericDataControl

isOperationSupported

public boolean isOperationSupported(DCIteratorBinding iterBinding,
                                    byte oper)

Returns true for create, remove operations.

Overrides:

isOperationSupported in class DCGenericDataControl

createRowData

public java.lang.Object createRowData(DCRowContext ctx)

Create a new row for the iterator associated with the given iterator-binding at the given index, registers it with the TopLink UnitOfWork, and return the new row's provider object.

Overrides:

createRowData in class DCGenericDataControl

removeRowData

public boolean removeRowData(DCRowContext ctx)

Return true if the row at the given index is removed from the the iterator associated with the given iterator-binding. In addition, this method goes into the providing underlying collection and removes the object and also marks the object to be deleted in the UnitOfWork.

Overrides:

removeRowData in class DCGenericDataControl

getClientSession

public ClientSession getClientSession()

Returns the active TopLink ClientSession for this ToplinkDataControl instance.

Returns:

- active TopLink ClientSession.

getUnitOfWork

public UnitOfWork getUnitOfWork()

Returns the current TopLink UnitOfWork associated with this transaction.

Returns:

- current UnitOfWork

getServerSession

public Server getServerSession()

Returns the active parent TopLink ServerSession from which the ClientSession was created.

Returns:

the active ServerSession.

invokeMethod

public java.lang.Object invokeMethod(DCInvokeMethodDef methodInfo,
                                     java.util.ArrayList params)

Handles method and TopLink named query execution as TopLink named queries are expressed as method bindings.

Overrides:

invokeMethod in class DCDataControl

Parameters:

methodInfo - - description of the method and param values

params - - optional external parameter values that take precedence over those enumerated in the methodInfo.

Returns:

- the object or Collection of objects returned from this method or query.

release

public void release(int flags)

Overridden from DCDataControl to handle cleanup of TopLink related resources in the event of a data release.

Overrides:

release in class DCDataControl

Parameters:

flags - - Release type flags.