|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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
Purpose: Data control for use of TopLink within ADF.
Description: This data control abstracts the use of TopLink. It allows for a single TransactionBroker to be shared all TL data controls that share a common binding context. This assumes a single transaction and database session (isolated or *client/1server) per user context.
DataControlFactoryImpl
,
DCGenericDataControl
,
TransactionBroker
Nested Class Summary |
Nested classes inherited from class java.util.Map |
java.util.Map.Entry |
Field Summary | |
static java.lang.String |
DOT_STR
|
static java.lang.String |
QUERY_SPEL_IDENTIFIER
Identifies a method invocation as a TL query |
static java.lang.String |
READ_ALL_QUERY_SPEL_IDENTIFIER
Identifies a method invocation as a TL "read all" query |
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,
TransactionBroker transactionBroker)
Creates a new instance of the TopLinkDataControl. |
Method Summary | |
protected void |
commitPerformed()
Notifies this data control that a commit has been performed and that the transactional state needs to be reset. |
void |
commitTransaction()
Commits the transaction for this data control. |
java.lang.Object |
createRowData(DCRowContext ctx)
Creates the object described by DCRowContext , adds it to
the underlying provider Collection, registers it in the given
transaction, and returns the newly created object. |
Session |
getAssociatedSession()
ADVANCED: Returns the TopLink Session associated with this data control's transaction. |
UnitOfWork |
getAssociatedUnitOfWork()
ADVANCED: Returns the TopLink UnitOfWork associated with this data control's transaction. |
protected TransactionBroker |
getTransactionBroker()
Returns the TransactionBroker associated with this data control
instance that manages all transactional related activities for this data control. |
protected void |
initialize(java.util.Map params,
java.lang.String beanClassName,
TransactionBroker transactionBroker)
|
java.lang.Object |
invokeMethod(DCInvokeMethodDef methodInfo,
java.util.ArrayList params)
Overridden from DCDataControl , this method serves as an
entry point for executing native java methods as well as TopLink
queries. |
boolean |
isOperationSupported(DCIteratorBinding iterBinding,
byte oper)
Describes what operations are supported by the TopLinkDataControl. |
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 RSI associated with the given iterator-binding. |
boolean |
resetState()
Resets the state of the TopLinkDataControl to it's initial state upon entering the application: a new UnitOfWork is acquired and all RSIs associated with this DataControl are reset to their initial state (old query results are invalidated as well). |
protected void |
resetStatePerformed()
Notifies this data control that a "resetState: has been performed and that the transactional and associated RSIs' state need to be reset. |
void |
resetTransaction()
INTERNAL: Resets the transactional resources associated with this data control and all data controls that share the same transactional space. |
protected void |
resetTransactionalState()
Resets the transactional state of this Data Control. |
protected void |
rollbackPerformed()
Notifies this data control that a rollback has been performed and that the transactional state needs to be reset. |
void |
rollbackTransaction()
Rollsback the transaction for this data control. |
protected void |
transactionalResourcesReset()
Notifies this data control that the transactional resources have been reset and that a full re-execution of all associated RSIs must be performed. |
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 |
public static final java.lang.String DOT_STR
public static final java.lang.String QUERY_SPEL_IDENTIFIER
public static final java.lang.String READ_ALL_QUERY_SPEL_IDENTIFIER
Constructor Detail |
public TopLinkDataControl(java.lang.String name, java.util.Map params, java.lang.String beanClassName, boolean root, TransactionBroker transactionBroker)
name
- - data control name.params
- - application parameters.beanClassName
- - name of the object this data control represents.root
- - indicates whether this data control is the root in the structure.transactionBroker
- - transactional management facility.Method Detail |
protected void initialize(java.util.Map params, java.lang.String beanClassName, TransactionBroker transactionBroker)
public boolean isOperationSupported(DCIteratorBinding iterBinding, byte oper)
isOperationSupported
in class DCGenericDataControl
DCDataControl.isOperationSupported(oracle.adf.model.binding.DCIteratorBinding,
byte)
public java.lang.Object invokeMethod(DCInvokeMethodDef methodInfo, java.util.ArrayList params)
DCDataControl
, this method serves as an
entry point for executing native java methods as well as TopLink
queries.
invokeMethod
in class DCDataControl
oracle.adf.model.binding.DCDataControl#isOperationSupported(DCInvokeMethodDef,
byte)
public boolean removeRowData(DCRowContext ctx)
removeRowData
in class DCGenericDataControl
public java.lang.Object createRowData(DCRowContext ctx)
DCRowContext
, adds it to
the underlying provider Collection, registers it in the given
transaction, and returns the newly created object.
createRowData
in class DCGenericDataControl
ctx
- -
description of the Row to createDCDataControl.createRowData(oracle.adf.model.generic.DCRowContext)
public void release(int flags)
release
in interface DCDataControlManagement
release
in class DCDataControl
flags
- -
Release type flags.public void commitTransaction()
commitTransaction
in class DCGenericDataControl
DCDataControl.commitTransaction()
public void rollbackTransaction()
rollbackTransaction
in class DCGenericDataControl
DCDataControl.rollbackTransaction()()
public boolean resetState()
resetState
in interface DCDataControlManagement
resetState
in class DCDataControl
DCDataControl.resetState()
protected void commitPerformed()
protected void rollbackPerformed()
protected void resetStatePerformed()
protected void transactionalResourcesReset()
protected void resetTransactionalState()
public void resetTransaction()
protected TransactionBroker getTransactionBroker()
TransactionBroker
associated with this data control
instance that manages all transactional related activities for this data control.
public UnitOfWork getAssociatedUnitOfWork()
public Session getAssociatedSession()
|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2004, Oracle. All rights reserved.