JUCtrlValueBinding (Oracle Fusion Middleware Java API Reference for Oracle ADF Model)

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

All Implemented Interfaces:

java.util.Map, StructureDef, JUCtrlInputValueHandler, JUCtrlValueHandler

Direct Known Subclasses:

JUCtrlAttrsBinding, JUCtrlHierNodeBinding, JUCtrlRangeBinding
```
public abstract class JUCtrlValueBinding
extends JUControlBinding
implements StructureDef, JUCtrlValueHandler
```
A JUControlBinding class responsible for maintaining which attribute(s) of a row this binding can display/update. This class accepts a list of attribute names and gets the AttributeDef objects for those attributes from the associated ViewObject. This class also provides APIs to update values in a control given a new row or a set of rows. JUIteratorBinding uses APIs in this class to notify the controls of:
- Change in scrolling range if the control works with a range of rows
- Change in currency
- Row-inserted event
- Row-deleted event
This class also has accessor methods that return attribute values for Attributes with which this control binding is working. The indices of these attributes are ordered based on the names provided to this control binding in the constructor.
javabean.class

name=JUCtrlValueBinding

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 java.util.Map
  java.util.Map.Entry<K,V>

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ATTR_ATTRIBUTE`
`static java.lang.String`	`ATTR_ATTRIBUTE_DEF`
`static java.lang.String`	`ATTR_ATTRIBUTE_DEFS`
`static java.lang.String`	`ATTR_ATTRIBUTE_VALUE`
`static java.lang.String`	`ATTR_ATTRIBUTE_VALUES`
`static java.lang.String`	`ATTR_ATTRIBUTES`
`static java.lang.String`	`ATTR_AUTOSUBMIT`
`static java.lang.String`	`ATTR_CATEGORY`
`static java.lang.String`	`ATTR_DISPLAY_HEIGHT`
`static java.lang.String`	`ATTR_DISPLAY_HINT`
`static java.lang.String`	`ATTR_DISPLAY_WIDTH`
`static java.lang.String`	`ATTR_FIELD_ORDER`
`static java.lang.String`	`ATTR_FORMAT`
`static java.lang.String`	`ATTR_FORMATS`
`static java.lang.String`	`ATTR_HINTS`
`static java.lang.String`	`ATTR_INPUT_VALUE`
`static java.lang.String`	`ATTR_LABEL`
`static java.lang.String`	`ATTR_LABELS`
`static java.lang.String`	`ATTR_LABELSET`
`static java.lang.String`	`ATTR_MANDATORY`
`static java.lang.String`	`ATTR_PATH`
`static java.lang.String`	`ATTR_TOOLTIP`
`static java.lang.String`	`ATTR_UPDATEABLE`
`static java.lang.String`	`ATTR_VIEWABLE`
`static java.lang.String`	`DATACHANGE_EVENT_POLICY`
`protected static java.lang.String`	`EMPTY_STRING`
`static java.lang.String`	`GET_ALLOWS`
`protected AttributeDef[]`	`mAttrs`
`protected boolean`	`mHasInputVal`
`protected java.lang.Object`	`mInputVal`
`static java.lang.String`	`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, DC_BINDING_ERROR, mAttributeListener, mInternalGet_KeyResolved, mPermission, mPermissionInfo, ROW_KEY_STR

Fields inherited from class oracle.jbo.common.JboAbstractMap
MAP_NULL_VALUE

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`JUCtrlValueBinding()`
	`JUCtrlValueBinding(java.lang.Object control, DCIteratorBinding iterBinding, java.lang.String[] attrNames)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addBindingContainerChangeListenerForCtxEvent()` Creates new instance of BindingContainerChangeAdapterForCtxEvent and calls getBindingContainer().addBindingContainerChangeListenerForCtxEvent.
