oracle.jbo.uicli.binding
Class JUCtrlHierNodeBinding

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

All Implemented Interfaces:

JUCtrlInputValueHandler, java.util.Map, StructureDef

Direct Known Subclasses:

JUTreeNodeBinding

public class JUCtrlHierNodeBinding

extends JUCtrlValueBinding

Nested Class Summary

Nested classes inherited from class java.util.Map

java.util.Map.Entry

Field Summary

static java.lang.String	ATTR_CHILDREN
static java.lang.String	ATTR_HIER_BINDING
static java.lang.String	ATTR_HIER_TYPE
static java.lang.String	ATTR_PARENT
static java.lang.String	ATTR_PROMPT
static java.lang.String	ATTR_RANGE_SET
static java.lang.String	ATTR_ROW_KEY
protected DCIteratorBinding	mChildIterBinding
protected java.util.ArrayList	mChildren
protected boolean	mExpandable
protected JUCtrlHierBinding	mHierBinding
protected java.lang.Object	mNodeValue
protected JUCtrlHierNodeBinding	mParentNode
protected Key	mRowKey
protected JUCtrlHierTypeBinding	mTypeBinding

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_PATH, 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

JUCtrlHierNodeBinding(JUCtrlHierBinding hierBinding, JUCtrlHierNodeBinding parent, JUIteratorBinding iterBinding, JUCtrlHierTypeBinding typeBinding, Row row, boolean expandable)

Method Summary

void	addChild(JUCtrlHierNodeBinding child)
void	addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons) *** For internal framework use only ***
void	executeQueryIfNeeded() Execute the query for the RowIterator that this row is associated with if it is not already executed.
protected JUCtrlHierNodeBinding	findChildNode(Key key)
protected JUCtrlHierNodeBinding	findMatchingNode(Key key)
DCIteratorBinding	getChildIteratorBinding()
java.util.ArrayList	getChildren()
JUCtrlHierBinding	getHierBinding()
JUCtrlHierTypeBinding	getHierTypeBinding() Returns the type binding that governs the display of this node.
java.util.ArrayList	getKeyPath()
JUCtrlHierNodeBinding	getParent()
RowSetIterator	getParentRowSetIterator() Returns the RowSetIterator that this node's row is part of.
Key	getRowKey() Returns the Key object that identifies the row that this node is displaying.
protected java.lang.Object	internalGet(java.lang.String key) Subclasses should override this to handle a specific key.
protected Row	internalGetRow()
protected boolean	isAutoSyncEnabled()
void	myUpdateValuesFromRows(Row[] rows, boolean clear) Updates the child nodes that this node contains after optionally clearing out all the currently displayed children based on the clear flag.
void	refreshControl() *** For internal framework use only ***
boolean	removeChild(JUCtrlHierNodeBinding child)
void	setAutoSyncEnabled(boolean flag) Advanced method: Applications should not use this method unless in batchmode and control the sync() calls to middletier.
void	setValueAt(java.lang.Object value, int rowIndex, int attrIndex)
java.lang.String	toString() Renders the attribute value that this node is supposed to show.
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	updateRowDeleted(DeleteEvent event) Removes a child node that displays the deleted row from amongst this node's children.
void	updateRowInserted(InsertEvent event) Update the display by adding a node to render the inserted row as this node's child.
void	updateValuesFromRow(Row row) Finds the child node that displays this row and updates its display.
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.

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

compareAndSetAttribute, displayInShortForm, findAttributeDef, getAttribute, getAttribute, getAttribute, getAttributeCount, getAttributeDef, getAttributeDef, getAttributeDefs, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeIndexOf, getAttributeNames, getAttributes, getAttributes, getAttributeUIHelper, getAttributeValidators, getAttributeValidators, getAttributeValue, getAttributeValue, getAttributeValueFromRow, getAttributeValues, getAttributeValues, getControlType, getDisplayHeight, getDisplayHint, getDisplayWidth, getError, getErrors, getHint, getHint, getInputValue, getLabel, getLabel, getLabels, getLabelSet, getLocaleContext, getMergedAttributeValues, getPath, getTooltip, getTooltip, hasFormatInformation, isArrayIteratorType, isAttributeMandatory, isAttributeUpdateable, isMandatory, isNewInputValue, isUpdateable, lookupAttributeDef, processInputException, processNewInputValue, put, release, resetInputState, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeValue, setError, setInputValue, setInputValue, setInputValueHandler, stopEditing

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

getFormBinding, getIteratorBinding, reportException, setFormBinding

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

addToDCExceptions, executeQuery, get, getAllRowsInRange, getApplicationModule, getBindingContainer, getControl, getControlModel, getCurrentRow, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, hashCode, internalSetName, isControlQueriable, 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

mTypeBinding

protected JUCtrlHierTypeBinding mTypeBinding

mHierBinding

protected JUCtrlHierBinding mHierBinding

mParentNode

protected JUCtrlHierNodeBinding mParentNode

mChildIterBinding

protected DCIteratorBinding mChildIterBinding

mNodeValue

protected java.lang.Object mNodeValue

mRowKey

protected Key mRowKey

mExpandable

protected boolean mExpandable

mChildren

protected java.util.ArrayList mChildren

ATTR_HIER_TYPE

public static final java.lang.String ATTR_HIER_TYPE

See Also:

Constant Field Values

