oracle.jbo.uicli.jui

Class JULabelBinding

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.jui.JULabelBinding

All Implemented Interfaces:

java.util.Map, AttributeBinding, ControlBinding, StructureDef, JUCtrlInputValueHandler, JUCtrlValueHandler

public class JULabelBinding
extends JUCtrlAttrsBinding

Binds a label control as a control binding so that the text for the label is derived from an attribute of a ViewObject row. This binding can be used to create dynamic UIs with labels read from the database using ViewObjects. JULabel is an example of a control that works with this binding.

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 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_AUTOSUBMIT, ATTR_CATEGORY, ATTR_DISPLAY_HEIGHT, ATTR_DISPLAY_HINT, ATTR_DISPLAY_WIDTH, ATTR_FIELD_ORDER, ATTR_FORMAT, ATTR_FORMATS, ATTR_HINTS, ATTR_INPUT_VALUE, ATTR_LABEL, ATTR_LABELS, ATTR_LABELSET, ATTR_MANDATORY, ATTR_PATH, ATTR_TOOLTIP, ATTR_UPDATEABLE, ATTR_VIEWABLE, DATACHANGE_EVENT_POLICY, EMPTY_STRING, GET_ALLOWS, mAttrs, 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, 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	JULabelBinding()
	JULabelBinding(javax.swing.JLabel control, JUIteratorBinding iterBinding, java.lang.String attrName)

Method Summary

Methods

Modifier and Type	Method and Description
void	addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons) *** For internal framework use only ***
static JULabelBinding	createAttributeBinding(JUFormBinding formBinding, javax.swing.JLabel control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName) This method is used by the JDeveloper design time wizards for binding a label with an attribute of rows of a ViewObject/RowIterator.
java.lang.Object	getControlModel(java.lang.Object control) Get the associated control model.
static JULabelBinding	getInstance(JUFormBinding formBinding, javax.swing.JLabel control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName) Deprecated. since JDeveloper 9.0.2, use createAttributeBinding instead
java.lang.Object	getValueAt(int attrIndex) Gets the value from the control for the attribute at the given index.
void	setDataValueAt(java.lang.Object value, int attrIndex)
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	updateValuesFromRow(Row row) Makes sure that labels are not turned into disabled if the attribute is marked readonly.

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

createAttributeBinding, isControlQueriable, refreshControl, setControlEnabled, toString, updateValuesFromRows

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

addBindingContainerChangeListenerForCtxEvent, addDataChangeListener, clearAttrDefs, clearEventsCache, compareAndSetAttribute, createAndNotifyDCE, createEventProducer, displayInShortForm, ensureVariableManager, eventForMyRow, fetchAttrDefs, findAttributeDef, generateDCE, getAttribute, getAttribute, getAttribute, getAttributeCount, getAttributeDef, getAttributeDef, getAttributeDefs, getAttributeDefsForRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeIndexOf, getAttributeNames, getAttributes, getAttributes, getAttributeUIHelper, getAttributeValidators, getAttributeValidators, getAttributeValue, getAttributeValue, getAttributeValueFromRow, getAttributeValues, getAttributeValues, getAttrViewExpressions, getBindingHint, getCachedEvents, getCategory, getChangeEventPolicy, getColumnNameForQuery, getControlType, getDataChangeEventPolicy, getDataChangeListener, getDisplayHeight, getDisplayHint, getDisplayWidth, getError, getErrors, getEventProducer, getFieldOrder, getFormat, getFormats, getFormattedAttributeValue, getHint, getHint, getHints, getInputErrorsForRowKey, getInputValue, getInputValue, getInputValueHandler, getInputValueInRow, getInputValueOnError, getIteratorBindingForDCE, getIteratorRenderHint, getLabel, getLabel, getLabels, getLabelSet, getLastEventId, getLocaleContext, getMasterKeyPathForDCE, getMergedAttributeValues, getNullValueString, getPath, getPermissionDef, getPermissionHolder, getPermissionInfo, getSelectionDef, getState, getTooltip, getTooltip, hasEventProducer, hasFormatInformation, hasServerBindingChanged, hasVariables, initResources, internalGet, internalGetDataControlReference, internalGetRow, internalHasPermission, internalHasPermission, isArrayIteratorType, isAttributeMandatory, isAttributeUpdateable, isAttributeUpdateable, isAttributeUpdateable, isAttributeUpdateable, isAutoSubmit, isEventsCachingEnabled, isMandatory, isNewInputValue, isNullInsertKeyPathForDCE, isPushDataChangeEvents, isPushOrPollDataChangeEvents, isUpdateable, isViewable, lookupAttributeDef, notifyDataChangeEvent, notifyDataExceptionEvent, notifyDCE, pinDataControl, processInputException, processNewInputValue, put, release, removeAttrName, removeDataChangeListener, removeFromDCExceptions, resetAttributeDefs, resetInputState, resolvePath, restoreFromState, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeNames, setAttributes, setAttributeValue, setAttributeValuesInRow, setAttrViewExpressions, setDef, setError, setEventProducer, setEventsCaching, setInputValue, setInputValue, setInputValueHandler, setInputValueInRow, setIteratorBinding, setListener, setNullValueString, startEvents, stopEditing, stopEvents, updateNavigated, updateRangeScrolled, updateRow, updateRowDeleted, updateRowInserted, useRowSpecificHints, validateInputValue

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