`void`	`addDataChangeListener(DataChangeListener listener)`
`protected void`	`clearAttrDefs()`
`protected void`	`clearEventsCache()` Deprecated. since 11.1.1.1.2
`void`	`compareAndSetAttribute(int index, java.lang.Object cVal)` Advanced method.
`protected void`	`createAndNotifyDCE(DataChangeEntry.DataChangeType type, java.lang.Object[] idvals, java.lang.String[] names)`
`protected void`	`createEventProducer()` createEventProducer creates new instance of JUCtrlValueEventProducer is not exists
`boolean`	`displayInShortForm()` Returns true if the attribute is to displayed in the short(summary) form.
`VariableValueManager`	`ensureVariableManager()`
`protected boolean`	`eventForMyRow(UpdateEvent event)`
`protected AttributeDef[]`	`fetchAttrDefs(DCIteratorBinding iter)`
`AttributeDef`	`findAttributeDef(java.lang.String name)` Gets an attribute definition, given its name.
`protected boolean`	`generateDCE()`
`java.lang.Object`	`getAttribute()` Returns formatted attribute value for this binding.
`java.lang.Object`	`getAttribute(int index)` Returns formatted attribute value for the attribute at the given index in this control binding's definition.
`java.lang.Object`	`getAttribute(java.lang.String name)`
`int`	`getAttributeCount()` Returns the number of defined attributes.
`AttributeDef`	`getAttributeDef()` Primarily for spel support.
`AttributeDef`	`getAttributeDef(int index)` Returns attribute definition at the given index.
`AttributeDef[]`	`getAttributeDefs()` Return Attribute definitions of the attributes to which this binding is bound to.
`AttributeDef[]`	`getAttributeDefsForRow(Row row)` Return Attribute definitions of the attributes to which this binding is bound to.
`java.lang.Object`	`getAttributeFromRow(int rowIndexInRange, int attrIndex)` Return formatted attribute value for the attribute at given index in the row at the given row index within the current range in the iterator that this binding is associated with.
`java.lang.Object`	`getAttributeFromRow(int rowIndexInRange, java.lang.String name)` Return formatted attribute value for the attribute of the given name in the row at the given row index within the current range in the iterator that this binding is associated with.
`java.lang.Object`	`getAttributeFromRow(Row row, AttributeDef def)` Return formatted attribute value for the attribute with the given attribute definition and in the given row.
`java.lang.Object`	`getAttributeFromRow(Row row, int attrIndex)` Return the attribute value for the attribute at the given index in this control binding and from within the given row.
`java.lang.Object`	`getAttributeFromRow(Row row, java.lang.String name)` Return the attribute value for the attribute of the given name from within the given row.
`int`	`getAttributeIndexOf(java.lang.String name)` Finds the index (0-based) of the named attribute.
`java.lang.String[]`	`getAttributeNames()` Return names of the attributes to which this binding is bound to and as defined in the binding definition.
`java.lang.Object[]`	`getAttributes()` Returns formatted attribute values for this binding.
`protected java.util.ArrayList`	`getAttributes(Row row, AttributeDef[] attrs)` Returns formatted attribute values for the given set of attribute defs.
`protected AttributeHints`	`getAttributeUIHelper(java.lang.String attrName)`
`java.util.ArrayList`	`getAttributeValidators()`
`java.util.ArrayList`	`getAttributeValidators(int index)`
`java.lang.Object`	`getAttributeValue()` Returns unformatted attribute value of the first attribute
`java.lang.Object`	`getAttributeValue(int j)` Returns unformatted attribute value of the first attribute
`protected java.lang.Object`	`getAttributeValueFromRow(int rowIndexInRange, int attrIndex)` Returns unformatted attribute value of the first attribute
`java.lang.Object[]`	`getAttributeValues()` Returns unformatted attribute values for this binding.
`protected java.util.ArrayList`	`getAttributeValues(Row row, AttributeDef[] attrs)` Returns un-formatted (raw) attribute values.
`protected java.lang.String[]`	`getAttrViewExpressions()`
`protected java.lang.Object`	`getBindingHint(java.lang.String key, LocaleContext lCtx)` Subclasses to override to provide custom impl.
`protected java.util.List`	`getCachedEvents()` Deprecated. since 11.1.1.1.2
`java.lang.String`	`getCategory()` Returns the category that this attribute belongs to
`protected DataControl.DataChangeEventPolicy`	`getChangeEventPolicy()`
`java.lang.String`	`getColumnNameForQuery(int index)`
`int`	`getControlType()` Returns the preferred control type for this attribute.
`DataControl.DataChangeEventPolicy`	`getDataChangeEventPolicy()`
`protected DataChangeListener`	`getDataChangeListener()`
`int`	`getDisplayHeight()` Returns the display width for this attribute.
`java.lang.String`	`getDisplayHint()` Retrieves the display hint that dictates whether this attribute should be visible or not.
`int`	`getDisplayWidth()` Returns the display width for this attribute.
`JboException`	`getError()` Primarily for spel support.
`java.util.List`	`getErrors()` Primarily for spel support.
`EventProducer`	`getEventProducer()` getEventProducer returns the EventProducer
`double`	`getFieldOrder()` Returns the field order for this attribute.
`java.lang.String`	`getFormat()` Retrieves the format to be used to format any attribute value.
`java.util.Map`	`getFormats()`
`java.lang.Object`	`getFormattedAttributeValue(java.lang.String attrName, java.lang.Object rawValue)`
`java.lang.String`	`getHint(java.lang.String sHintName)` Returns the hint value based on the hint name.
`java.lang.String`	`getHint(java.lang.String voAttrName, java.lang.String objectAttrName, java.lang.String sHintName)` Returns the hint value based on the hint name.
`java.util.Map`	`getHints()` Returns a map that can resolve the custom properties on the first attribute on this binding via el like: bindings.thisBindingName.label or bindings.thisBindingName.myCustomProperty where label and myCustomProperty are control hints or custom properties defined on the attributedef that this binding is associated with.
`protected java.util.List`	`getInputErrorsForRowKey(Key key)`
`java.lang.Object`	`getInputValue()` Primarily for spel support.
`java.lang.Object`	`getInputValue(JUCtrlValueBinding binding, int index)` Return a custom valueHandle for inputValue.
`JUCtrlInputValueHandler`	`getInputValueHandler()` Return the input handler that this binding uses for setInputValue.
`protected java.lang.Object`	`getInputValueInRow(JUCtrlValueBinding binding, Row row, AttributeDef ad)`
`protected java.lang.Object`	`getInputValueOnError()` Subclasses may override to return custom/cached/transformed input value when there is an exception stored on this binding.
`protected JUIteratorBinding`	`getIteratorBindingForDCE()`
`protected DCIteratorBinding.RenderHintTypes`	`getIteratorRenderHint()` To be used by view-technology specific bindings to determine if the associated iterator binding may be rendered in a secondary thread or not.
`java.lang.String`	`getLabel()` Retrieves the label to be used in any attribute prompts
`java.lang.String`	`getLabel(java.lang.String voAttrName, java.lang.String objectAttrName)` Retrieves the label to be used in any attribute prompts
`java.util.Map`	`getLabels()`
`java.lang.String[]`	`getLabelSet()`
`protected int`	`getLastEventId()`
`LocaleContext`	`getLocaleContext()`
`java.lang.Object[]`	`getMasterKeyPathForDCE(DataChangeEntry en)` * For internal framework use only * Returns an array of all elements except the first one from KeyPath.
`protected static java.lang.String`	`getMergedAttributeValues(java.util.List al)`
`java.lang.String`	`getNullValueString()`
`java.lang.String`	`getPath()` The returned path uniquely identifies this binding within a top-level bindingContainer.
`protected DCPermissionDef`	`getPermissionDef(java.lang.String name)`
`protected oracle.adf.share.security.PermissionHolder`	`getPermissionHolder(java.lang.String name)`
`PermissionInfo`	`getPermissionInfo()`
`java.lang.Object`	`getState()` In the process of re-creating a binding container.
`java.lang.String`	`getTooltip()` Retrives the tooltip text to be used for this attribute.
`java.lang.String`	`getTooltip(java.lang.String voAttrName, java.lang.String objectAttrName)` Retrives the tooltip text to be used for this attribute.
`protected boolean`	`hasEventProducer()`
`boolean`	`hasFormatInformation()` Returns true if any format hints have been defined for this attribute.
`protected boolean`	`hasServerBindingChanged()`
`boolean`	`hasVariables()`
`protected void`	`initResources()` Invoked when the bindingContainer is being initialized for the first time or after it's locale is changed.
`protected java.lang.Object`	`internalGet(java.lang.String key)` Subclasses should override this to handle a specific key.
`int`	`internalGetAttributeIndexOf(java.lang.String name, boolean th)` Given the name of the attribute get its index in the StructureDefinition.
`protected DCDataControl`	`internalGetDataControlReference()` use isAssociatedWithDataControl() to find if this binding is associated with a datacontrol.
`protected Row`	`internalGetRow()` Internal: Applications should not use this method.
`protected boolean`	`internalHasPermission(java.lang.String actions)`
`protected boolean`	`internalHasPermission(java.lang.String target, java.lang.String actions)`
`boolean`	`isArrayIteratorType()`
`boolean`	`isAttributeMandatory(int index)` Returns true if the attribute at the given index is set to be mandatory.
`boolean`	`isAttributeUpdateable(int index)` Determines whether this attribute (by attribute index relative to this binding) is updateable for the current row instance.
`protected boolean`	`isAttributeUpdateable(Row row, int index)`
`protected boolean`	`isAttributeUpdateable(Row row, java.lang.String attrName)`
`boolean`	`isAttributeUpdateable(java.lang.String attrName)` Determines whether the given attribute (by name) is updateable for the current row instance.
`boolean`	`isAutoSubmit()` Returns the autoSubmit value for this attribute.
`boolean`	`isBatchAttributesUpdate()`
`protected boolean`	`isEventsCachingEnabled()` Deprecated. since 11.1.1.1.2
`boolean`	`isMandatory()` Primarily for spel support.
`boolean`	`isNewInputValue(JUCtrlValueBinding binding, int index, java.lang.Object value)` Returns true, if the caller needs to call setInputValue() on this binding to update the current attribute value that this binding is set to.
`boolean`	`isNullInsertKeyPathForDCE(DataChangeEntry en)` * For internal framework use only * If this insert event is for data that need to be inserted before or after a known data point in the same hierarchy/level, then return false.
`boolean`	`isPushDataChangeEvents()`
`protected boolean`	`isPushOrPollDataChangeEvents()`
`boolean`	`isUpdateable()` Primarily for spel support.
`boolean`	`isViewable()`
`AttributeDef`	`lookupAttributeDef(java.lang.String name)` Gets an attribute definition, given its name.
`protected void`	`notifyDataChangeEvent(DataChangeEvent event)`
`protected void`	`notifyDataExceptionEvent(DataExceptionEvent event)`
`protected void`	`notifyDCE(DataChangeEvent event)` Deprecated. ...use notifyDataChangeEvent.
`protected void`	`pinDataControl(boolean flag)` Advanced for ADS usage only.
`protected void`	`processInputException(ValidationException vex)`
`boolean`	`processNewInputValue(java.lang.Object value)` Returns true, if the caller needs to call setInputValue() on this binding to update the current attribute value that this binding is set to.
`java.lang.Object`	`put(java.lang.Object obj, java.lang.Object value)`
`void`	`release(int flags)`
`void`	`removeAttrName(java.lang.String sName)`
`void`	`removeDataChangeListener(DataChangeListener listener)`
`protected void`	`removeFromDCExceptions()`
`protected void`	`resetAttributeDefs()`
`protected void`	`resetInputState()` Resets any exceptions and client-side values that this binding may hold.
`boolean`	`resolvePath(java.util.Map postMap)` Return true if this binding's path is found as a key in the given map.
`void`	`restoreFromState(java.lang.Object state)` Initialize binding instance with value from state object
`void`	`setArrayIteratorType()`
`void`	`setAttribute(int index, java.lang.Object value)`
`void`	`setAttribute(java.lang.String name, java.lang.Object value)`
`void`	`setAttributeInRow(int rowIndexInRange, int attrIndex, java.lang.Object value, boolean handleException)`
`void`	`setAttributeInRow(int rowIndexInRange, java.lang.String name, java.lang.Object value, boolean handleException)`
`void`	`setAttributeInRow(Row row, AttributeDef def, java.lang.Object value)`
`void`	`setAttributeInRow(Row row, AttributeDef def, java.lang.Object value, boolean handleException)`
`void`	`setAttributeInRow(Row row, int attrIndex, java.lang.Object value, boolean handleException)`
`void`	`setAttributeInRow(Row row, java.lang.String name, java.lang.Object value, boolean handleException)`
`void`	`setAttributeNames(java.lang.String[] attrNames)`
`void`	`setAttributes(AttributeDef[] attrs)`
`void`	`setAttributeValue(java.lang.Object val)` Sets the value to the first attribute in this binding.
`void`	`setAttributeValuesInRow(Row row, AttributeDef[] defs, java.lang.Object[] values, boolean handleException)`
`protected void`	`setAttrViewExpressions(java.lang.String[] stra)`
`protected void`	`setDef(DCControlBindingDef controlDef)`
`protected void`	`setError(JboException vex, java.lang.Object value)`
`protected void`	`setEventProducer(EventProducer producer)`
`protected void`	`setEventsCaching(boolean flag)` Deprecated. since 11.1.1.1.2
`void`	`setInputValue(JUCtrlValueBinding binding, int index, java.lang.Object value)` Implement value specific handling of the inputValue.
`void`	`setInputValue(java.lang.Object value)` Sets the value given and caches any error/exception in member variables for further access.
`void`	`setInputValueHandler(JUCtrlInputValueHandler hdlr)`
`protected void`	`setInputValueInRow(JUCtrlValueBinding binding, Row row, AttributeDef ad, java.lang.Object value, boolean handleException)`
`protected void`	`setIteratorBinding(DCIteratorBinding iterBinding)` Internal method, don't use.
`void`	`setListener(UpdateListener listener)`
`protected void`	`setNullValueString(java.lang.String str)`
`protected int`	`startEvents(int fromIndex)`
`void`	`stopEditing()` Notified by NavigationBar to stop any edits on the current control.
`protected void`	`stopEvents()`
`void`	`updateNavigated(NavigationEvent event)` Update the current row display as the currency has navigated in the iterator with which this control binding is working.
`void`	`updateRangeScrolled(ScrollEvent event)` Update the control display based on whether the rows of data has scrolled.
`void`	`updateRow(UpdateEvent event)` Notification that a row was updated in the associated iterator.
`void`	`updateRowDeleted(DeleteEvent event)` Notification that a row was deleted in the associated iterator.
`void`	`updateRowInserted(InsertEvent event)` Notification that a new row was inserted in the associated iterator.
`void`	`updateValuesFromRow(Row row)` Given a row, update the control with new attribute values from this row based on the attributes with which this binding is associated.
`abstract void`	`updateValuesFromRows(Row[] rows, boolean clear)` Given a set of rows, update the control with new attribute values from the rows based on the attributes with which this binding is associated.
`protected boolean`	`useRowSpecificHints()`
`java.lang.Object`	`validateInputValue(java.lang.Object value)` Return the failure exception object when this binding fails in validation.

Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding
addControlToPanel, getCurrentRow, getFormBinding, getIteratorBinding, reportException, setFormBinding