ATTR_CHILDREN

public static final java.lang.String ATTR_CHILDREN

See Also:

Constant Field Values

ATTR_PARENT

public static final java.lang.String ATTR_PARENT

See Also:

Constant Field Values

ATTR_ROW_KEY

public static final java.lang.String ATTR_ROW_KEY

See Also:

Constant Field Values

ATTR_PROMPT

public static final java.lang.String ATTR_PROMPT

See Also:

Constant Field Values

ATTR_RANGE_SET

public static final java.lang.String ATTR_RANGE_SET

See Also:

Constant Field Values

ATTR_HIER_BINDING

public static final java.lang.String ATTR_HIER_BINDING

See Also:

Constant Field Values

Constructor Detail

JUCtrlHierNodeBinding

public JUCtrlHierNodeBinding(JUCtrlHierBinding hierBinding,
                             JUCtrlHierNodeBinding parent,
                             JUIteratorBinding iterBinding,
                             JUCtrlHierTypeBinding typeBinding,
                             Row row,
                             boolean expandable)

Method Detail

getHierBinding

public JUCtrlHierBinding getHierBinding()

getParent

public JUCtrlHierNodeBinding getParent()

getRowKey

public Key getRowKey()

Returns the Key object that identifies the row that this node is displaying.

getChildIteratorBinding

public DCIteratorBinding getChildIteratorBinding()

isAutoSyncEnabled

protected boolean isAutoSyncEnabled()

setAutoSyncEnabled

public void setAutoSyncEnabled(boolean flag)

Advanced method: Applications should not use this method unless in batchmode and control the sync() calls to middletier.

Reset this flag if the tree node should not force a DataControl.sync() call to force fetching of data for this node. This method should be used in batch mode when the Tree is viewed in a thin-client and the application wants to control when to perform sync.

executeQueryIfNeeded

public void executeQueryIfNeeded()

Execute the query for the RowIterator that this row is associated with if it is not already executed.

Overrides:

executeQueryIfNeeded in class DCControlBinding

getChildren

public java.util.ArrayList getChildren()

addChild

public void addChild(JUCtrlHierNodeBinding child)

removeChild

public boolean removeChild(JUCtrlHierNodeBinding child)

findChildNode

protected JUCtrlHierNodeBinding findChildNode(Key key)

findMatchingNode

protected JUCtrlHierNodeBinding findMatchingNode(Key key)

updateRowInserted

public void updateRowInserted(InsertEvent event)

Update the display by adding a node to render the inserted row as this node's child.

Overrides:

updateRowInserted in class JUCtrlValueBinding

updateRowDeleted

public void updateRowDeleted(DeleteEvent event)

Removes a child node that displays the deleted row from amongst this node's children.

Overrides:

updateRowDeleted in class JUCtrlValueBinding

updateValuesFromRow

public void updateValuesFromRow(Row row)

Finds the child node that displays this row and updates its display.

Overrides:

updateValuesFromRow in class JUCtrlValueBinding

updateValuesFromRows

public void updateValuesFromRows(Row[] rows,
                                 boolean clear)

Description copied from class: JUCtrlValueBinding

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.

Specified by:

updateValuesFromRows in class JUCtrlValueBinding

myUpdateValuesFromRows

public void myUpdateValuesFromRows(Row[] rows,
                                   boolean clear)

Updates the child nodes that this node contains after optionally clearing out all the currently displayed children based on the clear flag.

This method determines the rules to associate with each row in the given array of rows.

toString

public java.lang.String toString()

Renders the attribute value that this node is supposed to show. This method is used by JTree to display the String for a node in the tree.

Overrides:

toString in class DCControlBinding

getParentRowSetIterator

public RowSetIterator getParentRowSetIterator()

Returns the RowSetIterator that this node's row is part of.

getHierTypeBinding

public final JUCtrlHierTypeBinding getHierTypeBinding()

Returns the type binding that governs the display of this node. The returned object can be used to find out the name of the attribute that this node displays and the accessor that this row will expand (if any).

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:

children - returns getChildren()

rowKey - returns getRowKey()

hierType - returns getHierTypeBinding()

parent - returns getParent()

Overrides:

internalGet in class JUCtrlValueBinding

internalGetRow

protected Row internalGetRow()

Overrides:

internalGetRow in class JUCtrlValueBinding

refreshControl

public void refreshControl()

*** For internal framework use only ***

Updates the values in a control that is bound using an Iterator already in use. (a valid row iterator) If you do not call this method, your control won't update unless you refresh the Iterator.

Specified by:

refreshControl in class DCControlBinding

updateNavigated

public void updateNavigated(NavigationEvent event)

Description copied from class: JUCtrlValueBinding

Update the current row display as the currency has navigated in the iterator with which this control binding is working.

Specified by:

updateNavigated in class JUCtrlValueBinding

updateRangeScrolled

public void updateRangeScrolled(ScrollEvent event)

Description copied from class: JUCtrlValueBinding

Update the control display based on whether the rows of data has scrolled.

Specified by:

updateRangeScrolled in class JUCtrlValueBinding

See Also:

ScrollEvent

addControlToPanel

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

Description copied from class: JUControlBinding

*** For internal framework use only ***

Specified by:

addControlToPanel in class JUControlBinding

setValueAt

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

getKeyPath

public java.util.ArrayList getKeyPath()