Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

oracle.jbo.uicli.binding
Class JUApplication

java.lang.Object
  extended byjava.util.AbstractMap
      extended byoracle.jbo.common.JboAbstractMap
          extended byoracle.adf.model.binding.DCDataControl
              extended byoracle.adf.model.bc4j.DCJboDataControl
                  extended byoracle.jbo.uicli.binding.JUApplication
All Implemented Interfaces:
DataControl, DCDataControlManagement, java.util.EventListener, java.util.Map, TransactionStateListener

public class JUApplication
extends DCJboDataControl

The application class that manages connection to a BC4J Application Module. The JUApplication class provides:

Version:
PUBLIC
See Also:
ApplicationModule, Transaction, JUTransactionStateListener, JUErrorHandler

Nested Class Summary
 
Nested classes inherited from class java.util.Map
java.util.Map.Entry
 
Field Summary
protected  JUErrorHandler mJUErrorHandler
           
 
Fields inherited from class oracle.adf.model.bc4j.DCJboDataControl
EXC_MODE_DEFAULT, EXC_MODE_DEFERRED, EXC_MODE_IMMEDIATE
 
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
JUApplication()
           
JUApplication(ApplicationModule am)
          Constructor used internally by the framework to associate an application module with a JClient application object.
JUApplication(java.util.Hashtable context, java.lang.String rootAMDefName, java.lang.Object userData)
          Constructs a root JUApplication object that connects to a BC4J Application Module of the given name.
JUApplication(JUApplication parent, ApplicationModule am, java.lang.Object userData)
          Constructor to be used to create a nested JUApplication inside another JUApplication object.
JUApplication(SessionCookie sessionCookie)
           
 
Method Summary
 void addFormBinding(JUFormBinding formBnd)
          Register the given form binding object with this application.
 void addFormBinding(java.lang.String name, JUFormBinding formBnd)
          Register the given form binding object with this application with the given name.
 void addFormBinding(java.lang.String name, JUFormBinding formBnd, JUFormDef formDef)
          Register the given form binding object with this application with the given name.
 JUFormBinding createFormBinding(java.lang.String name, java.lang.String formDefName, boolean initialize)
          *** For internal framework use only ***
 JUFormBinding findFormBinding(java.lang.String name)
          Return the JUFormBinding instance registered with this JUAppication with the given name.
 JUErrorHandler getErrorHandler()
          Returns the DCErrorHandler registered with the root DCDataControl.
 JUApplication getRootApplication()
          Returns the root DCDataControl object.
 void removeFormBinding(JUFormBinding formBnd)
          Remove the JUFormBinding object of the given name (if any).
 void reportException(JUFormBinding formBnd, java.lang.Exception ex)
          This method is used by all framework binding objects to report exceptions.
 void setErrorHandler(java.lang.Object errHandlerObj)
          Registers a DCErrorHandler with the root DCDataControl.
 
Methods inherited from class oracle.adf.model.bc4j.DCJboDataControl
applySortCriteria, beginRequest, commitTransaction, connect, createAccessorRowSetIterator, createAccessorRowSetIterator, createRootApplicationModule, createRowData, createRowSetIteratorImpl, endRequest, executeIteratorBinding, executeIteratorBindingIfNeeded, findCustomViewObject, getAccessorValue, getApplicationModule, getAttributeDefs, getContext, getDBConnectionProps, getDBConnectionURL, getEstimatedRowCount, getLocaleContext, getPackageName, getReleaseLevel, getRootAMDefName, getRowSetIterator, getSortCriteria, getViewCriteria, initialize, internalGet, isClientTier, isOperationSupported, isTransactionDirty, prepareSession, release, removeRowData, resetAttributeExceptionInRow, resetState, rollbackTransaction, setAttributeInRow, setBundledExceptionMode, setClientApp, setConnectionInfo, setCurrentRowWithKey, setCurrentRowWithKeyValue, setDataProvider, setLocaleContext, setPackageName, setReleaseLevel, setSessionCookie, sync, syncIfNeeded, syncNeeded, validate
 
Methods inherited from class oracle.adf.model.binding.DCDataControl
addBindingContainer, addBindingContainer, addBindingContainer, addBindingContainerRef, addBindingWithExc, addOrCreateBindingContainer, addStatusBarInterface, addTransactionStateListener, callCommitTransaction, cleanup, createAccessorRowSetIterator, createBindingContainer, createBindingContainerInstance, createRowSetIteratorImpl, displayStatus, displayStatus, doneCommit, doneRollback, findBindingContainer, findOrCreateAccessorRowSetIterator, findOrCreateAccessorRowSetIterator, findOrCreateMethodRowSetIterator, findOrCreateRowSetIteratorImpl, focusGained, get, getBindingContext, getCurrentErrorHandler, getDataProvider, getDef, getErrorHandlerActive, getMethodResults, getMethodResultUseCount, getName, getParent, getRootDataControl, getSessionContext, getSessionContextManager, getUserData, hasBindingsWithExc, hashCode, initializeBindingContainer, initializeContainerFromDef, internalGetCurrentRow, invokeMethod, isJClientApp, isRoot, isTransactionModified, rebuildIteratorIfNeeded, registerDataProvider, release, removeBindingContainer, removeBindingWithExc, removeRowDataFromCollection, removeStatusBarInterface, removeTransactionStateListener, reportException, resolveAttributeDefs, setBindingContext, setDef, setErrorHandlerActive, setName, setSessionContext, setTransactionModified, toString, transactionStateChanged
 
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 oracle.jbo.TransactionStateListener
doneCommit, doneRollback
 
