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, JUCtrlValueHandler, 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_ROW
static java.lang.String	ATTR_ROW_DATA_PROVIDER
static java.lang.String	ATTR_ROW_KEY
protected DCIteratorBinding	mChildIterBinding *** For internal framework use only ***
protected java.util.ArrayList	mChildren *** For internal framework use only ***
protected boolean	mExpandable *** For internal framework use only ***
protected JUCtrlHierBinding	mHierBinding *** For internal framework use only ***
protected java.lang.Object	mNodeValue *** For internal framework use only ***
protected JUCtrlHierNodeBinding	mParentNode *** For internal framework use only ***
protected Key	mRowKey *** For internal framework use only ***
protected JUCtrlHierTypeBinding	mTypeBinding *** For internal framework use only ***

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_HEIGHT, ATTR_DISPLAY_HINT, ATTR_DISPLAY_WIDTH, ATTR_FORMAT, ATTR_FORMATS, ATTR_INPUT_VALUE, ATTR_LABEL, ATTR_LABELS, ATTR_LABELSET, ATTR_MANDATORY, ATTR_PATH, ATTR_TOOLTIP, ATTR_UPDATEABLE, ATTR_VIEWABLE, 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, mAttributeListener, 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()
java.util.ArrayList	getChildren(java.lang.String accName) *** For internal framework use only *** Return a list of children nodes from an accessor child with the matching accessor name (accName) when this node expands into a multiple accessor nodes.
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.
Row	getRow()
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() Internal: Applications should not use this method.
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 ***
void	release(int flags)
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.
protected void	setupAccessors(Row row)
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, ensureVariableManager, 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, getFormat, getFormats, getHint, getHint, getInputErrorsForRowKey, getInputValue, getInputValue, getInputValueHandler, getInputValueInRow, getLabel, getLabel, getLabels, getLabelSet, getLocaleContext, getMergedAttributeValues, getNullValueString, getPath, getTooltip, getTooltip, hasFormatInformation, hasVariables, initResources, internalHasPermission, isArrayIteratorType, isAttributeMandatory, isAttributeUpdateable, isAttributeUpdateable, isMandatory, isNewInputValue, isUpdateable, lookupAttributeDef, processInputException, processNewInputValue, put, resetInputState, resolvePath, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeValue, setError, setInputValue, setInputValue, setInputValueHandler, setInputValueInRow, setNullValueString, stopEditing, 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, executeQuery, get, getAllRowsInRange, getApplicationModule, getBindingContainer, getControl, getControlModel, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, hashCode, internalHasPermission, internalSetName, isControlQueriable, needsEstimatedRowCount, removeFromDCExceptions, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setListener, setListener, setName

Methods inherited from class oracle.jbo.common.JboAbstractMap

entrySet, equals, internalPut

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

*** For internal framework use only ***

mHierBinding

protected JUCtrlHierBinding mHierBinding

*** For internal framework use only ***

mParentNode

protected JUCtrlHierNodeBinding mParentNode

*** For internal framework use only ***

mChildIterBinding

protected DCIteratorBinding mChildIterBinding

*** For internal framework use only ***

mNodeValue

protected java.lang.Object mNodeValue

*** For internal framework use only ***

mRowKey

protected Key mRowKey

*** For internal framework use only ***

mExpandable

protected boolean mExpandable

*** For internal framework use only ***

mChildren

protected java.util.ArrayList mChildren

*** For internal framework use only ***

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_HIER_BINDING

public static final java.lang.String ATTR_HIER_BINDING

See Also:

Constant Field Values

ATTR_ROW

public static final java.lang.String ATTR_ROW

See Also:

Constant Field Values

ATTR_ROW_DATA_PROVIDER

public static final java.lang.String ATTR_ROW_DATA_PROVIDER

See Also:

Constant Field Values

Constructor Detail

JUCtrlHierNodeBinding

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

Method Detail

release

public void release(int flags)

Overrides:

release in class JUCtrlValueBinding

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(java.lang.String accName)

*** For internal framework use only *** Return a list of children nodes from an accessor child with the matching accessor name (accName) when this node expands into a multiple accessor nodes.

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.

setupAccessors

protected void setupAccessors(Row row)

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). else if (ATTR_ROW_KEY == key) { mInternalGet_KeyResolved = true; return getRowKey(); }

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:

• prompt - returns get the value that this node displays()
• children - returns getChildren()
• rowKey - returns getRowKey()
• hierType - returns getHierTypeBinding()
• hierBinding - returns getHierBinding()
• row - returns getRow()
• parent - returns getParent()

• Overrides:

  internalGet in class JUCtrlValueBinding

getRow

public Row getRow()

internalGetRow

protected Row internalGetRow()

Description copied from class: JUCtrlValueBinding

Internal: Applications should not use this method.

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