Methods inherited from class oracle.adf.model.binding.DCControlBinding
addToDCExceptions, evaluateBooleanExpression, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getAttributeListener, getBindingContainer, getControl, getControlModel, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getPermission, getPermissionTargetName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewableExpr, getViewObject, hasAttributeListener, hashCode, internalGetDataControl, internalSetName, isAssociatedWithDataControl, isControlQueriable, isControlViewable, isReleased, needsEstimatedRowCount, refreshControl, release, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setDataControlPinned, setListener, setName, setViewableExpr, toString

Methods inherited from class oracle.jbo.common.JboAbstractMap
entrySet, equals, internalPut, 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.StructureDef
getDefFullName, getDefName, getFullName, getName

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Field Detail
  - mAttrs
```
protected AttributeDef[] mAttrs
```
  - mHasInputVal
```
protected boolean mHasInputVal
```
  - mInputVal
```
protected java.lang.Object mInputVal
```
  - EMPTY_STRING
```
protected static final java.lang.String EMPTY_STRING
```
    See Also:
    
    Constant Field Values
  - SEP_LIST_DISPLAY
```
public static final java.lang.String SEP_LIST_DISPLAY
```
    See Also:
    
    Constant Field Values
  - ATTR_LABEL
```
public static final java.lang.String ATTR_LABEL
```
    See Also:
    
    Constant Field Values
  - ATTR_LABELS
```
public static final java.lang.String ATTR_LABELS
```
    See Also:
    
    Constant Field Values
  - ATTR_LABELSET
```
public static final java.lang.String ATTR_LABELSET
```
    See Also:
    
    Constant Field Values
  - ATTR_FORMAT
```
public static final java.lang.String ATTR_FORMAT
```
    See Also:
    
    Constant Field Values
  - ATTR_FORMATS
