Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.4.0)

E10653-05

oracle.adf.model.generic.toplink
Class TopLinkDataControl

java.lang.Object
  extended by java.util.AbstractMap
      extended by oracle.jbo.common.JboAbstractMap
          extended by oracle.adf.model.binding.DCDataControl
              extended by oracle.adf.model.generic.DCGenericDataControl
                  extended by oracle.adf.model.generic.toplink.TopLinkDataControl
All Implemented Interfaces:
java.util.Map, DataControl, ManagedDataControl

Deprecated. - TopLink Data Controls created with 10.1.3 ADF, will no longer use these classes.

public class TopLinkDataControl
extends DCGenericDataControl

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.

See Also:
DataControlFactoryImpl, DCGenericDataControl, TransactionBroker

Nested Class Summary
 
Nested classes/interfaces inherited from class java.util.AbstractMap
java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>
 
Nested classes/interfaces inherited from interface oracle.adf.model.DataControl
DataControl.DataChangeEventPolicy
 
Nested classes/interfaces inherited from interface java.util.Map
java.util.Map.Entry<K,V>
 
Field Summary
static java.lang.String DOT_STR
          Deprecated.  
static java.lang.String QUERY_SPEL_IDENTIFIER
          Deprecated. Identifies a method invocation as a TL query
static java.lang.String READ_ALL_QUERY_SPEL_IDENTIFIER
          Deprecated. 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, GET_ApplicationModule, GET_dataProvider, GET_DataProvider, GET_DCFrame, GET_MethodResults, GET_Name, JCLIENT, mBindingContainerList, mDataControlFrameName, mDataProvider, mErrorHandler, mErrorHandlerActive, mErrorHandlerThrow, METHOD_RESULT, mIsReleased, mIsReleasing, mIsRoot, mLocaleCtx, mLock, mName, mParent, mRootApplication, mStatusBarList, mTxnListeners, mUserData, OPER_CTRL_BINDING_VALIDATION, OPER_DATA_ROW_CREATE, OPER_DATA_ROW_CREATE_ONLY, 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, VCCRITERIA, VCCRITERIAITEM, VCCRITERIAITEMVALUE, VCCRITERIAOPERATOR
 
Fields inherited from class oracle.jbo.common.JboAbstractMap
MAP_NULL_VALUE
 
Fields inherited from interface oracle.adf.model.DataControl
DATACHANGE_EVENT_POLLINGMODE
 
Constructor Summary
TopLinkDataControl(java.lang.String name, java.util.Map params, java.lang.String beanClassName, boolean root, TransactionBroker transactionBroker)
          Deprecated. Creates a new instance of the TopLinkDataControl.
 
Method Summary
protected  void commitPerformed()
          Deprecated. Notifies this data control that a commit has been performed and that the transactional state needs to be reset.
 void commitTransaction()
          Deprecated. Commits the transaction for this data control.
 java.lang.Object createRowData(DCRowContext ctx)
          Deprecated. 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.
 oracle.toplink.sessions.Session getAssociatedSession()
          Deprecated. ADVANCED: Returns the TopLink Session associated with this data control's transaction.
 oracle.toplink.sessions.UnitOfWork getAssociatedUnitOfWork()
          Deprecated. ADVANCED: Returns the TopLink UnitOfWork associated with this data control's transaction.
protected  TransactionBroker getTransactionBroker()
          Deprecated. 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)
          Deprecated.  
 java.lang.Object invokeMethod(DCInvokeMethod methodInfo, OperationBinding action, java.util.Map params)
          Deprecated. 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)
          Deprecated. Describes what operations are supported by the TopLinkDataControl.
 void release(int flags)
          Deprecated. Overridden from DCDataControl to handle cleanup of TopLink related resources in the event of a data release.
 boolean removeRowData(DCRowContext ctx)
          Deprecated. Return true if the row at the given index is removed from the the RSI associated with the given iterator-binding.
 boolean resetState()
          Deprecated. 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()
          Deprecated. Notifies this data control that a "resetState: has been performed and that the transactional and associated RSIs' state need to be reset.
 void resetTransaction()
          Deprecated. INTERNAL: Resets the transactional resources associated with this data control and all data controls that share the same transactional space.
protected  void resetTransactionalState()
          Deprecated. Resets the transactional state of this Data Control.
protected  void rollbackPerformed()
          Deprecated. Notifies this data control that a rollback has been performed and that the transactional state needs to be reset.
 void rollbackTransaction()
          Deprecated. Rollsback the transaction for this data control.
protected  void transactionalResourcesReset()
          Deprecated. 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.adf.model.generic.DCGenericDataControl
