Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 2 (11.1.2.0.0)

E17483-01

oracle.jbo.common
Class AbstractListBinding

java.lang.Object
  extended by 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
protected AbstractListBinding(ListBindingDef def, StructureDef component)
           
  AbstractListBinding(ListBindingDef def, StructureDef component, RowSetIterator listIter)
           
 
Method Summary
 void autoClear(Row curRow)
           
protected  RowSetIterator filterAndApplyListWithCaseCheck(java.util.Map valuesMap, Row curRow, ViewCriteria vc, java.util.ArrayList varvals, java.util.Map attrNameValues, boolean exactMatch, boolean checkForCase, boolean ignoreOperSwitchForExc, boolean applyOnMatch)
          Deprecated.  
 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)
          Deprecated. * 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)
          Deprecated. * 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)
          Deprecated. since 11.1.1.5.0 use isFilterApplyNecessary.
 boolean isFilterApplyNecessary(java.util.Map map, boolean match, boolean check)
           
protected  boolean isInited()
           
 void resetCriteria()
           
 void setListRSI(RowSetIterator listIter)
           
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)

AbstractListBinding

protected AbstractListBinding(ListBindingDef def,
                              StructureDef component)
Method Detail

isApplyNecessary

public boolean isApplyNecessary(java.util.Map map)
Deprecated. since 11.1.1.5.0 use isFilterApplyNecessary.


isFilterApplyNecessary

public boolean isFilterApplyNecessary(java.util.Map map,
                                      boolean match,
                                      boolean check)

resetCriteria

public void resetCriteria()

getListRSI

public RowSetIterator getListRSI()

isInited

protected boolean isInited()

setListRSI

public void setListRSI(RowSetIterator listIter)

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)
Deprecated. * 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)
Deprecated. * Advanced internal method.


filterAndApplyListWithCaseCheck

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

* Advanced internal method. No subclasses other than JUCtrlListBinding should use this method. It may be modfied without advanced notice.


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)

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 2 (11.1.2.0.0)

E17483-01

Copyright © 1997, 2011, Oracle. All rights reserved.