```
public static final java.lang.String ATTR_FORMATS
```
    See Also:
    
    Constant Field Values
  - ATTR_TOOLTIP
```
public static final java.lang.String ATTR_TOOLTIP
```
    See Also:
    
    Constant Field Values
  - ATTR_DISPLAY_HINT
```
public static final java.lang.String ATTR_DISPLAY_HINT
```
    See Also:
    
    Constant Field Values
  - ATTR_DISPLAY_HEIGHT
```
public static final java.lang.String ATTR_DISPLAY_HEIGHT
```
    See Also:
    
    Constant Field Values
  - ATTR_DISPLAY_WIDTH
```
public static final java.lang.String ATTR_DISPLAY_WIDTH
```
    See Also:
    
    Constant Field Values
  - ATTR_AUTOSUBMIT
```
public static final java.lang.String ATTR_AUTOSUBMIT
```
    See Also:
    
    Constant Field Values
  - ATTR_FIELD_ORDER
```
public static final java.lang.String ATTR_FIELD_ORDER
```
    See Also:
    
    Constant Field Values
  - ATTR_CATEGORY
```
public static final java.lang.String ATTR_CATEGORY
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTE
```
public static final java.lang.String ATTR_ATTRIBUTE
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTES
```
public static final java.lang.String ATTR_ATTRIBUTES
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTE_DEF
```
public static final java.lang.String ATTR_ATTRIBUTE_DEF
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTE_DEFS
```
public static final java.lang.String ATTR_ATTRIBUTE_DEFS
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTE_VALUE
```
public static final java.lang.String ATTR_ATTRIBUTE_VALUE
```
    See Also:
    
    Constant Field Values
  - ATTR_ATTRIBUTE_VALUES
```
public static final java.lang.String ATTR_ATTRIBUTE_VALUES
```
    See Also:
    
    Constant Field Values
  - ATTR_INPUT_VALUE
```
public static final java.lang.String ATTR_INPUT_VALUE
```
    See Also:
    
    Constant Field Values
  - ATTR_MANDATORY
```
public static final java.lang.String ATTR_MANDATORY
```
    See Also:
    
    Constant Field Values
  - ATTR_UPDATEABLE
```
public static final java.lang.String ATTR_UPDATEABLE
```
    See Also:
    
    Constant Field Values
  - ATTR_PATH
```
public static final java.lang.String ATTR_PATH
```
    See Also:
    
    Constant Field Values
  - ATTR_VIEWABLE
```
public static final java.lang.String ATTR_VIEWABLE
```
    See Also:
    
    Constant Field Values
  - DATACHANGE_EVENT_POLICY
```
public static final java.lang.String DATACHANGE_EVENT_POLICY
```
    See Also:
    
    Constant Field Values
  - ATTR_HINTS
```
public static final java.lang.String ATTR_HINTS
```
    See Also:
    
    Constant Field Values
  - GET_ALLOWS
```
public static final java.lang.String GET_ALLOWS
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - JUCtrlValueBinding
```
protected JUCtrlValueBinding()
```
  - JUCtrlValueBinding
```
public JUCtrlValueBinding(java.lang.Object control,
                          DCIteratorBinding iterBinding,
                          java.lang.String[] attrNames)
```
- Method Detail
  - setAttributeNames
```
public void setAttributeNames(java.lang.String[] attrNames)
```
  - setAttributes
```
public void setAttributes(AttributeDef[] attrs)
```
  - setIteratorBinding
```
protected void setIteratorBinding(DCIteratorBinding iterBinding)
```
    Description copied from class: DCControlBinding
    
    Internal method, don't use.
    
    Overrides:
    
    setIteratorBinding in class DCControlBinding
  - removeAttrName
```
public void removeAttrName(java.lang.String sName)
```
  - initResources
```
protected void initResources()
```
    Description copied from class: DCControlBinding
    
    Invoked when the bindingContainer is being initialized for the first time or after it's locale is changed. This gives subclasses a chance to drop their initialized locale based resources.
    
    Specified by:
    
    initResources in class DCControlBinding
  - updateValuesFromRow
```
public void updateValuesFromRow(Row row)
```
    Given a row, update the control with new attribute values from this row based on the attributes with which this binding is associated.
  - updateValuesFromRows
```
public abstract void updateValuesFromRows(Row[] rows,
                                          boolean clear)
```
    Given a set of rows, update the control with new attribute values from the rows based on the attributes with which this binding is associated. If clear is true, the control is expected to remove the current displayed value and associated children values (like in a tree, remove all subnodes) and then set the new values.
  - generateDCE
```
protected final boolean generateDCE()
```
  - updateRangeScrolled
```
public void updateRangeScrolled(ScrollEvent event)
```
    Update the control display based on whether the rows of data has scrolled.
    
    See Also:
    
    ScrollEvent
  - isPushDataChangeEvents
```
@Concealed
public boolean isPushDataChangeEvents()
```
    For internal use only. Application developers should not use this
  - isPushOrPollDataChangeEvents
```
protected boolean isPushOrPollDataChangeEvents()
```
  - internalGetDataControlReference
```
@Concealed
protected final DCDataControl internalGetDataControlReference()
```
    use isAssociatedWithDataControl() to find if this binding is associated with a datacontrol.
    
    Overrides:
    
    internalGetDataControlReference in class DCControlBinding
    
    For internal use only. Application developers should not use this
  - updateNavigated
```
public void updateNavigated(NavigationEvent event)
```
    Update the current row display as the currency has navigated in the iterator with which this control binding is working.
  - createAndNotifyDCE
```
protected void createAndNotifyDCE(DataChangeEntry.DataChangeType type,
                                  java.lang.Object[] idvals,
                                  java.lang.String[] names)
```
  - updateRowInserted
```
public void updateRowInserted(InsertEvent event)
```
    Notification that a new row was inserted in the associated iterator. Control-bindings like JTable refresh their display to show the new row on this event.
  - updateRowDeleted
```
public void updateRowDeleted(DeleteEvent event)
```
    Notification that a row was deleted in the associated iterator. Moves the currency on the associated row iterator to the next row (or previous row if there is no next row) when the currency on the iterator was on the deleted row.
  - eventForMyRow
```
protected boolean eventForMyRow(UpdateEvent event)
```
  - updateRow
```
public void updateRow(UpdateEvent event)
```
    Notification that a row was updated in the associated iterator. Control-bindings like JTable refresh their display to show the new row on this event.
  - getAttributeNames
```
public java.lang.String[] getAttributeNames()
```
    Return names of the attributes to which this binding is bound to and as defined in the binding definition.
  - getAttributeDefsForRow
```
public AttributeDef[] getAttributeDefsForRow(Row row)
```
    Return Attribute definitions of the attributes to which this binding is bound to.
  - getAttributeDefs
```
public AttributeDef[] getAttributeDefs()
```
    Return Attribute definitions of the attributes to which this binding is bound to.
    
    Specified by:
    
    getAttributeDefs in interface StructureDef
    
    Returns:
    
    an array of attribute definitions.
  - fetchAttrDefs
