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

oracle.jbo.uicli.binding
Class JUFormBinding

java.lang.Object
  extended byjava.util.AbstractMap
      extended byoracle.jbo.common.JboAbstractMap
          extended byoracle.adf.model.binding.DCBindingContainer
              extended byoracle.jbo.uicli.binding.JUFormBinding
All Implemented Interfaces:
JboExceptionHandler, java.util.Map
Direct Known Subclasses:
JUPanelBinding

public class JUFormBinding
extends DCBindingContainer

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.

See Also:
JUPanelBinding

Nested Class Summary
 
Nested classes inherited from class java.util.Map
java.util.Map.Entry
 
Field Summary
 
Fields inherited from class oracle.adf.model.binding.DCBindingContainer
mControlList, mDataControl, mDataProvider, mIterBindingList
 
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 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.
 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.
 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  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 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 removeStatusBarInterface(JUStatusBarInterface statusBar)
          Helper method to remove the given object to the JUApplication's StatusBars.
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.DCBindingContainer
addControlBinding, addControlBinding, addIteratorBinding, addIteratorBinding, addStatusBarInterface, addValidationListener, beforeCurrencyChange, beforeSaveTransaction, beforeSetAttribute, cacheException, callBeforeRowNavigated, callBeforeSaveTransaction, callBeforeSetAttribute, clearIteratorBindings, displayStatus, execute, executeIfNeeded, findCtrlBinding, findIteratorBinding, findNamedObject, finishedProcessingPiggyback, get, getApplicationModule, getBindingContext, getCtrlBinding, getCtrlBinding, getCtrlBindingList, getDataControl, getDef, getEditingMode, getExceptionsList, getIteratorBinding, getIteratorBinding, getIterBindingList, getIterBindings, getLocaleContext, getName, getOrderedVOUsageList, getStateToken, getStateTokenId, getValidationListeners, getViewComponent, handleException, handleWarning, hashCode, initializeFromDef, internalGet, isEditingStopped, isErrorHandlerActive, isExecuteOnRollback, isFindMode, isTokenValidationEnabled, processException, processInputValues, refreshControl, release, release, removeControlBinding, removeControlBinding, removeIteratorBinding, removeStatusBarInterface, removeValidationListener, reportException, resetInputState, setApplicationModule, setBindingContext, setDataControl, setEnableTokenValidation, setErrorHandlerActive, setExecuteOnRollback, setFindMode, setFindMode, setName, setViewComponentInternal, toString, validateInputValues, validateToken
 
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
 

Constructor Detail

JUFormBinding

public JUFormBinding()
Default constrcutor.


JUFormBinding

public JUFormBinding(java.lang.Object panel)
Constructor used by JUPanelBinding, which passes in a reference to the JPanel object.

Method Detail

getApplication

public JUApplication getApplication()
Returns the JUApplciation object to which this form binding belongs.


setApplication

public void setApplication(JUApplication app)
Sets the JUApplication instance in this form binding and adds it to the JUApplication. If this form binding is already registered with a JUApplication, then it throws an InvalidOperException.

Throws:
InvalidOperException

getPanel

public final java.lang.Object getPanel()
Returns the associated JPanel object.


setPanelInternal

protected void setPanelInternal(java.lang.Object panel)
Sets internal member variable with the given panel instance.


findIterBinding

public final JUIteratorBinding findIterBinding(java.lang.String name)
Returns the iterator binding object of the given name.


addIterBinding

public final void addIterBinding(JUIteratorBinding iterBinding)
Adds the given iterator binding name with a framework generated name.


addIterBinding

public final void addIterBinding(java.lang.String name,
                                 JUIteratorBinding iterBinding)
Adds this iterator binding with this form with the given name.

Throws:
InvalidObjNameException - if an invalid name is passed in.
NameClashException - if given a duplicate name.

removeIterBinding

public final boolean removeIterBinding(java.lang.String name)
If an iterator binding exists with the given name, remove it from the internal members.


clearIterBindings

public final void clearIterBindings()
Clean all iterator bindings registered with this form.


findControlBinding

public final JUControlBinding findControlBinding(java.lang.String name)

findCtrlValueBinding

public JUCtrlValueBinding findCtrlValueBinding(java.lang.String name)
*** For internal framework use only ***


getControlBinding

public final JUControlBinding getControlBinding(java.lang.Object control)

getRowIterBinding

public 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. 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 display just one row's attribute invoke this method to find or create the iterator binding for which they display an attribute data.


getRangeIterBinding

public 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. If range size is -1, that indicates all rows in the range and hence takes precedence in the above comparison.

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.


addStatusBarInterface

public void addStatusBarInterface(JUStatusBarInterface statusBar)
Helper method to add the given object to the JUApplication's StatusBars.