addDataChangeListener, applySortCriteria, applyViewCriteria, beginRequest, clearIteratorBinding, closeRowSetIterators, createAccessorRowSetIteratorForMasterRow, createCriteriaRowMatch, createRowSetIteratorImpl, createViewCriteria, endRequest, executeIteratorBinding, executeIteratorBindingIfNeeded, executeMethodIterators, fetchProperty, fetchProviderProperty, fetchRowSetIterator, findOrCreateAccessorRowSetIterator, findOrCreateAccessorRowSetIterator, findOrCreateMethodRowSetIterator, findOrCreateViewObjectForCriteria, findOrCreateViewObjectForCriteriaItem, findRootRowSetIterator, findRowsByKeyValues, findStructureDef, getAccessorDefs, getAccessorValue, getAttributeDefs, getAttributeDefs, getCriteriaAdapter, getDataProvider, getDefinition, getEstimatedRowCount, getEventDefinitions, getIteratorStructureDefName, getKeyAttributeDefs, getLastEventId, getListBindingDef, getListBindingName, getListBindingRSI, getPreferredListRSI, getRowSetIterator, getSortCriteria, getViewCriteria, initDCProperties, initializeBindingContainer, initializeRSIs, invokeOperation, isAttributeSortable, isTransactionDirty, registerDataProvider, release, removeDataChangeListener, restoreRSIs, setCurrentRowWithKey, setCurrentRowWithKey, setCurrentRowWithKeyValue, startEvents, validate
 
Methods inherited from class oracle.adf.model.binding.DCDataControl
_internal_dbg_debug_data, addBindingContainer, addBindingContainer, addBindingContainer, addBindingContainerRef, addBindingWithExc, addDataChangeListener, addOrCreateBindingContainer, addStatusBarInterface, addTransactionStateListener, afterReportException, beforeReportException, cacheMethodResult, callCommitTransaction, cleanup, connect, createAccessorRowSetIterator, createAccessorRowSetIterator, createAccessorRowSetIterator, createBindingContainer, createBindingContainerInstance, createRowSetIteratorImpl, createSavepoint, createSnapshot, discardIfDefinitionChanged, displayStatus, displayStatus, doneCommit, doneRollback, executeIteratorBindingWithParams, findBindingContainer, findOrCreateRowSetIteratorImpl, findVariable, focusGained, get, getAdaptedDC, getAM, getAppDefName, getApplicationModule, getBindingContext, getCurrentErrorHandler, getDataControlFrameName, getDef, getDeferredEstimatedRowCount, getErrorHandlerActive, getLocaleContext, getMethodResults, getMethodResultUseCount, getName, getParent, getRootDataControl, getSecurityContext, getSessionContext, getSessionContextManager, getSubstitutedDefNames, getSyncLock, getUnresolvedBindingContainer, getUserData, hasBindingsWithExc, hasDefinitionChanged, hasKeyAttributes, hasOperationParamsChanged, hasPermission, hasPermission, hasPermission, initialize, initializeContainerFromDef, initializeFromMetadata, internalCacheMethodResults, internalGet, internalGetCurrentRow, internalGetDataControlFrame, internalGetIterBindingViewObject, internalPut, internalSetTransactionStateChanged, invalidateMethodResult, invokeMethod, isBoundRowIteratorEvent, isClientTier, isDataChangeManager, isJClientApp, isReleasing, isRoot, isTransactionModified, markAccessorIterListenerForFKMerge, modifyTransactionStateForAttributeSet, processChangeNotifications, rebuildIteratorIfNeeded, releaseAll, releaseBindings, releaseData, releaseFromDCFrame, releaseMethodResults, removeBindingContainer, removeBindingWithExc, removeDataChangeListener, removeRowDataFromCollection, removeSnapshot, removeStatusBarInterface, removeTransactionStateListener, reportException, resetAttributeExceptionInRow, resolveAttributeDefs, restoreSavepoint, restoreSnapshot, setAppDefName, setAttributeInRow, setAttributesInRow, setBindingContext, setClientApp, setDataControlFrameName, setDataProvider, setDef, setErrorHandler, setErrorHandlerActive, setLocaleContext, setName, setParent, setPartialUpdate, setPinned, setSessionContext, setTransactionModified, stopEvents, sync, syncIfNeeded, syncNeeded, toString, transactionStateChanged
 
Methods inherited from class oracle.jbo.common.JboAbstractMap
entrySet, equals, hashCode, put, setThrowIfPropertyNotFoundOnGet
 
Methods inherited from class java.util.AbstractMap
clear, clone, containsKey, containsValue, isEmpty, keySet, 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, hashCode, isEmpty, keySet, put, putAll, remove, size, values
 

Field Detail

DOT_STR

public static final java.lang.String DOT_STR
Deprecated. 
See Also:
Constant Field Values

QUERY_SPEL_IDENTIFIER

public static final java.lang.String QUERY_SPEL_IDENTIFIER
Deprecated. 
Identifies a method invocation as a TL query

See Also:
Constant Field Values

READ_ALL_QUERY_SPEL_IDENTIFIER

public static final java.lang.String READ_ALL_QUERY_SPEL_IDENTIFIER
Deprecated. 
Identifies a method invocation as a TL "read all" query