```
protected AttributeDef[] fetchAttrDefs(DCIteratorBinding iter)
```
  - resetAttributeDefs
```
protected void resetAttributeDefs()
```
  - getAttributeDef
```
public AttributeDef getAttributeDef(int index)
```
    Returns attribute definition at the given index. Returns null if not found.
    
    Specified by:
    
    getAttributeDef in interface StructureDef
    
    Parameters:
    
    index - the index of an AttributeDef, where the leftmost attribute has index zero.
    
    Returns:
    
    an attribute definition.
  - getColumnNameForQuery
```
public java.lang.String getColumnNameForQuery(int index)
```
    Specified by:
    
    getColumnNameForQuery in interface StructureDef
  - lookupAttributeDef
```
public AttributeDef lookupAttributeDef(java.lang.String name)
```
    Description copied from interface: StructureDef
    
    Gets an attribute definition, given its name.
    
    Specified by:
    
    lookupAttributeDef in interface StructureDef
    
    Parameters:
    
    name - the name of an AttributeDef.
    
    Returns:
    
    an attribute definition if found, null otherwise
  - findAttributeDef
```
public AttributeDef findAttributeDef(java.lang.String name)
```
    Description copied from interface: StructureDef
    
    Gets an attribute definition, given its name.
    
    Specified by:
    
    findAttributeDef in interface StructureDef
    
    Parameters:
    
    name - the name of an AttributeDef.
    
    Returns:
    
    an attribute definition
  - getAttributeFromRow
```
public java.lang.Object getAttributeFromRow(int rowIndexInRange,
                                            int attrIndex)
```
    Return formatted attribute value for the attribute at given index in the row at the given row index within the current range in the iterator that this binding is associated with.
  - getAttributeFromRow
```
public java.lang.Object getAttributeFromRow(int rowIndexInRange,
                                            java.lang.String name)
```
    Return formatted attribute value for the attribute of the given name in the row at the given row index within the current range in the iterator that this binding is associated with.
  - getAttributeFromRow
```
public java.lang.Object getAttributeFromRow(Row row,
                                            AttributeDef def)
```
    Return formatted attribute value for the attribute with the given attribute definition and in the given row.
  - getAttributeFromRow
```
public java.lang.Object getAttributeFromRow(Row row,
                                            int attrIndex)
```
    Return the attribute value for the attribute at the given index in this control binding and from within the given row.
  - getAttributeFromRow
```
public java.lang.Object getAttributeFromRow(Row row,
                                            java.lang.String name)
```
    Return the attribute value for the attribute of the given name from within the given row.
  - setAttributeInRow
```
public void setAttributeInRow(int rowIndexInRange,
                              int attrIndex,
                              java.lang.Object value,
                              boolean handleException)
```
  - getNullValueString
```
public java.lang.String getNullValueString()
```
  - setNullValueString
```
protected void setNullValueString(java.lang.String str)
```
  - setAttributeInRow
```
public void setAttributeInRow(int rowIndexInRange,
                              java.lang.String name,
                              java.lang.Object value,
                              boolean handleException)
```
  - setAttributeInRow
```
public void setAttributeInRow(Row row,
                              AttributeDef def,
                              java.lang.Object value)
```
  - isBatchAttributesUpdate
```
public final boolean isBatchAttributesUpdate()
```
  - setAttributeValuesInRow
```
public void setAttributeValuesInRow(Row row,
                                    AttributeDef[] defs,
                                    java.lang.Object[] values,
                                    boolean handleException)
```
  - setAttributeInRow
```
public void setAttributeInRow(Row row,
                              AttributeDef def,
                              java.lang.Object value,
                              boolean handleException)
```
  - getFormattedAttributeValue
```
public java.lang.Object getFormattedAttributeValue(java.lang.String attrName,
                                                   java.lang.Object rawValue)
```
  - setAttributeInRow
```
public void setAttributeInRow(Row row,
                              int attrIndex,
                              java.lang.Object value,
                              boolean handleException)
```
  - setAttributeInRow
```
public void setAttributeInRow(Row row,
                              java.lang.String name,
                              java.lang.Object value,
                              boolean handleException)
```
  - internalGetRow
```
protected Row internalGetRow()
```
    Internal: Applications should not use this method.
  - getAttribute
```
public java.lang.Object getAttribute(int index)
```
    Returns formatted attribute value for the attribute at the given index in this control binding's definition.
  - getAttribute
```
public java.lang.Object getAttribute(java.lang.String name)
```
  - getAttribute
```
public java.lang.Object getAttribute()
```
    Returns formatted attribute value for this binding.
  - getAttributes
```
public java.lang.Object[] getAttributes()
```
    Returns formatted attribute values for this binding.
  - getAttributes
```
protected java.util.ArrayList getAttributes(Row row,
                                            AttributeDef[] attrs)
```
    Returns formatted attribute values for the given set of attribute defs.
  - setAttribute
```
public void setAttribute(int index,
                         java.lang.Object value)
```
  - setAttribute
```
public void setAttribute(java.lang.String name,
                         java.lang.Object value)
```
  - getAttributeCount
```
public int getAttributeCount()
```
    Description copied from interface: StructureDef
    
    Returns the number of defined attributes.
    
    Specified by:
    
    getAttributeCount in interface StructureDef
    
    Returns:
    
    the number of attributes.
  - getAttributeIndexOf
```
public int getAttributeIndexOf(java.lang.String name)
```
    Description copied from interface: StructureDef
    
    Finds the index (0-based) of the named attribute.
    
    Specified by:
    
    getAttributeIndexOf in interface StructureDef
    
    Parameters:
    
    name - the attribute's name.
    
    Returns:
    
    an integer in the range 0 to getAttributeCount() - 1. If the named attribute is not found, it returns -1.
  - internalGetAttributeIndexOf
```
@Concealed
public int internalGetAttributeIndexOf(java.lang.String name,
                                                  boolean th)
```
    Given the name of the attribute get its index in the StructureDefinition.
    
    Parameters:
    
    name - Name of the attribute.
    
    th - If the value is true and the attribute is not present an exception is thrown. Otherwise this method will return -1.
    
    For internal use only. Application developers should not use this
  - getAttributeValue
```
public java.lang.Object getAttributeValue()
```
    Returns unformatted attribute value of the first attribute
  - getAttributeValue
```
public java.lang.Object getAttributeValue(int j)
```
    Returns unformatted attribute value of the first attribute
  - setAttributeValue
```
public void setAttributeValue(java.lang.Object val)
```
    Sets the value to the first attribute in this binding.
    For web UI bindings, note that calling this method does not guarentee that the containing BindingContainer will validate all the associated data during the validation phase of the page lifecycle. For web UI bindings, use processNewInputValue followed by setInputValue.
  - getAttributeValues
```
protected java.util.ArrayList getAttributeValues(Row row,
                                                 AttributeDef[] attrs)
```
    Returns un-formatted (raw) attribute values.
  - getAttributeValueFromRow