getCurrentRow, getFormBinding, getIteratorBinding, reportException, setFormBinding

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

addToDCExceptions, evaluateBooleanExpression, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getAttributeListener, getBindingContainer, getControl, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getPermission, getPermissionTargetName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewableExpr, getViewObject, hasAttributeListener, hashCode, internalGetDataControl, internalSetName, isAssociatedWithDataControl, isControlViewable, isReleased, needsEstimatedRowCount, release, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setDataControlPinned, setListener, setName, setViewableExpr

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.adf.model.AttributeBinding

getErrors, getInputValue, getLabel, isUpdateable, processNewInputValue, setInputValue, validateInputValue

Methods inherited from interface oracle.adf.model.ControlBinding

release, setListener

Methods inherited from interface oracle.binding.ControlBinding

getName, getPath, release, resolvePath, setListener

Methods inherited from interface oracle.jbo.StructureDef

getDefFullName, getDefName, getFullName, getName

Constructor Detail

JULabelBinding

protected JULabelBinding()

JULabelBinding

public JULabelBinding(javax.swing.JLabel control,
              JUIteratorBinding iterBinding,
              java.lang.String attrName)

Method Detail

getControlModel

public java.lang.Object getControlModel(java.lang.Object control)

Get the associated control model. Also set the control as the control that this binding object works with.

Overrides:

getControlModel in class DCControlBinding

addControlToPanel

public void addControlToPanel(java.lang.Object panel,
                     java.lang.Object layoutObject,
                     java.lang.Object layoutCons)

*** For internal framework use only ***

Overrides:

addControlToPanel in class JUCtrlAttrsBinding

getValueAt

public java.lang.Object getValueAt(int attrIndex)

Description copied from class: JUCtrlAttrsBinding

Gets the value from the control for the attribute at the given index. (The index is calculated from the list of attributes this control binding is bound to as passed in the constructor). Framework uses this method to get the attribute value from the control and pass it on to the Row object on the BC4J side.

Overrides:

getValueAt in class JUCtrlAttrsBinding

setValueAt

public void setValueAt(java.lang.Object value,
              int attrIndex)

Description copied from class: JUCtrlAttrsBinding

Updates the control/control-binding with the latest value of the attribute at the given index with the given value. This method is used by the framework to update the control with attribute values from a BC4J row.

Overrides:

setValueAt in class JUCtrlAttrsBinding

setDataValueAt

public void setDataValueAt(java.lang.Object value,
                  int attrIndex)

Overrides:

setDataValueAt in class JUCtrlAttrsBinding

updateValuesFromRow

public void updateValuesFromRow(Row row)

Makes sure that labels are not turned into disabled if the attribute is marked readonly. This method resets the control to it's existing enabled state.

Overrides:

updateValuesFromRow in class JUCtrlAttrsBinding

createAttributeBinding

public static JULabelBinding createAttributeBinding(JUFormBinding formBinding,
                                    javax.swing.JLabel control,
                                    java.lang.String voInstanceName,
                                    java.lang.String voIterName,
                                    java.lang.String voIterBindingName,
                                    java.lang.String attrName)

This method is used by the JDeveloper design time wizards for binding a label with an attribute of rows of a ViewObject/RowIterator. This method calls JUFormBinding.getRowIterBinding to get the iterator binding using the given parameters and then registers a new JUTextFieldBinding with the iterator binding object so as to display/edit the current row's attribute of the given name.

Parameters:

formBinding - The containing JUPanelBinding in which the given iterator binding would be found/created.

control - The control instance to bind to a ViewObject's attribute.

voInstanceName - Name of the instance of the ViewObject in a BC4J ApplicationModule.

voIterName - Runtime instance name of the iterator in the ViewObject (optional).

voIterBindingName - Instance name of the iterator binding that uniquely identifies an iterator binding object used to read/write data in this given JUPanelBinding instance.

attrName - The name of the attribute of this ViewObject rows that contain data to display/edit in the associated text control.

Returns:

JULabelBinding An instance of control binding that works with the given label.

getInstance

public static JULabelBinding getInstance(JUFormBinding formBinding,
                         javax.swing.JLabel control,
                         java.lang.String voInstanceName,
                         java.lang.String voIterName,
                         java.lang.String voIterBindingName,
                         java.lang.String attrName)

Deprecated. since JDeveloper 9.0.2, use createAttributeBinding instead