|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1.7.0) E10653-08 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.AbstractMap
oracle.jbo.common.JboAbstractMap
oracle.adf.model.binding.DCDataControl
oracle.adf.model.bc4j.DCJboDataControl
oracle.jbo.uicli.binding.JUApplication
public class JUApplication
The application class that manages connection to a BC4J Application Module. The JUApplication class provides:
ApplicationModule
,
Transaction
,
JUTransactionStateListener
,
JUErrorHandler
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 | |
---|---|
protected JUErrorHandler |
mJUErrorHandler
|
Fields inherited from class oracle.adf.model.bc4j.DCJboDataControl |
---|
EXC_MODE_DEFAULT, EXC_MODE_DEFERRED, EXC_MODE_IMMEDIATE, INTERNALDC, PROP_VCIVAL_SUBST_ATTRDEF, RELEASE_LEVEL_MANAGED, RELEASE_LEVEL_RELOADABLE, RELEASE_LEVEL_RESERVED, RELEASE_LEVEL_UNMANAGED, VAL_MODE_ALWAYS, VAL_MODE_NEVER, VAL_MODE_REMOTE, VAL_MODE_UNINIT |
Fields inherited from class oracle.jbo.common.JboAbstractMap |
---|
MAP_NULL_VALUE |
Fields inherited from interface oracle.adf.model.DataControl |
---|
DATACHANGE_EVENT_POLLINGMODE |
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.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 oracle.jbo.TransactionStateListener |
---|
doneCommit, doneRollback |
Methods inherited from interface java.util.Map |
---|
clear, containsKey, containsValue, entrySet, equals, hashCode, isEmpty, keySet, put, putAll, remove, size, values |
Field Detail |
---|
protected JUErrorHandler mJUErrorHandler
Constructor Detail |
---|
public JUApplication()
public JUApplication(java.util.Hashtable context, java.lang.String rootAMDefName, java.lang.Object userData)
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.public JUApplication(ApplicationModule am)
public JUApplication(JUApplication parent, ApplicationModule am, java.lang.Object userData)
public JUApplication(SessionCookie sessionCookie)
Method Detail |
---|
public final JUApplication getRootApplication()
public final void removeFormBinding(JUFormBinding formBnd)
public final void addFormBinding(JUFormBinding formBnd)
NameClashException
- If there is another object of the same name already registered, this
method will throw this exception.public final void addFormBinding(java.lang.String name, JUFormBinding formBnd, JUFormDef formDef)
InvalidObjNameException
- If the given name does not follow the BC4J component or Java Identifier
naming rules.
NameClashException
- If there is another object of the same name already registered, this
method will throw this exception.JboNameUtil.isNameValid(String)
public final void addFormBinding(java.lang.String name, JUFormBinding formBnd)
InvalidObjNameException
- If the given name does not follow the BC4J component or Java Identifier
naming rules.
NameClashException
- If there is another object of the same name already registered, this
method will throw this exception.JboNameUtil.isNameValid(String)
public final JUFormBinding findFormBinding(java.lang.String name)
public final JUFormBinding createFormBinding(java.lang.String name, java.lang.String formDefName, boolean initialize)
Create a JUFormBinding instance using the given name and form definition.
public final void reportException(JUFormBinding formBnd, java.lang.Exception ex)
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.
DCErrorHandler
,
JboException
public final JUErrorHandler getErrorHandler()
JUErrorHandlerDialog
public final void setErrorHandler(java.lang.Object errHandlerObj)
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.
setErrorHandler
in class DCDataControl
errHandlerObj
- An implementation of DCErrorHandler interface
that may optionally implement JboExceptionHandler interface too.
If errHandler implements the JboExceptionHandler, this method sets
it as the ExceptionHandler on the root ApplicationModule that this
client Application is connected with. Else, method sets a default
ExceptionHandler which will collect all Exceptions
and throw a new JboException with these Exceptions set as in the new
JboException's details list, for the errHandler to display
as one JboException with a bag of Exceptions.JUErrorHandler
,
JUErrorHandlerDialog
,
JboExceptionHandler
,
ApplicationModule
|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1.7.0) E10653-08 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |