Skip navigation links

oracle.jbo.common
Class AbstractListBinding

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

Direct Known Subclasses:

ListBinding, ListBinding

public abstract class AbstractListBinding

extends java.lang.Object

Field Summary

static java.lang.String	INTERNAL_LOV_VCR_QUERY_CHANGED
static java.lang.String	INTERNAL_LOV_VCR_SUFFIX
static int	LIST_ADD_NULL_AT_END
static int	LIST_ADD_NULL_AT_START
static int	LIST_ADD_NULL_NOWHERE
static int	LIST_ADD_NULL_UNINIT
static int	LIST_OPER_NAVIGATE Indicates that list binding will be used to navigate Rows in a RowIterator.
static int	LIST_OPER_SET_ATTRIBUTE Indicates this list binding will be used to update attributes in a target ViewObject.
protected AttributeDef	mFirstDisplayAttr
protected int	mNullValueFlag
protected boolean	mSingleAttrList
protected java.lang.Object[]	mValueList

Constructor Summary

AbstractListBinding(ListBindingDef def, StructureDef component, RowSetIterator listIter)

Method Summary

void	autoClear(Row curRow)
RowSetIterator	filterList(java.util.Map valuesMap, Row curRow, ViewCriteria vc) Advanced internal method.
RowSetIterator	filterList(java.util.Map valuesMap, Row curRow, ViewCriteria vc, java.util.ArrayList varvals) Deprecated. use filterList(Map, Row, ViewCriteria, ArrayList, boolean)
RowSetIterator	filterList(java.util.Map valuesMap, Row curRow, ViewCriteria vc, java.util.ArrayList varvals, boolean exactMatch) Advanced internal method.
RowSetIterator	filterList(java.util.Map valuesMap, Row curRow, ViewCriteria vc, java.util.ArrayList varvals, java.util.Map attrNameValues, boolean exactMatch) * Advanced internal method.
protected RowSetIterator	filterListWithCaseSensitiveCheck(java.util.Map valuesMap, Row curRow, ViewCriteria vc, java.util.ArrayList varvals, java.util.Map attrNameValues, boolean exactMatch, boolean checkForCase) * Advanced internal method.
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()
protected Row	getRowForVariableEvaluation(Row curRow)
protected abstract void	handleListBindingMismatch(Row row, java.util.Map valuesMap, RowIterator listRSI)
boolean	isApplyNecessary(java.util.Map map)
void	resetCriteria()
void	setListRSI(RowSetIterator rsi)
protected void	setTargetAttrsFromLovRow(Row targetRow, Row lovRow)
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 java.lang.Object

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

Field Detail

LIST_OPER_SET_ATTRIBUTE

public static int LIST_OPER_SET_ATTRIBUTE

Indicates this list binding will be used to update attributes in a target ViewObject. This is the default mode

LIST_OPER_NAVIGATE

public static int LIST_OPER_NAVIGATE

Indicates that list binding will be used to navigate Rows in a RowIterator.

mSingleAttrList

protected boolean mSingleAttrList

LIST_ADD_NULL_UNINIT

public static final int LIST_ADD_NULL_UNINIT

See Also:

Constant Field Values

LIST_ADD_NULL_NOWHERE

public static final int LIST_ADD_NULL_NOWHERE

See Also:

Constant Field Values

LIST_ADD_NULL_AT_START

public static final int LIST_ADD_NULL_AT_START

See Also:

Constant Field Values

LIST_ADD_NULL_AT_END

public static final int LIST_ADD_NULL_AT_END

See Also:

Constant Field Values

mNullValueFlag

protected int mNullValueFlag

mValueList

protected java.lang.Object[] mValueList

INTERNAL_LOV_VCR_SUFFIX

public static final java.lang.String INTERNAL_LOV_VCR_SUFFIX

See Also:

Constant Field Values

INTERNAL_LOV_VCR_QUERY_CHANGED

public static final java.lang.String INTERNAL_LOV_VCR_QUERY_CHANGED

See Also:

Constant Field Values

mFirstDisplayAttr

protected AttributeDef mFirstDisplayAttr

Constructor Detail

AbstractListBinding

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

Method Detail

isApplyNecessary

public boolean isApplyNecessary(java.util.Map map)

resetCriteria

public void resetCriteria()

getListRSI

public RowSetIterator getListRSI()

setListRSI

public void setListRSI(RowSetIterator rsi)

getDef

public ListBindingDef getDef()

getDrivingValues

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

getDrivingValues

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

setTargetAttrsFromLovRow

protected void setTargetAttrsFromLovRow(Row targetRow,
                                        Row lovRow)

filterList

public RowSetIterator filterList(java.util.Map valuesMap,
                                 Row curRow,
                                 ViewCriteria vc)

Advanced internal method.

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

This method establishes a new ViewCriteria on the collection that the list source iterator binding is bound to. Looks up values from the given map based on the Attribute names in the associated list source collection and sets the corresponding values on a new ViewCriteria row that is added to the ViewCriteria and then applied on the collection to filter the collection.

If the filtered list has only one row then that row is assumed as the selected row and list selection index is set to that row.

filterList

public RowSetIterator filterList(java.util.Map valuesMap,
                                 Row curRow,
                                 ViewCriteria vc,
                                 java.util.ArrayList varvals)

Deprecated. use filterList(Map, Row, ViewCriteria, ArrayList, boolean)

Advanced internal method...may be removed in a future release.

filterList

public RowSetIterator filterList(java.util.Map valuesMap,
                                 Row curRow,
                                 ViewCriteria vc,
                                 java.util.ArrayList varvals,
                                 boolean exactMatch)

Advanced internal method.

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

This method establishes a new ViewCriteria on the collection that the list source iterator binding is bound to. Looks up values from the given map based on the Attribute names in the associated list source collection and sets the corresponding values on a new ViewCriteria row that is added to the ViewCriteria based on exactMatch flag and then applied on the collection to filter the collection.

If the filtered list has only one row then that row is assumed as the selected row and list selection index is set to that row.

If exactMatch flag is not on, then each value is appended with a wildChar for LIKE kind of queries to get all possible choices.

filterList

public RowSetIterator filterList(java.util.Map valuesMap,
                                 Row curRow,
                                 ViewCriteria vc,
                                 java.util.ArrayList varvals,
                                 java.util.Map attrNameValues,
                                 boolean exactMatch)

* Advanced internal method.

filterListWithCaseSensitiveCheck

protected RowSetIterator filterListWithCaseSensitiveCheck(java.util.Map valuesMap,
                                                          Row curRow,
                                                          ViewCriteria vc,
                                                          java.util.ArrayList varvals,
                                                          java.util.Map attrNameValues,
                                                          boolean exactMatch,
                                                          boolean checkForCase)

* Advanced internal method.

getRowForVariableEvaluation

protected Row getRowForVariableEvaluation(Row curRow)

skipFilterListOnKeyAttributes

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.

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)

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.

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.

autoClear

public void autoClear(Row curRow)

handleListBindingMismatch

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

Skip navigation links