Methods inherited from interface java.util.Map
clear, containsKey, containsValue, entrySet, equals, isEmpty, keySet, put, putAll, remove, size, values
 

Field Detail

mJUErrorHandler

protected JUErrorHandler mJUErrorHandler
Constructor Detail

JUApplication

public JUApplication()

JUApplication

public JUApplication(java.util.Hashtable context,
                     java.lang.String rootAMDefName,
                     java.lang.Object userData)
Constructs a root JUApplication object that connects to a BC4J Application Module of the given name.

Parameters:
context - Context to pass on to the BC4J Application Module on creation.
rootAMDefName - Name that identifies the root BC4J Application Module.
userData - Data to store with the JUApplication object.

JUApplication

public JUApplication(ApplicationModule am)
Constructor used internally by the framework to associate an application module with a JClient application object.


JUApplication

public JUApplication(JUApplication parent,
                     ApplicationModule am,
                     java.lang.Object userData)
Constructor to be used to create a nested JUApplication inside another JUApplication object.


JUApplication

public JUApplication(SessionCookie sessionCookie)
Method Detail

getRootApplication

public final JUApplication getRootApplication()
Returns the root DCDataControl object.


removeFormBinding

public final void removeFormBinding(JUFormBinding formBnd)
Remove the JUFormBinding object of the given name (if any).


addFormBinding

public final void addFormBinding(JUFormBinding formBnd)
Register the given form binding object with this application. If this form binding object has no name or null name, framework generates a unique name for the object (in the context of this application module).


addFormBinding

public final void addFormBinding(java.lang.String name,
                                 JUFormBinding formBnd,
                                 JUFormDef formDef)
Register the given form binding object with this application with the given name.


addFormBinding

public final void addFormBinding(java.lang.String name,
                                 JUFormBinding formBnd)
Register the given form binding object with this application with the given name.


findFormBinding

public final JUFormBinding findFormBinding(java.lang.String name)
Return the JUFormBinding instance registered with this JUAppication with the given name. If the name does not match, return null.


createFormBinding

public final JUFormBinding createFormBinding(java.lang.String name,
                                             java.lang.String formDefName,
                                             boolean initialize)
*** For internal framework use only ***

Create a JUFormBinding instance using the given name and form definition.


reportException

public final void reportException(JUFormBinding formBnd,
                                  java.lang.Exception ex)
This method is used by all framework binding objects to report exceptions. If this DCDataControl is not the root, it calls the equivalent method on the root.

If the error handler is set to active state, then this method calls the registered error handler's reportException method. Othewise, it simply throws the given exception as a JboException.

See Also:
DCErrorHandler, JboException

getErrorHandler

public final JUErrorHandler getErrorHandler()
Returns the DCErrorHandler registered with the root DCDataControl. By default a JClient application has an instance of DCErrorHandlerDialog registered as the default DCErrorHandler.

See Also:
oracle.jbo.uicli.jui.DCErrorHandlerDialog

setErrorHandler

public final void setErrorHandler(java.lang.Object errHandlerObj)
Registers a DCErrorHandler with the root DCDataControl. By default a JClient application has an instance of DCErrorHandlerDialog registered as the default DCErrorHandler. Applications should use this method to register custom error handling object so that all errors raised in the framework goes through the Application's error handling object. Custom error handlers need to implement the DCErrorHandler interface.

Custom error handlers may also implement oracle.jbo.JboExceptionHandler to handle batched Exceptions raised during client-side processing of Exceptions thrown in the Business Components tier. Alteratively an application can register it's own JboExceptionHandler with the Business Components ApplicationModule for this Application. after the DCErrorHandler is set with DCDataControl in this method.

Note that errors are sent to the registered error handler only when the error handler state is marked active (which is true by default) using the setErrorHandlerActive method.

Overrides:
setErrorHandler in class DCDataControl
See Also:
oracle.jbo.uicli.binding.DCErrorHandler, oracle.jbo.uicli.jui.DCErrorHandlerDialog, oracle.jbo.JboExceptionHanlder, ApplicationModule

Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

 

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