|
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.DCExecutableBinding
oracle.adf.model.binding.DCBindingContainer
oracle.jbo.uicli.binding.JUFormBinding
public class JUFormBinding
Corresponds to a Swing JFrame instance and manages bindings used in a frame. The JUFormBinding class provides:
In the JClient Framework, JUPanelBinding extends this class and provides a home to various iterator bindings and control bindings.
JUPanelBinding
Nested Class Summary |
---|
Nested classes/interfaces inherited from class oracle.adf.model.binding.DCBindingContainer |
---|
DCBindingContainer.CalculatedViewable, DCBindingContainer.EnumRefreshType, DCBindingContainer.ValidationLevel |
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 java.util.Map |
---|
java.util.Map.Entry<K,V> |
Field Summary | |
---|---|
protected java.util.ArrayList |
mNavigationBarList
|
Fields inherited from class oracle.adf.model.binding.DCBindingContainer |
---|
DC_BINDINGCONTAINER_ERROR, DC_IGNORE_ERROR, mControlList, mDataControl, mDataProvider, mIsBeingPersonalized, mIterBindingList, mParamsList |
Fields inherited from class oracle.adf.model.binding.DCExecutableBinding |
---|
mInternalGet_KeyResolved |
Fields inherited from class oracle.jbo.common.JboAbstractMap |
---|
MAP_NULL_VALUE |
Fields inherited from interface oracle.adf.model.RegionBinding |
---|
EXECUTE_MODEL, PREPARE_MODEL, REFRESH_UNKNOWN, RENDER_MODEL, TYPE_EXECUTABLE_REGION |
Fields inherited from interface oracle.adf.model.binding.DCIExecutable |
---|
EXECUTABLE_ACTION, EXECUTABLE_ITERATORBINDING, EXECUTABLE_REGION |
Constructor Summary | |
---|---|
JUFormBinding()
Default constrcutor. |
|
JUFormBinding(java.lang.Object panel)
Constructor used by JUPanelBinding, which passes in a reference to the JPanel object. |
Method Summary | |
---|---|
void |
addIterBinding(JUIteratorBinding iterBinding)
Adds the given iterator binding name with a framework generated name. |
void |
addIterBinding(java.lang.String name,
JUIteratorBinding iterBinding)
Adds this iterator binding with this form with the given name. |
void |
addNavigationBar(JUNavigationBarInterface navBar)
Adds a NavigationBar (or like object) that needs to listen into changes in an iterator, and focus events, etc. |
void |
addStatusBarInterface(JUStatusBarInterface statusBar)
Helper method to add the given object to the JUApplication's StatusBars. |
void |
clearIterBindings()
Clean all iterator bindings registered with this form. |
protected DCIteratorBinding |
createIteratorBinding(java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
int rangeSize)
Forces the current control to stop its editing mode (if used, like in JTable). |
boolean |
displayInShortForm(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Returns true if the attribute is to displayed in the short(summary) form. |
void |
displayStatus(JUIteratorBinding iterBinding,
java.lang.String msgId,
java.lang.Object[] params)
Helper method to display the given message and params via the JUApplication's displayStatus method. |
void |
displayStatus(java.lang.String msg)
Helper method to display the given message string via the JUApplication's displayStatus method. |
VariableValueManager |
ensureVariableManager()
Returns this object's Variable Value Manager. |
JUControlBinding |
findControlBinding(java.lang.String name)
|
JUCtrlValueBinding |
findCtrlValueBinding(java.lang.String name)
*** For internal framework use only *** |
JUIteratorBinding |
findIterBinding(java.lang.String name)
Returns the iterator binding object of the given name. |
protected void |
focusGained(DCIteratorBinding iterBinding,
DCControlBinding binding,
int attrIndex)
Invoked by the framework to notify various status bars of which control has gained the focus. |
JUApplication |
getApplication()
Returns the JUApplciation object to which this form binding belongs. |
JUControlBinding |
getControlBinding(java.lang.Object control)
|
int |
getControlType(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Returns the preferred control type for this attribute. |
int |
getDisplayHeight(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Returns the display width for this attribute. |
java.lang.String |
getDisplayHint(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Retrieves the display hint that dictates whether this attribute should be visible or not. |
int |
getDisplayWidth(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Returns the display width for this attribute. |
protected java.util.ArrayList |
getExceptionsListInternal()
*** For internal framework use only *** |
java.lang.String |
getHint(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale,
java.lang.String sHintName)
Returns the hint value based on the hint name. |
java.lang.String |
getHint(java.lang.String voName,
java.lang.String voAttrName,
java.lang.String objectAttrName,
LocaleContext locale,
java.lang.String sHintName)
Returns the hint value based on the hint name. |
java.lang.String |
getLabel(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Retrieves the label to be used in any attribute prompts |
java.lang.String |
getLabel(java.lang.String voName,
java.lang.String voAttrName,
java.lang.String objectAttrName,
LocaleContext locale)
Retrieves the label to be used in any attribute prompts |
ViewObject[] |
getOrderedVOUsageList()
Returns an ordered list of ViewObject usages in this panel so that a JboException parameters can be transformed from Entity-layer names and exception parameters to ViewObject names and parameters. |
java.lang.Object |
getPanel()
Returns the associated JPanel object. |
JUIteratorBinding |
getRangeIterBinding(java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
int rangeSize)
Return an Iterator Binding of the given "voIterBindingName", if one already exists by that name, after setting up the iterator binding's range Size to the greater of existing range size and the given range size. |
JUIteratorBinding |
getRowIterBinding(java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName)
Return an Iterator Binding of the given "voIterBindingName" if one already exists by that name. |
java.lang.String |
getTooltip(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Retrives the tooltip text to be used for this attribute. |
java.lang.String |
getTooltip(java.lang.String voName,
java.lang.String voAttrName,
java.lang.String objectAttrName,
LocaleContext locale)
Retrives the tooltip text to be used for this attribute. |
boolean |
hasFormatInformation(java.lang.String voName,
java.lang.String attrName,
LocaleContext locale)
Returns true if any format hints have been defined for this attribute. |
protected void |
initializeApplicationModule()
*** For internal framework use only *** Used to setup reference to JUApplication and oracle.jbo.Application objects. |
void |
initializePanel(java.util.ArrayList controls)
*** For internal framework use only *** |
protected void |
initializeViewComponent(java.util.ArrayList controls)
*** For internal framework use only *** |
protected DCDataControl |
internalGetDataControl()
*** For internal framework use only *** |
protected void |
navigated(DCIteratorBinding iter,
NavigationEvent event)
Invoked when a JUIteratorBinding receives a navigated Event from BC4J RowSetIterator |
protected void |
notifyIteratorChanged(DCIteratorBinding iterBnd,
boolean refresh)
Notify each listener of the iteratorChanged event when an iterator changes its data due to execute, re-execute, or change in display mode (find mode or data mode). |
protected void |
prepareRegionForHierNodeIterator(DCIteratorBinding iter)
|
protected void |
rangeRefreshed(DCIteratorBinding iter,
RangeRefreshEvent event)
Invoked when a JUIteratorBinding receives a rangeRefreshed Event from BC4J RowSetIterator |
protected void |
rangeScrolled(DCIteratorBinding iter,
ScrollEvent event)
Invoked when a JUIteratorBinding receives a rangeScrolled Event from BC4J RowSetIterator |
boolean |
removeIterBinding(java.lang.String name)
If an iterator binding exists with the given name, remove it from the internal members. |
void |
removeNavigationBar(JUNavigationBarInterface navBar)
Removes a JUNavigationBarInterface listener object from the list. |
void |
removeStatusBarInterface(JUStatusBarInterface statusBar)
Helper method to remove the given object to the JUApplication's StatusBars. |
protected void |
removeViewScopeErrorState()
|
protected void |
resetExceptionState()
Advanced for internal framework use only |
protected void |
rowDeleted(DCIteratorBinding iter,
DeleteEvent event)
Invoked when a JUIteratorBinding receives a rowDeleted Event from BC4J RowSetIterator |
protected void |
rowInserted(DCIteratorBinding iter,
InsertEvent event)
Invoked when a JUIteratorBinding receives a rowInserted Event from BC4J RowSetIterator |
protected void |
rowUpdated(DCIteratorBinding iter,
UpdateEvent event)
Invoked when a JUIteratorBinding receives a rowUpdated Event from BC4J RowSetIterator |
void |
setApplication(JUApplication app)
Sets the JUApplication instance in this form binding and adds it to the JUApplication. |
void |
setPanel(java.lang.Object panel)
Associates this form binding object with a JPanel object. |
protected void |
setPanelInternal(java.lang.Object panel)
Sets internal member variable with the given panel instance. |
Methods inherited from class oracle.adf.model.binding.DCExecutableBinding |
---|
addDependentExecutable, get, getBindingContainer, getDependents, getName, getPermissionTargetName, getRefreshExpression, getRefreshOption, isRefreshable, isRefreshed, removeDependentExecutable, resetDependentsRefresh, setBindingContainer, setExecutableDef, setName, setRefreshed, setRefreshExpression, setRefreshOption |
Methods inherited from class oracle.jbo.common.JboAbstractMap |
---|
entrySet, equals, internalPut, 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.binding.BindingContainer |
---|
getName |
Methods inherited from interface java.util.Map |
---|
clear, containsKey, containsValue, entrySet, equals, get, isEmpty, keySet, put, putAll, remove, size, values |
Methods inherited from interface oracle.jbo.VariableManagerOwner |
---|
getName |
Field Detail |
---|
protected java.util.ArrayList mNavigationBarList
Constructor Detail |
---|
public JUFormBinding()
public JUFormBinding(java.lang.Object panel)
Method Detail |
---|
public JUApplication getApplication()
public void setApplication(JUApplication app)
InvalidOperException
public final java.lang.Object getPanel()
protected void setPanelInternal(java.lang.Object panel)
public final JUIteratorBinding findIterBinding(java.lang.String name)
public final void addIterBinding(JUIteratorBinding iterBinding)
public final void addIterBinding(java.lang.String name, JUIteratorBinding iterBinding)
InvalidObjNameException
- if an invalid name is passed in.
NameClashException
- if given a duplicate name.protected void removeViewScopeErrorState()
removeViewScopeErrorState
in class DCBindingContainer
protected void resetExceptionState()
resetExceptionState
in class DCBindingContainer
protected java.util.ArrayList getExceptionsListInternal()
getExceptionsListInternal
in class DCBindingContainer
protected void prepareRegionForHierNodeIterator(DCIteratorBinding iter)
prepareRegionForHierNodeIterator
in class DCBindingContainer
public final boolean removeIterBinding(java.lang.String name)
public final void clearIterBindings()
public final JUControlBinding findControlBinding(java.lang.String name)
public JUCtrlValueBinding findCtrlValueBinding(java.lang.String name)
public final JUControlBinding getControlBinding(java.lang.Object control)
public JUIteratorBinding getRowIterBinding(java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName)
Various control bindings that display just one row's attribute invoke this method to find or create the iterator binding for which they display an attribute data.
public JUIteratorBinding getRangeIterBinding(java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, int rangeSize)
If not, create an IteratorBinding object that references a default iterator of the ViewObject instance named voInstanceName (and optionally the iterator named voIterName). Return this created iterator binding after adding it to internal lists.
Various control bindings that are capable of displaying more than one row of data invoke this method to create their iterator binding with a preferred range size.
public void addStatusBarInterface(JUStatusBarInterface statusBar)
public void removeStatusBarInterface(JUStatusBarInterface statusBar)
public final void addNavigationBar(JUNavigationBarInterface navBar)
public final void removeNavigationBar(JUNavigationBarInterface navBar)
public void displayStatus(JUIteratorBinding iterBinding, java.lang.String msgId, java.lang.Object[] params)
public void displayStatus(java.lang.String msg)
displayStatus
in class DCBindingContainer
public java.lang.String getLabel(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public java.lang.String getTooltip(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public java.lang.String getDisplayHint(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public int getControlType(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public int getDisplayWidth(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public int getDisplayHeight(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public java.lang.String getHint(java.lang.String voName, java.lang.String attrName, LocaleContext locale, java.lang.String sHintName)
public boolean hasFormatInformation(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public boolean displayInShortForm(java.lang.String voName, java.lang.String attrName, LocaleContext locale)
public java.lang.String getLabel(java.lang.String voName, java.lang.String voAttrName, java.lang.String objectAttrName, LocaleContext locale)
public java.lang.String getTooltip(java.lang.String voName, java.lang.String voAttrName, java.lang.String objectAttrName, LocaleContext locale)
public java.lang.String getHint(java.lang.String voName, java.lang.String voAttrName, java.lang.String objectAttrName, LocaleContext locale, java.lang.String sHintName)
public ViewObject[] getOrderedVOUsageList()
protected void initializeViewComponent(java.util.ArrayList controls)
DCBindingContainer
initializeViewComponent
in class DCBindingContainer
public void initializePanel(java.util.ArrayList controls)
protected void initializeApplicationModule()
initializeApplicationModule
in class DCBindingContainer
public void setPanel(java.lang.Object panel)
protected void focusGained(DCIteratorBinding iterBinding, DCControlBinding binding, int attrIndex)
focusGained
in class DCBindingContainer
protected void notifyIteratorChanged(DCIteratorBinding iterBnd, boolean refresh)
notifyIteratorChanged
in class DCBindingContainer
protected void rangeRefreshed(DCIteratorBinding iter, RangeRefreshEvent event)
rangeRefreshed
in class DCBindingContainer
iter
- that received the rangeRefreshed event.event
- a description of the new ranges.protected void rangeScrolled(DCIteratorBinding iter, ScrollEvent event)
rangeScrolled
in class DCBindingContainer
iter
- that received the rangeScrolled event.event
- a description of the new range.protected void rowInserted(DCIteratorBinding iter, InsertEvent event)
rowInserted
in class DCBindingContainer
iter
- that received the rowInserted event.event
- a description of the new Row object.protected void rowDeleted(DCIteratorBinding iter, DeleteEvent event)
rowDeleted
in class DCBindingContainer
iter
- that received the rowDeleted event.event
- a description of the deleted Row object.protected void rowUpdated(DCIteratorBinding iter, UpdateEvent event)
rowUpdated
in class DCBindingContainer
iter
- that received the rowUpdated event.event
- a description of the modified Row object.protected void navigated(DCIteratorBinding iter, NavigationEvent event)
navigated
in class DCBindingContainer
iter
- that received the navigated event.event
- a description of the new and previous current rows.protected DCIteratorBinding createIteratorBinding(java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, int rangeSize)
createIteratorBinding
in class DCBindingContainer
public VariableValueManager ensureVariableManager()
VariableManagerOwnerBase
ensureVariableManager
in interface VariableManagerOwnerBase
ensureVariableManager
in class DCBindingContainer
protected DCDataControl internalGetDataControl()
internalGetDataControl
in class DCBindingContainer
|
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 |