removeStatusBarInterface

public void removeStatusBarInterface(JUStatusBarInterface statusBar)
Helper method to remove the given object to the JUApplication's StatusBars.


displayStatus

public 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. This method becomes a no-op if this form is not registered with a JUApplication


displayStatus

public void displayStatus(java.lang.String msg)
Helper method to display the given message string via the JUApplication's displayStatus method. This method becomes a no-op if this form is not registered with a JUApplication

Overrides:
displayStatus in class DCBindingContainer

getLabel

public java.lang.String getLabel(java.lang.String voName,
                                 java.lang.String attrName,
                                 LocaleContext locale)
Retrieves the label to be used in any attribute prompts


getTooltip

public java.lang.String getTooltip(java.lang.String voName,
                                   java.lang.String attrName,
                                   LocaleContext locale)
Retrives the tooltip text to be used for this attribute.


getDisplayHint

public 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. The two possible values are:


getControlType

public int getControlType(java.lang.String voName,
                          java.lang.String attrName,
                          LocaleContext locale)
Returns the preferred control type for this attribute.


getDisplayWidth

public int getDisplayWidth(java.lang.String voName,
                           java.lang.String attrName,
                           LocaleContext locale)
Returns the display width for this attribute.


getDisplayHeight

public int getDisplayHeight(java.lang.String voName,
                            java.lang.String attrName,
                            LocaleContext locale)
Returns the display width for this attribute.


getHint

public 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.


hasFormatInformation

public boolean hasFormatInformation(java.lang.String voName,
                                    java.lang.String attrName,
                                    LocaleContext locale)
Returns true if any format hints have been defined for this attribute. This function should be used to bracket any calls to the formatting API.


displayInShortForm

public 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.


getLabel

public 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


getTooltip

public 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.


getHint

public 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.


getOrderedVOUsageList

public 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.


initializeViewComponent

protected void initializeViewComponent(java.util.ArrayList controls)
Description copied from class: DCBindingContainer
*** For internal framework use only ***

Overrides:
initializeViewComponent in class DCBindingContainer

initializePanel

public void initializePanel(java.util.ArrayList controls)
*** For internal framework use only ***


initializeApplicationModule

protected void initializeApplicationModule()
*** For internal framework use only *** Used to setup reference to JUApplication and oracle.jbo.Application objects.

Overrides:
initializeApplicationModule in class DCBindingContainer

setPanel

public void setPanel(java.lang.Object panel)
Associates this form binding object with a JPanel object.


focusGained

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.

Overrides:
focusGained in class DCBindingContainer

notifyIteratorChanged

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).

Overrides:
notifyIteratorChanged in class DCBindingContainer

rangeRefreshed

protected void rangeRefreshed(DCIteratorBinding iter,
                              RangeRefreshEvent event)
Invoked when a JUIteratorBinding receives a rangeRefreshed Event from BC4J RowSetIterator

Overrides:
rangeRefreshed in class DCBindingContainer
Parameters:
event - a description of the new ranges.

rangeScrolled

protected void rangeScrolled(DCIteratorBinding iter,
                             ScrollEvent event)
Invoked when a JUIteratorBinding receives a rangeScrolled Event from BC4J RowSetIterator

Overrides:
rangeScrolled in class DCBindingContainer
Parameters:
event - a description of the new range.

rowInserted

protected void rowInserted(DCIteratorBinding iter,
                           InsertEvent event)
Invoked when a JUIteratorBinding receives a rowInserted Event from BC4J RowSetIterator

Overrides:
rowInserted in class DCBindingContainer
Parameters:
event - a description of the new Row object.

rowDeleted

protected void rowDeleted(DCIteratorBinding iter,
                          DeleteEvent event)
Invoked when a JUIteratorBinding receives a rowDeleted Event from BC4J RowSetIterator

Overrides:
rowDeleted in class DCBindingContainer
Parameters:
event - a description of the deleted Row object.

rowUpdated

protected void rowUpdated(DCIteratorBinding iter,
                          UpdateEvent event)
Invoked when a JUIteratorBinding receives a rowUpdated Event from BC4J RowSetIterator

Overrides:
rowUpdated in class DCBindingContainer
Parameters:
event - a description of the modified Row object.

navigated

protected void navigated(DCIteratorBinding iter,
                         NavigationEvent event)
Invoked when a JUIteratorBinding receives a navigated Event from BC4J RowSetIterator

Overrides:
navigated in class DCBindingContainer
Parameters:
event - a description of the new and previous current rows.

createIteratorBinding

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). Calls beforeSaveTransaction() method to notify all validation listeners.

Overrides:
createIteratorBinding in class DCBindingContainer

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

 

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