```
protected java.lang.Object getAttributeValueFromRow(int rowIndexInRange,
                                                    int attrIndex)
```
    Returns unformatted attribute value of the first attribute
  - getAttributeValues
```
public java.lang.Object[] getAttributeValues()
```
    Returns unformatted attribute values for this binding.
  - getMergedAttributeValues
```
protected static java.lang.String getMergedAttributeValues(java.util.List al)
```
  - isAttributeMandatory
```
public boolean isAttributeMandatory(int index)
```
    Returns true if the attribute at the given index is set to be mandatory.
  - isAttributeUpdateable
```
protected boolean isAttributeUpdateable(Row row,
                                        java.lang.String attrName)
```
  - isAttributeUpdateable
```
protected boolean isAttributeUpdateable(Row row,
                                        int index)
```
  - isAttributeUpdateable
```
public boolean isAttributeUpdateable(java.lang.String attrName)
```
    Determines whether the given attribute (by name) is updateable for the current row instance. Returns true if iterator is in data mode and is the corresponding row. If iterator is in find mode, then does an additional check to determine whether the associated control is queriable.
  - isAttributeUpdateable
```
public boolean isAttributeUpdateable(int index)
```
    Determines whether this attribute (by attribute index relative to this binding) is updateable for the current row instance. Returns true if iterator is in data mode and is the corresponding row. If iterator is in find mode, then does an additional check to determine whether the associated control is queriable.
  - stopEditing
```
public void stopEditing()
```
    Notified by NavigationBar to stop any edits on the current control. Primarily for grid and tree to notify their cell editors to stop editing.
  - setArrayIteratorType
```
public void setArrayIteratorType()
```
  - isArrayIteratorType
```
public boolean isArrayIteratorType()
```
  - clearAttrDefs
```
@Concealed
protected void clearAttrDefs()
```
    Overrides:
    
    clearAttrDefs in class DCControlBinding
    
    For internal use only. Application developers should not use this
    
    *** For internal framework use only ***
  - release
```
public void release(int flags)
```
    Overrides:
    
    release in class DCControlBinding
  - removeFromDCExceptions
```
protected void removeFromDCExceptions()
```
    Overrides:
    
    removeFromDCExceptions in class DCControlBinding
  - getLocaleContext
```
public final LocaleContext getLocaleContext()
```
  - getAttributeUIHelper
```
protected final AttributeHints getAttributeUIHelper(java.lang.String attrName)
```
  - getLabelSet
```
public java.lang.String[] getLabelSet()
```
  - getLabels
```
public java.util.Map getLabels()
```
  - getLabel
```
public java.lang.String getLabel()
```
    Retrieves the label to be used in any attribute prompts
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
    
    javabean.property
  - getFormats
```
public java.util.Map getFormats()
```
  - getFormat
```
public java.lang.String getFormat()
```
    Retrieves the format to be used to format any attribute value.
  - getTooltip
```
public java.lang.String getTooltip()
```
    Retrives the tooltip text to be used for this attribute. Calling this on a control-binding that does not have an attribute will throw a NullPointerException
    
    javabean.property
  - getDisplayHint
```
public java.lang.String getDisplayHint()
```
    Retrieves the display hint that dictates whether this attribute should be visible or not. The two possible values are:
    - ATTRIBUTE_DISPLAY_HINT_DISPLAY = "Display";
    - ATTRIBUTE_DISPLAY_HINT_HIDE = "Hide";
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getControlType
```
public int getControlType()
```
    Returns the preferred control type for this attribute.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getDisplayWidth
```
public int getDisplayWidth()
```
    Returns the display width for this attribute.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getDisplayHeight
```
public int getDisplayHeight()
```
    Returns the display width for this attribute.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - isAutoSubmit
```
public boolean isAutoSubmit()
```
    Returns the autoSubmit value for this attribute.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getFieldOrder
```
public double getFieldOrder()
```
    Returns the field order for this attribute.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getCategory
```
public java.lang.String getCategory()
```
    Returns the category that this attribute belongs to
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
    
    javabean.property
  - getHint
```
public java.lang.String getHint(java.lang.String sHintName)
```
    Returns the hint value based on the hint name.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - hasFormatInformation
```
public boolean hasFormatInformation()
```
    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.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - displayInShortForm
```
public boolean displayInShortForm()
```
    Returns true if the attribute is to displayed in the short(summary) form.
    Calling this on a control-binding that does not have an attribute will throw a NullPointerException
  - getLabel
```
public java.lang.String getLabel(java.lang.String voAttrName,
                                 java.lang.String objectAttrName)
```
    Retrieves the label to be used in any attribute prompts
  - getTooltip
```
public java.lang.String getTooltip(java.lang.String voAttrName,
                                   java.lang.String objectAttrName)
```
    Retrives the tooltip text to be used for this attribute.
  - getHint
```
public java.lang.String getHint(java.lang.String voAttrName,
                                java.lang.String objectAttrName,
                                java.lang.String sHintName)
```
    Returns the hint value based on the hint name.
  - getAttributeValidators
```
public final java.util.ArrayList getAttributeValidators()
```
  - getAttributeValidators
```
public java.util.ArrayList getAttributeValidators(int index)
```
  - internalGet
```
protected java.lang.Object internalGet(java.lang.String key)
```
    Subclasses should override this to handle a specific key. If they do find the key valid, they should also set the mInternalGet_KeyResolved to 'true' so that bean-introspection is not done for valid null-value returns from the internalGet() call.
    Properties returned vis getter on this control bindings are:
  - attributeValue - returns getAttributeValue()
  - inputValue - returns getInputValue()
  - updateable - returns isUpdateable()
  - mandatory - returns isMandatory()
  - path - returns getPath()
  - attributeValues - returns getAttributeValues()
  - label - returns getLabel()
  - tooltip - returns getTooltip()
  - displayHint - returns getDisplayHint()
  - displayHeight - returns getDisplayHeight()
  - displayWidth - returns getDisplayWidth()
  - autoSubmit - returns isAutoSubmit()
  - fieldOrder - returns getFieldOrder()
  - category - returns getCategory()
  - attributeDef - returns getAttributeDef()
  - attributeDefs - returns getAttributeDefs()
  - labels - returns getLabels()
  - labelSet - returns getLabelSet()
  - hints - returns getHints()

Overrides:: internalGet in class DCControlBinding

put

public java.lang.Object put(java.lang.Object obj,
                            java.lang.Object value)

Specified by:: put in interface java.util.Map
Overrides:: put in class JboAbstractMap

getHints
```
public java.util.Map getHints()
```
Returns a map that can resolve the custom properties on the first attribute on this binding via el like: bindings.thisBindingName.label or bindings.thisBindingName.myCustomProperty where label and myCustomProperty are control hints or custom properties defined on the attributedef that this binding is associated with.

javabean.property

resetInputState
```
protected void resetInputState()
```
Description copied from class: DCControlBinding

Resets any exceptions and client-side values that this binding may hold. This is used by control-bindings to reset their state before refreshing values from the MT.

Specified by:

resetInputState in class DCControlBinding

processInputException
```
protected void processInputException(ValidationException vex)
```
Overrides:

