oracle.jbo.server
Class ListBinding

java.lang.Object
  oracle.jbo.common.AbstractListBinding
      oracle.jbo.server.ListBinding

All Implemented Interfaces:

java.util.EventListener, RowSetManagementListener

public class ListBinding
extends AbstractListBinding
implements RowSetManagementListener

Field Summary

Fields inherited from class oracle.jbo.common.AbstractListBinding

INTERNAL_LOV_VCR_QUERY_CHANGED, INTERNAL_LOV_VCR_SUFFIX, LIST_ADD_NULL_AT_END, LIST_ADD_NULL_AT_START, LIST_ADD_NULL_NOWHERE, LIST_ADD_NULL_UNINIT, LIST_OPER_NAVIGATE, LIST_OPER_SET_ATTRIBUTE, mFirstDisplayAttr, mNullValueFlag, mSingleAttrList, mValueList

Constructor Summary

ListBinding(ListBindingDef def, StructureDef component, RowSetIterator listIter)

Method Summary

protected boolean	forceFilterListExecute(java.util.Map valuesMap) For subclasses to consult appropriate row class on whether the list binding rowset needs to be re-executed on every value change.
ListBindingDef	getDef()
protected java.lang.Object[]	getDrivingValues(Row row)
protected java.lang.Object[]	getDrivingValues(Row row, java.util.Map attrNameValues)
RowSetIterator	getListRSI()
RowSetIterator	getPreferredListRSI(java.lang.String prefCrName)
protected Row	getRowForVariableEvaluation(Row curRow)
protected void	handleListBindingMismatch(Row row, java.util.Map valuesMap, RowIterator listRSI)
void	iteratorClosed(RowSetManagementEvent event) Invoked when the row set is closed.
void	iteratorReset(RowSetManagementEvent event) Invoked when the row set is reset.
void	setListRSI(RowSetIterator listIter)
protected boolean	skipFilterListOnKeyAttributes(java.util.Map valuesMap) For subclasses to consult appropriate row class on whether the entries in valuesMap are key attributes and if their values are null, should filterList perform any filtering or just return the existing list rowsetiterator as is.

Methods inherited from class oracle.jbo.common.AbstractListBinding

autoClear, filterList, filterList, filterList, filterList, filterListWithCaseSensitiveCheck, isApplyNecessary, isInited, resetCriteria, setTargetAttrsFromLovRow

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ListBinding

public ListBinding(ListBindingDef def,
                   StructureDef component,
                   RowSetIterator listIter)

Method Detail

handleListBindingMismatch

protected void handleListBindingMismatch(Row row,
                                         java.util.Map valuesMap,
                                         RowIterator listRSI)

Specified by:

handleListBindingMismatch in class AbstractListBinding

getPreferredListRSI

public RowSetIterator getPreferredListRSI(java.lang.String prefCrName)

getListRSI

public RowSetIterator getListRSI()

Overrides:

getListRSI in class AbstractListBinding

setListRSI

public void setListRSI(RowSetIterator listIter)

Overrides:

setListRSI in class AbstractListBinding

getDef

public ListBindingDef getDef()

Overrides:

getDef in class AbstractListBinding

getDrivingValues

protected java.lang.Object[] getDrivingValues(Row row)

Overrides:

getDrivingValues in class AbstractListBinding

getDrivingValues

protected java.lang.Object[] getDrivingValues(Row row,
                                              java.util.Map attrNameValues)

Overrides:

getDrivingValues in class AbstractListBinding

getRowForVariableEvaluation

protected Row getRowForVariableEvaluation(Row curRow)

Overrides:

getRowForVariableEvaluation in class AbstractListBinding

iteratorReset

public void iteratorReset(RowSetManagementEvent event)

Description copied from interface: RowSetManagementListener

Invoked when the row set is reset.

Specified by:

iteratorReset in interface RowSetManagementListener

Parameters:

event - a description of the event.

iteratorClosed

public void iteratorClosed(RowSetManagementEvent event)

Description copied from interface: RowSetManagementListener

Invoked when the row set is closed.

Specified by:

iteratorClosed in interface RowSetManagementListener

Parameters:

event - a description of the event.

skipFilterListOnKeyAttributes

protected boolean skipFilterListOnKeyAttributes(java.util.Map valuesMap)

Description copied from class: AbstractListBinding

For subclasses to consult appropriate row class on whether the entries in valuesMap are key attributes and if their values are null, should filterList perform any filtering or just return the existing list rowsetiterator as is.

Overrides:

skipFilterListOnKeyAttributes in class AbstractListBinding

Parameters:

valuesMap - given a map of attribute names and values that they map to, shorten the data that this list is exposing.

Returns:

true if the list rowset needs to skip executing the list rowset for change the values

forceFilterListExecute

protected boolean forceFilterListExecute(java.util.Map valuesMap)

Description copied from class: AbstractListBinding

For subclasses to consult appropriate row class on whether the list binding rowset needs to be re-executed on every value change. By default list binding rowset execute is skipped if there is no value change.

Overrides:

forceFilterListExecute in class AbstractListBinding

Parameters:

valuesMap - given a map of attribute names and values that they map to, shorten the data that this list is exposing.

Returns:

true if the list rowset needs to be re-executed even when there is no change in filter values.