|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-02 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
java.util.AbstractMap
oracle.jbo.common.JboAbstractMap
oracle.adf.model.binding.DCControlBinding
oracle.jbo.uicli.binding.JUControlBinding
oracle.jbo.uicli.binding.JUCtrlValueBinding
oracle.jbo.uicli.binding.JUCtrlAttrsBinding
oracle.jbo.uicli.binding.JUCtrlListBinding
A JUCtrlAttrsBinding class responsible displaying a list of values from a static list or a list calculated at runtime using another BC4J ViewObject/RowIterator. This binding operates in two ways:
The operating mode is to be setup in the constructor of this binding.
This binding works in two updateable modes:
This binding can also be used to iterator through a RowIterator object and display single or multiple attributes from the rows.
Nested Class Summary |
Nested classes inherited from class java.util.Map |
java.util.Map.Entry |
Field Summary | |
static java.lang.String |
DH_CONTROL_TYPE |
static java.lang.String |
DH_DISPLAY_HEIGHT |
static java.lang.String |
DH_DISPLAY_HINT |
static java.lang.String |
DH_DISPLAY_WIDTH |
static java.lang.String |
DH_FORMAT |
static java.lang.String |
DH_LABEL Constants to access elements in the map returned in getDisplayHints() |
static java.lang.String |
DH_TOOLTIP |
static int |
LIST_OPER_NAVIGATE Indicates that list binding will be used to navigate Rows in a RowIterator. |
static int |
LIST_OPER_SET_ATTRIBUTE Indicates this list binding will be used to update attributes in a target ViewObject. |
static java.lang.String |
LISTITEM_DisplayValues |
static java.lang.String |
LISTITEM_Index |
static java.lang.String |
LISTITEM_Prompt |
static java.lang.String |
LISTITEM_Selected Constants to access elements in the map returned in getDisplayData() |
static java.lang.String |
LISTITEM_SelectedIndex |
protected AttributeDef |
mFirstDisplayAttr |
protected java.lang.String[] |
mListAttrNames Ordered list of attribute names that this control binding should use to update the target ViewObject's attributes. |
protected java.lang.String[] |
mListDisplayAttrNames Ordered list of attributes that this control binding should use to display the Rows from the LOV ViewObject. |
protected DCIteratorBinding |
mListIterBinding Iterator Binding object that this binding uses to get the LOV data. |
protected boolean |
mSingleAttrList |
protected boolean |
mStaticList Controls whether the list of values should be fetched once or should this list update itself when the ViewObject for the LOV changes. |
protected java.lang.Object[] |
mValueList List of values displayed in the bound control. |
Fields inherited from class oracle.jbo.uicli.binding.JUCtrlValueBinding |
ATTR_ATTRIBUTE, ATTR_ATTRIBUTE_DEF, ATTR_ATTRIBUTE_DEFS, ATTR_ATTRIBUTE_VALUE, ATTR_ATTRIBUTE_VALUES, ATTR_ATTRIBUTES, ATTR_DISPLAY_HINT, ATTR_INPUT_VALUE, ATTR_LABEL, ATTR_LABELS, ATTR_LABELSET, ATTR_MANDATORY, ATTR_TOOLTIP, ATTR_UPDATEABLE, mHasInputVal, mInputVal, SEP_LIST_DISPLAY |
Fields inherited from class oracle.adf.model.binding.DCControlBinding |
ATTR_CURRENTROW, ATTR_DEF, ATTR_ERROR, ATTR_ERRORS, ATTR_FULLNAME, ATTR_ITER, ATTR_NAME, mInternalGet_KeyResolved, ROW_KEY_STR |
Constructor Summary | |
protected |
JUCtrlListBinding() *** For internal framework use only *** |
protected |
JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, DCIteratorBinding listIterBinding, java.lang.String[] listAttrNames, java.lang.String[] listDisplayAttrNames) Uses the listIterBinding object to get the iterator and attribute names from listDisplayAttrNames to display attributes from the BC4J Rows in the iterator. |
JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, int listOperMode) **For Testing purposes only*** Uses the same Iterator Binding to update as well as display values. |
|
JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, java.lang.Object[] valueList) Uses the given static list of value objects to display data in the control. |
Method Summary | |
void |
addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons) *** For internal framework use only *** |
void |
convertValueList() *** For internal framework use only *** |
int |
findListIndex(java.lang.Object val) |
java.lang.Object |
findMatchingListValue(java.lang.Object val) |
java.lang.Object |
findValue(java.lang.Object val) |
protected AttributeDef[] |
getDisplayAttributeDefs() |
java.util.List |
getDisplayData() Returns a List of Map elements. |
java.util.List |
getDisplayHints() Returns a List of Map elements (name-value pairs) for UI hints for all display attributes in this list binding. |
java.util.Iterator |
getDisplayListIterator() Returns an ArrayList of values that should be displayed in this list. |
java.lang.Object |
getInputValue() Primarily for spel support. |
protected java.lang.String[] |
getListDisplayAttrNames() |
DCIteratorBinding |
getListIterBinding() Returns the iterator binding that is used to fill in the values for this list. |
int |
getListOperMode() Returns whether this list binding is used for Row Navigation or updating attributes on a target ViewObject (default). |
int |
getSelectedIndex() |
protected int |
getSelectedIndexValue() |
java.lang.Object |
getSelectedValue() |
java.lang.Object |
getValueAt(int attrIndex) Gets the value from the control for the attribute at the given index. |
java.lang.Object |
getValueFromList(int listIndex) |
java.lang.Object[] |
getValueList() *** For internal framework use only *** |
protected java.lang.Object |
internalGet(java.lang.String key) Subclasses should override this to handle a specific key. |
protected boolean |
isControlQueriable() For ADF/nonJClient apps return true so that list bindings are created as queriable if the bound iteratorBinding allows findmode. |
boolean |
isSingleAttrList() *** For internal framework use only *** |
protected boolean |
isViewInitialized() |
void |
iteratorClosed(RowSetManagementEvent event) Resets the internal state of this binding object and marks it as unusable. |
void |
iteratorReset(RowSetManagementEvent event) Notifies rangeRefreshed to all bindings so that they can update their display. |
protected boolean |
matchTargetWithLov(Row targetRow, Row lovRow) *** For internal framework use only *** |
void |
navigated(NavigationEvent event) *** For internal framework use only *** |
boolean |
processNewInputValue(java.lang.Object value) Compares the value (assumed to be a numeric String or an Integer) with currently selected index in this listbinding and if different, then returns true. |
java.lang.Object |
put(java.lang.Object obj, java.lang.Object value) |
void |
rangeRefreshed(RangeRefreshEvent event) *** For internal framework use only *** |
void |
rangeScrolled(ScrollEvent event) *** For internal framework use only *** |
protected void |
release(int flags) |
void |
rowDeleted(DeleteEvent event) *** For internal framework use only *** |
void |
rowInserted(InsertEvent event) *** For internal framework use only *** |
void |
rowUpdated(UpdateEvent event) *** For internal framework use only *** |
void |
setAttributeFromValueList(int listIndex) |
void |
setDataValueAt(java.lang.Object value, int attrIndex) |
void |
setInputValue(java.lang.Object value) Primarily for spel support. |
void |
setListOperMode(int listOperMode) *** For internal framework use only *** |
protected int |
setListValueAsSelected(java.lang.Object val) |
void |
setSelectedIndex(int indx) |
protected void |
setSelectedIndexValue(int indx) |
protected void |
setSingleAttrList(boolean flag) *** For internal framework use only *** |
protected void |
setStaticList(boolean staticList) |
protected void |
setTargetAttrsFromLovRow(Row targetRow, Row lovRow) *** For internal framework use only *** |
protected void |
setupListItems(boolean clean, boolean keepSelectedIndex) If this list is displaying a single attribute and updates a single attribute, then this method fetches the attribute value from all the rows in the given LOV list iterator and sets that as the list of values to display in the bound control. |
void |
setValueAt(java.lang.Object value, int attrIndex) Updates the control/control-binding with the latest value of the attribute at the given index with the given value. |
void |
setValueList(java.lang.Object[] valueList) *** For internal framework use only *** |
java.lang.String |
toString() |
protected void |
updateTargetFromSelectedValue(java.lang.Object val) |
void |
updateValuesFromRow(Row row) Updates the control-binding and hence the control with attribute values from the attributes of this Row. |
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlAttrsBinding |
createAttributeBinding, refreshControl, setControlEnabled, updateNavigated, updateRangeScrolled, updateValuesFromRows |
Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding |
getFormBinding, getIteratorBinding, reportException, setFormBinding |
Methods inherited from class oracle.adf.model.binding.DCControlBinding |
addToDCExceptions, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getBindingContainer, getControl, getControlModel, getCurrentRow, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, hashCode, internalSetName, needsEstimatedRowCount, removeFromDCExceptions, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setName |
Methods inherited from class oracle.jbo.common.JboAbstractMap |
entrySet, equals |
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.StructureDef |
getDefFullName, getDefName, getFullName, getName |
Field Detail |
public static int LIST_OPER_SET_ATTRIBUTE
public static int LIST_OPER_NAVIGATE
protected boolean mSingleAttrList
protected java.lang.Object[] mValueList
protected java.lang.String[] mListAttrNames
protected java.lang.String[] mListDisplayAttrNames
protected DCIteratorBinding mListIterBinding
protected boolean mStaticList
protected AttributeDef mFirstDisplayAttr
public static final java.lang.String LISTITEM_Selected
public static final java.lang.String LISTITEM_Index
public static final java.lang.String LISTITEM_Prompt
public static final java.lang.String LISTITEM_DisplayValues
public static final java.lang.String LISTITEM_SelectedIndex
public static final java.lang.String DH_LABEL
public static final java.lang.String DH_TOOLTIP
public static final java.lang.String DH_DISPLAY_HINT
public static final java.lang.String DH_DISPLAY_HEIGHT
public static final java.lang.String DH_DISPLAY_WIDTH
public static final java.lang.String DH_CONTROL_TYPE
public static final java.lang.String DH_FORMAT
Constructor Detail |
protected JUCtrlListBinding()
public JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, int listOperMode)
public JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, java.lang.Object[] valueList)
protected JUCtrlListBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames, DCIteratorBinding listIterBinding, java.lang.String[] listAttrNames, java.lang.String[] listDisplayAttrNames)
Method Detail |
protected void setupListItems(boolean clean, boolean keepSelectedIndex)
If this list is displaying multiple attributes and/or is used in navigation mode, then the valueList is set with the list of all rows from the LOV Iterator binding. In this case, this binding also listens to events from the RowSetIterator for row currency changes, new rows, etc.
public DCIteratorBinding getListIterBinding()
public int getListOperMode()
protected java.lang.String[] getListDisplayAttrNames()
public void setListOperMode(int listOperMode)
Sets the operating mode for this list binding.
protected void setSingleAttrList(boolean flag)
public boolean isSingleAttrList()
public void setValueList(java.lang.Object[] valueList)
public void convertValueList()
public int getSelectedIndex()
public void setSelectedIndex(int indx)
protected void setSelectedIndexValue(int indx)
protected int getSelectedIndexValue()
public java.lang.Object getValueAt(int attrIndex)
JUCtrlAttrsBinding
getValueAt
in class JUCtrlAttrsBinding
public java.lang.Object[] getValueList()
Returns the static value list as set into this listbinding incase of enumeration lists. In case of Row bound lists, returns an array of LOV rows set into this listbinding.
public java.util.Iterator getDisplayListIterator()
public java.lang.Object getSelectedValue()
protected boolean matchTargetWithLov(Row targetRow, Row lovRow)
protected int setListValueAsSelected(java.lang.Object val)
public java.lang.Object findMatchingListValue(java.lang.Object val)
public int findListIndex(java.lang.Object val)
public java.lang.String toString()
toString
in class JUCtrlAttrsBinding
public java.lang.Object findValue(java.lang.Object val)
public java.lang.Object getValueFromList(int listIndex)
protected boolean isViewInitialized()
protected boolean isControlQueriable()
isControlQueriable
in class JUCtrlAttrsBinding
public void updateValuesFromRow(Row row)
JUCtrlAttrsBinding
This method also enables/disables the Swing control based on the updateability of the first (Default) attribute to which this control is bound.
updateValuesFromRow
in class JUCtrlAttrsBinding
protected void setTargetAttrsFromLovRow(Row targetRow, Row lovRow)
public void setAttributeFromValueList(int listIndex)
protected void updateTargetFromSelectedValue(java.lang.Object val)
public void rangeRefreshed(RangeRefreshEvent event)
rangeRefreshed
in interface RowSetListener
event
- a description of the new ranges.public void rowInserted(InsertEvent event)
rowInserted
in interface RowSetListener
event
- a description of the new Row object.public void rowDeleted(DeleteEvent event)
rowDeleted
in interface RowSetListener
event
- a description of the deleted Row object.public void rowUpdated(UpdateEvent event)
rowUpdated
in interface RowSetListener
event
- a description of the modified Row object.public void navigated(NavigationEvent event)
navigated
in interface RowSetListener
event
- a description of the new and previous current rows.public void rangeScrolled(ScrollEvent event)
rangeScrolled
in interface RowSetListener
event
- a description of the new range.public void iteratorReset(RowSetManagementEvent event)
iteratorReset
in interface RowSetManagementListener
event
- a description of the event.public void iteratorClosed(RowSetManagementEvent event)
iteratorClosed
in interface RowSetManagementListener
event
- a description of the event.protected void release(int flags)
release
in class JUCtrlValueBinding
public void setDataValueAt(java.lang.Object value, int attrIndex)
setDataValueAt
in class JUCtrlAttrsBinding
public void setValueAt(java.lang.Object value, int attrIndex)
JUCtrlAttrsBinding
setValueAt
in class JUCtrlAttrsBinding
public void addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons)
JUControlBinding
addControlToPanel
in class JUCtrlAttrsBinding
public java.lang.Object put(java.lang.Object obj, java.lang.Object value)
put
in interface java.util.Map
put
in class JUCtrlValueBinding
public java.lang.Object getInputValue()
Returns the last input value for the first attribute on this binding if this value raised an exception. Otherwise returns the value from the model object calling getAttribute(0);
getInputValue
in class JUCtrlValueBinding
public void setInputValue(java.lang.Object value)
Sets the value given and caches any error/exception in member variables for further access. Also rethrows the exception for outer methods to catch it.
setInputValue
in class JUCtrlValueBinding
public java.util.List getDisplayData()
selected
- Boolean.TRUE if current entry should be selectedindex
- Index value of the current entry()prompt
- Concatenated string of all display attribute values for the current entry()displayValues
- Iterator of display attribute values.selectedIndex
- Index of the selected entry that this listBinding is bound to.
Returns null if the list of values for this binding is null. This condition should not occur if the list-binding definition is complete.
public java.util.List getDisplayHints()
label
- Label to display for the current attributetooltip
- Tooltip to display for the current attributedisplayHint
- DisplayHint for the current attributedisplayHeight
- Height in lines for the current attributedisplayWidth
- Width in characters for the current attributecontrolType
- ControlType hint for the current attributeformat
- Format to be used for the current attributeprotected java.lang.Object internalGet(java.lang.String key)
Properties returned vis getter on this control bindings are:
displayHints
- returns getDisplayHints()displayData
- returns getDisplayData()path
- returns getPath()internalGet
in class JUCtrlValueBinding
protected AttributeDef[] getDisplayAttributeDefs()
public boolean processNewInputValue(java.lang.Object value)
processNewInputValue
in class JUCtrlValueBinding
value
- new selectedIndex value.protected void setStaticList(boolean staticList)
|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-02 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2005, Oracle. All rights reserved.