processInputException in class DCControlBinding

setError

protected void setError(JboException vex,
                        java.lang.Object value)

isUpdateable
```
public boolean isUpdateable()
```
Primarily for spel support. Could be removed prior to 905Prod and merged into a get() method for spel-access.
Returns updateability of the first attribute

javabean.property

isMandatory
```
public boolean isMandatory()
```
Primarily for spel support. Could be removed prior to 905Prod and merged into a get() method for spel-access.
Returns mandatory flag for the first attribute that this binding is bound to.

javabean.property

getAttributeDef
```
public AttributeDef getAttributeDef()
```
Primarily for spel support. Could be removed prior to 905Prod and merged into a get() method for spel-access.
Returns Attribute definition for the first attribute

javabean.property

getPath
```
public java.lang.String getPath()
```
The returned path uniquely identifies this binding within a top-level bindingContainer.

resolvePath
```
public boolean resolvePath(java.util.Map postMap)
```
Return true if this binding's path is found as a key in the given map.

getInputValueOnError
```
protected java.lang.Object getInputValueOnError()
```
Subclasses may override to return custom/cached/transformed input value when there is an exception stored on this binding. mErrExc will should not be null when this method is invoked.

getInputValue
```
public java.lang.Object getInputValue()
```
Primarily for spel support. Could be removed prior to 905Prod and merged into a get() method for spel-access.
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);

javabean.property

getInputValue
```
public java.lang.Object getInputValue(JUCtrlValueBinding binding,
                                      int index)
```
Description copied from interface: JUCtrlValueHandler

Return a custom valueHandle for inputValue.

Specified by:

getInputValue in interface JUCtrlValueHandler

Parameters:

binding - Control binding associated with the attribute.

index - Index of the attribute in this control binding

Returns:

InputValue for the given control binding.

setInputValue
```
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. It is expected that this call is preceded by call to processNewInputValue which sets up the containing BindingContainer for validation phase of the web app lifecycle.

validateInputValue
```
public java.lang.Object validateInputValue(java.lang.Object value)
```
Return the failure exception object when this binding fails in validation. On success return null.

setInputValue
```
public void setInputValue(JUCtrlValueBinding binding,
                          int index,
                          java.lang.Object value)
```
Description copied from interface: JUCtrlInputValueHandler

Implement value specific handling of the inputValue. For Example Intermedia domains know how to update their data based on a file url or Struts FileHandle as input value. JUCtrlValueBinding provides the base domain object (or null in which case it also provides access to the AttributeDef that contains the domain/value type). Custom implementation for the Intermedia domain may then update some fields on the domain instead of the entire domain Object.

Specified by:

setInputValue in interface JUCtrlInputValueHandler

Parameters:

binding - Control binding that is associated to the attribute to be updated.

index - Index of the attribute in this control binding to update with the given Input Value. Note that for most single attribute control like TextFields, this value should be 0.

value - Value to be set as InputValue for the given control binding.

setInputValueInRow

protected void setInputValueInRow(JUCtrlValueBinding binding,
                                  Row row,
                                  AttributeDef ad,
                                  java.lang.Object value,
                                  boolean handleException)

getInputValueInRow

protected java.lang.Object getInputValueInRow(JUCtrlValueBinding binding,
                                              Row row,
                                              AttributeDef ad)

processNewInputValue
```
public boolean processNewInputValue(java.lang.Object value)
```
Returns true, if the caller needs to call setInputValue() on this binding to update the current attribute value that this binding is set to.
If the value is different than the attribute value, or if this binding had cached an error in a pervious setInputValue, then this method returns true.

isNewInputValue
```
public boolean isNewInputValue(JUCtrlValueBinding binding,
                               int index,
                               java.lang.Object value)
```
Returns true, if the caller needs to call setInputValue() on this binding to update the current attribute value that this binding is set to.
If the value is different than the attribute value, or if this binding had cached an error in a pervious setInputValue, then this method returns true.

Specified by:

isNewInputValue in interface JUCtrlInputValueHandler

getError
```
public JboException getError()
```
Primarily for spel support.
Returns exception that occured on last setInputValue

Overrides:

getError in class DCControlBinding

javabean.property

getErrors
```
public java.util.List getErrors()
```
Primarily for spel support.
Returns exceptions that occured on last setInputValue

Overrides:

getErrors in class DCControlBinding

getInputErrorsForRowKey

protected java.util.List getInputErrorsForRowKey(Key key)

hasServerBindingChanged

protected boolean hasServerBindingChanged()

compareAndSetAttribute
```
public void compareAndSetAttribute(int index,
                                   java.lang.Object cVal)