See Also:
Constant Field Values
Constructor Detail

TopLinkDataControl

public TopLinkDataControl(java.lang.String name,
                          java.util.Map params,
                          java.lang.String beanClassName,
                          boolean root,
                          TransactionBroker transactionBroker)
Deprecated. 
Creates a new instance of the TopLinkDataControl.

Parameters:
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

initialize

protected void initialize(java.util.Map params,
                          java.lang.String beanClassName,
                          TransactionBroker transactionBroker)
Deprecated. 

isOperationSupported

public boolean isOperationSupported(DCIteratorBinding iterBinding,
                                    byte oper)
Deprecated. 
Describes what operations are supported by the TopLinkDataControl.

Overrides:
isOperationSupported in class DCGenericDataControl
See Also:
DCDataControl.isOperationSupported(oracle.adf.model.binding.DCIteratorBinding, byte)

invokeMethod

public java.lang.Object invokeMethod(DCInvokeMethod methodInfo,
                                     OperationBinding action,
                                     java.util.Map params)
Deprecated. 
Overridden from DCDataControl, this method serves as an entry point for executing native java methods as well as TopLink queries.

Overrides:
invokeMethod in class DCGenericDataControl
See Also:
DCDataControl.isOperationSupported(DCIteratorBinding, byte)

removeRowData

public boolean removeRowData(DCRowContext ctx)
Deprecated. 
Return true if the row at the given index is removed from the the RSI associated with the given iterator-binding. In addition, this method goes into the providing underlying collection removes the object contained in the Row, and marks the object to be deleted in the given transaction.

Overrides:
removeRowData in class DCGenericDataControl
Parameters:
ctx - the row context to be removed.
Returns:
true if the operation was successful. false otherwise.

createRowData

public java.lang.Object createRowData(DCRowContext ctx)
Deprecated. 
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.

Overrides:
createRowData in class DCGenericDataControl
Parameters:
ctx - - description of the Row to create
See Also:
DCDataControl.createRowData(oracle.adf.model.generic.DCRowContext)

release

public void release(int flags)
Deprecated. 
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.

commitTransaction

public void commitTransaction()
Deprecated. 
Commits the transaction for this data control. The side effect of this method call is that all data controls sharing the same transaction will be commited and have their transactional state reset as well.

Overrides:
commitTransaction in class DCGenericDataControl
See Also:
DCDataControl.commitTransaction()

rollbackTransaction

public void rollbackTransaction()
Deprecated. 
Rollsback the transaction for this data control. The side effect of this method call is that all data controls sharing the same transaction will be commited and have their transactional state reset as well.

Overrides:
rollbackTransaction in class DCGenericDataControl
See Also:
DCDataControl.rollbackTransaction()()

resetState

public boolean resetState()
Deprecated. 
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). Calls to this method will also recurse to all TopLinkDataControls that share the same TX space in the application.

Specified by:
resetState in interface ManagedDataControl
Overrides:
resetState in class DCGenericDataControl
Returns:
whether this call has been deferred to the end of the web request.
See Also:
DCDataControl.resetState()

commitPerformed

protected void commitPerformed()
Deprecated. 
Notifies this data control that a commit has been performed and that the transactional state needs to be reset.


rollbackPerformed

protected void rollbackPerformed()
Deprecated. 
Notifies this data control that a rollback has been performed and that the transactional state needs to be reset.


resetStatePerformed

protected void resetStatePerformed()
Deprecated. 
Notifies this data control that a "resetState: has been performed and that the transactional and associated RSIs' state need to be reset.


transactionalResourcesReset

protected void transactionalResourcesReset()
Deprecated. 
Notifies this data control that the transactional resources have been reset and that a full re-execution of all associated RSIs must be performed.


resetTransactionalState

protected void resetTransactionalState()
Deprecated. 
Resets the transactional state of this Data Control.


resetTransaction

public void resetTransaction()
Deprecated. 
INTERNAL: Resets the transactional resources associated with this data control and all data controls that share the same transactional space. This method should be called with care since it will revert all data controls and subsequent RSIs in the same application and transactional space to their original states and remove all changes made. Additionally, the RSIs will be restored to their previous state.


getTransactionBroker

protected TransactionBroker getTransactionBroker()
Deprecated. 
Returns the TransactionBroker associated with this data control instance that manages all transactional related activities for this data control.


getAssociatedUnitOfWork

public oracle.toplink.sessions.UnitOfWork getAssociatedUnitOfWork()
Deprecated. 
ADVANCED: Returns the TopLink UnitOfWork associated with this data control's transaction. Use care when accessing this Session as any transactional state management activities will make the transactional state of this data control inconsistent.


getAssociatedSession

public oracle.toplink.sessions.Session getAssociatedSession()
Deprecated. 
ADVANCED: Returns the TopLink Session associated with this data control's transaction. Use care when accessing this Session as any transactional state management activities will make the transactional state of this data control inconsistent.


Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.4.0)

E10653-05

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