Business Components 9.0.5

oracle.adf.model.generic.toplink
Class ToplinkDataControl

java.lang.Object
  extended byjava.util.AbstractMap
      extended byoracle.jbo.common.JboAbstractMap
          extended byoracle.adf.model.binding.DCDataControl
              extended byoracle.adf.model.generic.DCGenericDataControl
                  extended byoracle.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.

Business Components 9.0.5

 

Copyright © 1997, 2004, Oracle. All rights reserved.