```
Advanced method. Compares the value from the value for an attribute at the given index as stored by the data that this binding is bound to and if the value is different, then sets it on the bound attribute at the given index.

getInputValueHandler
```
public final JUCtrlInputValueHandler getInputValueHandler()
```
Return the input handler that this binding uses for setInputValue. By default this binding itself is the input handler. This handler may be customized by providing a custom inputhandler class name in the definition for this binding (declaritvely at designtime) or by setting it programmatically using the setInptuValueHandler method.

setInputValueHandler

public void setInputValueHandler(JUCtrlInputValueHandler hdlr)

hasVariables
```
public final boolean hasVariables()
```

ensureVariableManager

public final VariableValueManager ensureVariableManager()

internalHasPermission
```
protected boolean internalHasPermission(java.lang.String actions)
```
Overrides:

internalHasPermission in class DCControlBinding

internalHasPermission

protected boolean internalHasPermission(java.lang.String target,
                                        java.lang.String actions)

Overrides:: internalHasPermission in class DCControlBinding

getPermissionInfo
```
public PermissionInfo getPermissionInfo()
```
Overrides:

getPermissionInfo in class DCControlBinding

isViewable
```
public final boolean isViewable()
```

getPermissionHolder

protected oracle.adf.share.security.PermissionHolder getPermissionHolder(java.lang.String name)

getPermissionDef

protected DCPermissionDef getPermissionDef(java.lang.String name)

setEventsCaching
```
@Concealed
protected void setEventsCaching(boolean flag)
```
Deprecated. since 11.1.1.1.2

Internal: Applications should not use this method. Disables or enables the event cache. Event cache is currently maintained at the iterator binding level. Disabling the event cache will also disable event caching on other control bindings under the same iterator binding. Similarly, enabling the event cache will also Enable event caching on other control bindings under the same iterator binding.

Parameters:

flag - true to enable event caching, false to disable.

For internal use only. Application developers should not use this

isEventsCachingEnabled
```
@Concealed
protected boolean isEventsCachingEnabled()
```
Deprecated. since 11.1.1.1.2

Internal: Applications should not use this method. Checks whether the event cache is enabled.

Returns:

true if the event cache is enabled. false otherwise.

For internal use only. Application developers should not use this

getCachedEvents
```
@Concealed
protected java.util.List getCachedEvents()
```
Deprecated. since 11.1.1.1.2

Internal: Applications should not use this method.

For internal use only. Application developers should not use this

clearEventsCache
```
@Concealed
protected void clearEventsCache()
```
Deprecated. since 11.1.1.1.2

Internal: Applications should not use this method.

For internal use only. Application developers should not use this

setListener
```
public void setListener(UpdateListener listener)
```
Overrides:

setListener in class DCControlBinding

getIteratorBindingForDCE

protected JUIteratorBinding getIteratorBindingForDCE()

addDataChangeListener

public void addDataChangeListener(DataChangeListener listener)

removeDataChangeListener

public void removeDataChangeListener(DataChangeListener listener)

getDataChangeListener

protected DataChangeListener getDataChangeListener()

notifyDataExceptionEvent

protected void notifyDataExceptionEvent(DataExceptionEvent event)

notifyDCE

protected void notifyDCE(DataChangeEvent event)

Deprecated. ...use notifyDataChangeEvent.

notifyDataChangeEvent

protected void notifyDataChangeEvent(DataChangeEvent event)

setDef
```
@Concealed
protected void setDef(DCControlBindingDef controlDef)
```
Overrides:

setDef in class DCControlBinding

For internal use only. Application developers should not use this

*** For internal framework use only ***

addBindingContainerChangeListenerForCtxEvent
```
public void addBindingContainerChangeListenerForCtxEvent()
```
Creates new instance of BindingContainerChangeAdapterForCtxEvent and calls getBindingContainer().addBindingContainerChangeListenerForCtxEvent.

getAttrViewExpressions

protected java.lang.String[] getAttrViewExpressions()

setAttrViewExpressions
```
@Concealed
protected void setAttrViewExpressions(java.lang.String[] stra)
```
For internal use only. Application developers should not use this

*** For internal framework use only ***

pinDataControl

protected void pinDataControl(boolean flag)

Advanced for ADS usage only.

startEvents
```
@Concealed
protected int startEvents(int fromIndex)
```
For internal use only. Application developers should not use this

*** For internal framework use in ADS only ***

stopEvents
```
protected void stopEvents()
```

getLastEventId
```
@Concealed
protected int getLastEventId()
```
For internal use only. Application developers should not use this

*** For internal framework use in ADS only ***

getDataChangeEventPolicy
```
@Concealed
public DataControl.DataChangeEventPolicy getDataChangeEventPolicy()
```
For internal use only. Application developers should not use this

*** For internal framework use in ADS only ***

isNullInsertKeyPathForDCE
```
public final boolean isNullInsertKeyPathForDCE(DataChangeEntry en)
```
*** For internal framework use only *** If this insert event is for data that need to be inserted before or after a known data point in the same hierarchy/level, then return false. Otherwise return true. Check if the first entry in the insertKey path is null if so, datacontrol is implying that this insert event is for data that can be inserted at the beginning or end of the collection at that level (based on data change type).

getMasterKeyPathForDCE
```
public final java.lang.Object[] getMasterKeyPathForDCE(DataChangeEntry en)
```
*** For internal framework use only *** Returns an array of all elements except the first one from KeyPath. Returns null if the KeyPath is null or KeyPath has only one element.

getChangeEventPolicy

protected DataControl.DataChangeEventPolicy getChangeEventPolicy()

getIteratorRenderHint
```
protected DCIteratorBinding.RenderHintTypes getIteratorRenderHint()
```
To be used by view-technology specific bindings to determine if the associated iterator binding may be rendered in a secondary thread or not. The default is DCIteratorBinding.RenderHintTypes.immediate to indicate that the data for this binding should be fetched and rendered when the page is rendered. A user may choose to mark the iteratorBinding's hint to background to indicate that the iteratorBinding's data may be fetched lazily during the secondary render threads.

useRowSpecificHints

protected boolean useRowSpecificHints()

getBindingHint

protected java.lang.Object getBindingHint(java.lang.String key,
                                          LocaleContext lCtx)

Subclasses to override to provide custom impl. of a binding hint name lookup.

getState
```
@Concealed
public java.lang.Object getState()
```
Description copied from class: DCControlBinding

In the process of re-creating a binding container. Each control binding wil be asked if it has a state object that should be saved and passed in during the re-create of the binding. This state object is opaque, only the binding will interpret the contents.

Overrides:

getState in class DCControlBinding

Returns:

For internal use only. Application developers should not use this

restoreFromState
```
@Concealed
public void restoreFromState(java.lang.Object state)
```
Description copied from class: DCControlBinding

Initialize binding instance with value from state object

Overrides:

restoreFromState in class DCControlBinding

Parameters:

state -

For internal use only. Application developers should not use this

getEventProducer
```
public EventProducer getEventProducer()
```
getEventProducer returns the EventProducer

hasEventProducer
```
protected boolean hasEventProducer()
```

setEventProducer

protected void setEventProducer(EventProducer producer)

createEventProducer
```
protected void createEventProducer()
```
createEventProducer creates new instance of JUCtrlValueEventProducer is not exists

Class JUCtrlValueBinding

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Field Summary

Fields inherited from class oracle.adf.model.binding.DCControlBinding

Fields inherited from class oracle.jbo.common.JboAbstractMap

Constructor Summary

Method Summary

Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding

Methods inherited from class oracle.adf.model.binding.DCControlBinding

Methods inherited from class oracle.jbo.common.JboAbstractMap

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface oracle.jbo.StructureDef

Methods inherited from interface java.util.Map

Field Detail

mAttrs

mHasInputVal

mInputVal

EMPTY_STRING

SEP_LIST_DISPLAY

ATTR_LABEL

ATTR_LABELS

ATTR_LABELSET

ATTR_FORMAT

ATTR_FORMATS

ATTR_TOOLTIP

ATTR_DISPLAY_HINT

ATTR_DISPLAY_HEIGHT

ATTR_DISPLAY_WIDTH

ATTR_AUTOSUBMIT

ATTR_FIELD_ORDER

ATTR_CATEGORY

ATTR_ATTRIBUTE

ATTR_ATTRIBUTES

ATTR_ATTRIBUTE_DEF

ATTR_ATTRIBUTE_DEFS

ATTR_ATTRIBUTE_VALUE

ATTR_ATTRIBUTE_VALUES

ATTR_INPUT_VALUE

ATTR_MANDATORY

ATTR_UPDATEABLE

ATTR_PATH

ATTR_VIEWABLE

DATACHANGE_EVENT_POLICY

ATTR_HINTS

GET_ALLOWS

Constructor Detail

JUCtrlValueBinding

JUCtrlValueBinding

Method Detail

setAttributeNames

setAttributes

setIteratorBinding

removeAttrName

initResources

updateValuesFromRow

updateValuesFromRows

generateDCE

updateRangeScrolled

isPushDataChangeEvents

isPushOrPollDataChangeEvents

internalGetDataControlReference

updateNavigated

createAndNotifyDCE

updateRowInserted

updateRowDeleted

eventForMyRow

updateRow

getAttributeNames

getAttributeDefsForRow

getAttributeDefs

fetchAttrDefs

resetAttributeDefs

getAttributeDef

getColumnNameForQuery

lookupAttributeDef

findAttributeDef

getAttributeFromRow