Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

oracle.adf.model.binding
Class DCIteratorBinding

java.lang.Object
  extended byoracle.adf.model.binding.DCIteratorBinding
All Implemented Interfaces:
java.util.EventListener, RowNavigationListener, RowSetListener, RowSetManagementListener
Direct Known Subclasses:
JUIteratorBinding

public abstract class DCIteratorBinding
extends java.lang.Object
implements RowSetListener, RowSetManagementListener

DCIteratorBinding is the binding class that interacts with RowIterator objects to iterate over rows and provide the current row(s) for use in a client application or to view via various control bindings. DCIteratorBinding objects are uniquely identified by name in a DCBindingContainer which acts as a container of iterator bindings. This class handles the events generated from the associated RowIterator and sends the current Row (rows in range) over to individual control bindings to display current data. This class also manages the findMode data for the associated iterator and ViewObject(incase of BC4J).

At runtime, an application can bind an instance of oracle.jbo.NavigatableRowIterator to a DCIteratorBinding object using the bindRowSetIterator method.


Field Summary
protected  boolean inExecute
           
protected  ApplicationModule mAM
           
protected  Row mCreatedRowRef
           
protected  DCDataControl mDC
           
protected  int mRangeSize
           
static int RANGESIZE_DO_NOT_OVERRIDE
           
static int RANGESIZE_UNLIMITED
           
 
Constructor Summary
protected DCIteratorBinding()
           
protected DCIteratorBinding(ApplicationModule am, java.lang.String voName, java.lang.String rsiName)
          When the usage only needs one row at a time, use this constructor to create an iterator binding.
protected DCIteratorBinding(ApplicationModule am, java.lang.String voName, java.lang.String rsiName, int rangeSize)
          Use this constructor if a usage needs a specific range size on the associated iterator.
protected DCIteratorBinding(BindingContext ctx, java.lang.String dcName, java.lang.String sourceName, java.lang.String rsiName, int rangeSize)
          Use this constructor if a usage needs a specific range size on the associated iterator.
protected DCIteratorBinding(DCDataControl dc, RowSetIterator rsi)
          When an application has a RowSet it should use this constructor.
protected DCIteratorBinding(DCIteratorBinding iterBinding)
           
 
Method Summary
 void addActionBinding(DCControlBinding bnd)
          Adds the given action control binding object to its list.
 void addValueBinding(DCControlBinding bnd)
          Adds the given control binding object to its list.
 boolean allowsRefreshControl()
           
 void applySortCriteria(SortCriteria[] sortby)
          Sets the sort critiera that will be applied next time when the source for this iteratorBinding is executed.
 void bindRowSetIterator(NavigatableRowIterator iter, boolean initRangeSize)
          Use this method to bind a new instance of RowIterator from a Business Service to this binding.
protected  void cacheCreatedRow(RowSetIterator rsi, Row row)
           
 Key createKey(java.lang.String stringKey)
          Given the key string, convert it to a Key using the associated RowSetIterator's StructureDef.
 void executeQuery()
          Executes the query or the RowSet behind this iterator binding object.
 void executeQueryIfNeeded()
          Executes the query or the RowSet behind this iterator binding object if not already executed.
protected  void fetchAttributeProperties()
           
 java.util.ArrayList getActionBindingList()
          Returns a list of DCCtrlActionBinding objects that are associated with this iterator binding.
 Row[] getAllRowsInRange()
          Returns an array of rows in the current range of the current RowIterator.
 AttributeDef[] getAttributeDefs()
          get all attribute defs for the RSI that this iterator binding is bound to.
 AttributeDef[] getAttributeDefs(java.lang.String[] attrNames)
          return attribute defs for attributes that are named in the given array.
 DCBindingContainer getBindingContainer()
          Return form binding object of this iterator binding's container.
 Row getCurrentRow()
          Returns the current row of the iterator with which this binding object is associated.
 int getCurrentRowIndexInRange()
          Returns current row index in the current Range in the Rowsetiterator
 java.lang.String getCurrentRowKeyString()
          Returns String version of the row key for the current row in the associated iterator.
 DCDataControl getDataControl()
          Helper method to return the DCDataControl from this binding's BindingContainer.
 DCIteratorBindingDef getDef()
          Internal: Applications should not use this method.
 java.lang.String getDisplayName()
          Returns the name of this IteratorBinding.
 JboException getError()
           
 long getEstimatedRowCount()
           
 java.lang.String getIteratorDefName()
           
 RowSetIterator getLovRowSetIterator()
           
 java.lang.String getName()
          Returns the name of this iterator binding.
 NavigatableRowIterator getNavigatableRowIterator()
          Returns the current RowIterator, which can be a data RowSetIterator or a find mode ViewCriteria based on the find mode.
 int getRangeSize()
          Returns current rowsetiterator's range size
 int getRangeStart()
          Returns current rowsetiterator's range start
 Row getRowAtRangeIndex(int rangeIndex)
          Returns the row of given range index.
 RowSetIterator getRowSetIterator()
          Returns the current data RowSetIterator that holds rows with which this iterator binding object and its associated control-bindings are working.
 SortCriteria[] getSortCriteria()
          Returns an ordered array of SortCriteria that will be applied when the source for this iteratorBinding is executed.
 java.lang.String getSourceName()
          Returns the name of the collection instance to which this iterator binding is bound to.
 java.lang.Object getSyncLock()
           
 java.util.ArrayList getValueBindingList()
          Returns a list of DCCtrlValueBinding objects that are associated with this iterator binding.
 ViewCriteria getViewCriteria()
           
 java.lang.String getViewDefName()
          Internal: Applications should not use this method. Returns the name of the ViewDefinition object.
 ViewObject getViewObject()
          Returns the instance of ViewObject of the RowIterator to which this iterator binding is associated.
 java.lang.String getVOName()
          Internal: Applications should not use this method. Returns the name of the ViewObject instance of the iterator to which this iterator binding is associated.
 boolean hasRSI()
          returns true if a RowSetIterator has been bound to this iterator.
protected  DCDataControl initDataControl()
           
protected  RowSetIterator initSourceRSI()
           
 void internalGetNextRangeSet()
           
 void internalGetPreviousRangeSet()
           
 boolean isAccessorIterator()
          Is this bound to a collection returned from a bean accessor?
 boolean isBound()
           
 boolean isFindMode()
          Returns true if this iterator binding is in find mode.
 boolean isFindModeAllowed()
           
 boolean isIteratorMadeVisible()
           
 boolean isRowSetEventsEnabled()
          Returns true if this IteratorBinding should notify the containing BindingContainer's RowSetListeners of RowSet events.
 boolean isSortable()
           
 boolean isSuspendRowSetEventsHandling()
          Returns true if this IteratorBinding is not reacting to any RowSetIterator events.
 void iteratorClosed(RowSetManagementEvent event)
          Resets the internal state of this binding object and marks it as unusable.
 void iteratorReset(RowSetManagementEvent event)
          Notifies rangeRefreshed to all bindings so that they can update their display.
 void navigated(NavigationEvent event)
          Calls updateNavigated() for all DCCtrlRangeBinding instances associated with this iterator binding object, or calls updateValuesFromRow() on all other control binding instances, passing in the current row instance from the RowIterator.
 boolean needsEstimatedRowCount()
           
protected abstract  void notifyUpdateEvent(UpdateEvent event)
          called when rowUpdated event is received from the model.
protected  Row prepareCurrentRow()
           
 void prepareForInput()
          Internal: Applications should not use this method. Called on this binding before a binding returns from processInputValue This gives the iterator binding a chance to mark new row state to STATUS_NEW from initialized and hence submit the new row even if there are no changes on the row.
 void processInputException()
          Deprecated. use processInputException(JboException);
 void processInputException(JboException errExc)
           
 void rangeRefreshed(RangeRefreshEvent event)
          Handles the rangeRefereshed event generated by the current RowIterator.
 void rangeScrolled(ScrollEvent event)
          This method invokes updateRangeScrolled method on all instances of DCCtrlRangeBinding objects associated with this iterator binding, to notify them of the change in current range of rows.
 void release()
           
 void release(int flags)
           
 boolean removeActionBinding(DCControlBinding bnd)
          Removes the given action control binding object from its list.
 void removeCurrentRow()
           
 boolean removeValueBinding(DCControlBinding bnd)
          Removes the given control binding object from its list.
 void reportException(boolean markDead, java.lang.Exception ex)
          Utility method to report exceptions via the containing binding container.
 void resolveRangeSize(int rangeSize)
          Sets this iterator binding and it's associated RowIterator's range size to the greater of this either the iterator's range size and the given range size.
 void rowDeleted(DeleteEvent event)
          If range size of this iterator binding is not 1, this method invokes updateRowDeleted method on all instances of DCCtrlValueBinding objects associated with this iterator binding, to notify them of the newly inserted row.
 void rowInserted(InsertEvent event)
          If range size of this iterator binding is not 1, this method invokes updateRowInserted method on all instances of DCCtrlValueBinding objects associated with this iterator binding, to notify them of the newly inserted row.
 void rowUpdated(UpdateEvent event)
          Invokes updateValuesFromRow() to notify all control bindings of a change in an attribute in the row.
protected  void setAlive(boolean flag)
           
 void setAllowFindMode(boolean flag)
          Advanced Internal This method is for list bindings to mark the source binding to not go into find mode.
 void setBindingContainer(DCBindingContainer formBnd)
           
 void setCurrentRowIndexInRange(int val)
           
 void setCurrentRowWithKey(java.lang.String stringKey)
          Find the row in the associated row iterator based on the Key object and if found set that as the current row.
 void setCurrentRowWithKeyValue(java.lang.String stringKeyValue)
          Find the row in the associated row iterator based on the value for a key attribute and if found set that as the current row.
protected  void setDef(DCIteratorBindingDef def)
          Internal: Applications should not use this method. After creation sets the def used to create this iterator binding.
 void setFindMode(boolean mode)
          Calls setFindMode(boolean mode, boolean applyCriteria) with applyCriteria = true;
 void setFindMode(boolean mode, boolean applyVC)
          Sets this iterator to findMode or not.
protected  void setIteratorMadeVisible(boolean flag)
           
 void setName(java.lang.String name)
          Internal: Applications should not use this method.
 void setRangeSize(int val)
          Set current rowsetiterator's range size
 void setRangeStart(int val)
          Set current rowsetiterator's range start
 void setRowSetEventsEnabled(boolean flag)
          Set this flag if this IteratorBinding should pass on the rowset events to containing BindingContainer's RowSetListeners.
 void suspendRowSetEventsHandling(boolean flag)
          Set this flag to turn off reacting to RowSetIterator events.
protected abstract  void updateValuesFromRow(Row row)
          Calls updateValueFromRow() on each instance of DCCtrlValueBinding objects associated with this iterator binding object.
protected abstract  void updateValuesFromRows(Row[] rows, Row row, boolean clear)
          Calls updateValuesFromRows() on each instance of DCCtrlRangeBinding object associated with this iterator binding object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

mAM

protected ApplicationModule mAM

mRangeSize

protected int mRangeSize

mDC

protected DCDataControl mDC

inExecute

protected boolean inExecute

mCreatedRowRef

protected Row mCreatedRowRef

RANGESIZE_DO_NOT_OVERRIDE

public static int RANGESIZE_DO_NOT_OVERRIDE

RANGESIZE_UNLIMITED

public static int RANGESIZE_UNLIMITED
Constructor Detail

DCIteratorBinding

protected DCIteratorBinding()

DCIteratorBinding

protected DCIteratorBinding(DCIteratorBinding iterBinding)

DCIteratorBinding

protected DCIteratorBinding(BindingContext ctx,
                            java.lang.String dcName,
                            java.lang.String sourceName,
                            java.lang.String rsiName,
                            int rangeSize)
Use this constructor if a usage needs a specific range size on the associated iterator. Objects of type DCCtrlRangeBinding may use this constructor to specify a default range size for the iterator.


DCIteratorBinding

protected DCIteratorBinding(ApplicationModule am,
                            java.lang.String voName,
                            java.lang.String rsiName,
                            int rangeSize)
Use this constructor if a usage needs a specific range size on the associated iterator. Objects of type DCCtrlRangeBinding may use this constructor to specify a default range size for the iterator.


DCIteratorBinding

protected DCIteratorBinding(ApplicationModule am,
                            java.lang.String voName,
                            java.lang.String rsiName)
When the usage only needs one row at a time, use this constructor to create an iterator binding.


DCIteratorBinding

protected DCIteratorBinding(DCDataControl dc,
                            RowSetIterator rsi)
When an application has a RowSet it should use this constructor.

Method Detail

setDef

protected void setDef(DCIteratorBindingDef def)
Internal: Applications should not use this method. After creation sets the def used to create this iterator binding.


getDef

public DCIteratorBindingDef getDef()
Internal: Applications should not use this method.


prepareForInput

public void prepareForInput()
Internal: Applications should not use this method. Called on this binding before a binding returns from processInputValue This gives the iterator binding a chance to mark new row state to STATUS_NEW from initialized and hence submit the new row even if there are no changes on the row.


isAccessorIterator

public boolean isAccessorIterator()
Is this bound to a collection returned from a bean accessor?


getName

public final java.lang.String getName()
Returns the name of this iterator binding. Iterator Binding objects are uniquely identified by name in a DCBindingContainer.


getDisplayName

public final java.lang.String getDisplayName()
Returns the name of this IteratorBinding.


setName

public void setName(java.lang.String name)
Internal: Applications should not use this method.


getVOName

public java.lang.String getVOName()
Internal: Applications should not use this method. Returns the name of the ViewObject instance of the iterator to which this iterator binding is associated.


getSourceName

public java.lang.String getSourceName()
Returns the name of the collection instance to which this iterator binding is bound to.


getViewDefName

public final java.lang.String getViewDefName()
Internal: Applications should not use this method. Returns the name of the ViewDefinition object.


reportException

public void reportException(boolean markDead,
                            java.lang.Exception ex)
Utility method to report exceptions via the containing binding container. If the exception is not JboException, this method creates a JboException that contains the input exception object and passes only JboException to the bindingcontainer. If BindingContainer is null then this method rethrows the JboException.

Parameters:
markDead - if this iterator binding should be marked as not alive for any further usage.
ex - Exception object to be reported via the BindingContainer.

bindRowSetIterator

public void bindRowSetIterator(NavigatableRowIterator iter,
                               boolean initRangeSize)
Use this method to bind a new instance of RowIterator from a Business Service to this binding. This method should be used to display data from a different RowIterator of the same Collection type in a given form. For example, if a tree is used to navigate Departments and their employees, upon selecting an employee node, an application can pass the Employee node's RowIterator over to this iterator binding, to update the display in another panel of Employee data with the currently selected Employee.

This method will not directly update the control-bindings for non-ADFJClient apps. The caller can optionally call navigated(null) method, with null for the Event parameter to notify each control bound to this iterator binding to update it's displayed value with the new iterator's current row.

Parameters:
iter - RowIterator instance from which to display data in bound controls.
initRangeSize - determines whether this iterator's range size should be adjusted to this binding's range size. This should be used to extend the range size from the default in the RowIterator to whatever is required by this iterator binding. For example, if a RowIterator whose range size is 1 is passed to this method and a grid control is bound to this iterator binding, then the grid may need more than one row to display from the current range. So, this flag should be true in that case to allow the grid to get the full range of rows to display, rather than updating its display one row at a time.

isIteratorMadeVisible

public final boolean isIteratorMadeVisible()

setIteratorMadeVisible

protected void setIteratorMadeVisible(boolean flag)

isRowSetEventsEnabled

public final boolean isRowSetEventsEnabled()
Returns true if this IteratorBinding should notify the containing BindingContainer's RowSetListeners of RowSet events.


setRowSetEventsEnabled

public final void setRowSetEventsEnabled(boolean flag)
Set this flag if this IteratorBinding should pass on the rowset events to containing BindingContainer's RowSetListeners. Applications should turn off this flag for IteratorBindings used for readonly purposes like LOVs, etc which do not need any UI overrides like enabling/disabling a control etc.


suspendRowSetEventsHandling

public void suspendRowSetEventsHandling(boolean flag)
Set this flag to turn off reacting to RowSetIterator events. BindingContainer uses this during refreshControl() during batch datacontrol operations. Also when this iterator is released the events-handling may be turned off by using this suspend.


isSuspendRowSetEventsHandling

public boolean isSuspendRowSetEventsHandling()
Returns true if this IteratorBinding is not reacting to any RowSetIterator events.


allowsRefreshControl

public boolean allowsRefreshControl()

prepareCurrentRow

protected Row prepareCurrentRow()

rangeRefreshed

public void rangeRefreshed(RangeRefreshEvent event)
Handles the rangeRefereshed event generated by the current RowIterator. If the range size of this binding is 1, then calls updateValuesFromRow() with the current row as the argument to notify all control bindings associated with this iterator binding of the change in current row. If the range size is not 1, then this method calls updateValuesFromRows() passing in the current range of rows to all DCCtrlRangeBinding control bindings.

Specified by:
rangeRefreshed in interface RowSetListener
Parameters:
event - a description of the new ranges.

rangeScrolled

public void rangeScrolled(ScrollEvent event)
This method invokes updateRangeScrolled method on all instances of DCCtrlRangeBinding objects associated with this iterator binding, to notify them of the change in current range of rows.

Specified by:
rangeScrolled in interface RowSetListener
Parameters:
event - a description of the new range.

rowInserted

public void rowInserted(InsertEvent event)
If range size of this iterator binding is not 1, this method invokes updateRowInserted method on all instances of DCCtrlValueBinding objects associated with this iterator binding, to notify them of the newly inserted row.

Specified by:
rowInserted in interface RowSetListener
Parameters:
event - a description of the new Row object.

internalGetNextRangeSet

public void internalGetNextRangeSet()

internalGetPreviousRangeSet

public void internalGetPreviousRangeSet()

rowDeleted

public void rowDeleted(DeleteEvent event)
If range size of this iterator binding is not 1, this method invokes updateRowDeleted method on all instances of DCCtrlValueBinding objects associated with this iterator binding, to notify them of the newly inserted row.

This method also sets the currency on the RowIterator to the next row (if available) or previous row (if available) or simply a NO row by calling navigated() with no current row.

Specified by:
rowDeleted in interface RowSetListener
Parameters:
event - a description of the deleted Row object.

rowUpdated

public void rowUpdated(UpdateEvent event)
Invokes updateValuesFromRow() to notify all control bindings of a change in an attribute in the row.

Specified by:
rowUpdated in interface RowSetListener
Parameters:
event - a description of the modified Row object.

navigated

public void navigated(NavigationEvent event)
Calls updateNavigated() for all DCCtrlRangeBinding instances associated with this iterator binding object, or calls updateValuesFromRow() on all other control binding instances, passing in the current row instance from the RowIterator.

Specified by:
navigated in interface RowSetListener
Parameters:
event - a description of the new and previous current rows.

notifyUpdateEvent

protected abstract void notifyUpdateEvent(UpdateEvent event)
called when rowUpdated event is received from the model.


updateValuesFromRows

protected abstract void updateValuesFromRows(Row[] rows,
                                             Row row,
                                             boolean clear)
Calls updateValuesFromRows() on each instance of DCCtrlRangeBinding object associated with this iterator binding object. These objects are then responsible for updating their display with the latest set of rows.


updateValuesFromRow

protected abstract void updateValuesFromRow(Row row)
Calls updateValueFromRow() on each instance of DCCtrlValueBinding objects associated with this iterator binding object. These control binding objects are responsible for updating their display with values from the given Row.


getSyncLock

public final java.lang.Object getSyncLock()

iteratorReset

public void iteratorReset(RowSetManagementEvent event)
Notifies rangeRefreshed to all bindings so that they can update their display.

Specified by:
iteratorReset in interface RowSetManagementListener
Parameters:
event - a description of the event.

iteratorClosed

public void iteratorClosed(RowSetManagementEvent event)
Resets the internal state of this binding object and marks it as unusable.

Specified by:
iteratorClosed in interface RowSetManagementListener
Parameters:
event - a description of the event.

getViewCriteria

public ViewCriteria getViewCriteria()

getViewObject

public ViewObject getViewObject()
Returns the instance of ViewObject of the RowIterator to which this iterator binding is associated. Returns null for non-bc4j bound DataControls


resolveRangeSize

public void resolveRangeSize(int rangeSize)
Sets this iterator binding and it's associated RowIterator's range size to the greater of this either the iterator's range size and the given range size. If either is -1, then that takes precedence, so that range size = all rows.


hasRSI

public boolean hasRSI()
returns true if a RowSetIterator has been bound to this iterator.


getRowSetIterator

public RowSetIterator getRowSetIterator()
Returns the current data RowSetIterator that holds rows with which this iterator binding object and its associated control-bindings are working.


initSourceRSI

protected RowSetIterator initSourceRSI()

getNavigatableRowIterator

public NavigatableRowIterator getNavigatableRowIterator()
Returns the current RowIterator, which can be a data RowSetIterator or a find mode ViewCriteria based on the find mode.


setAllowFindMode

public final void setAllowFindMode(boolean flag)
Advanced Internal This method is for list bindings to mark the source binding to not go into find mode.


isFindModeAllowed

public final boolean isFindModeAllowed()

setFindMode

public final void setFindMode(boolean mode)
Calls setFindMode(boolean mode, boolean applyCriteria) with applyCriteria = true;


setFindMode

public final void setFindMode(boolean mode,
                              boolean applyVC)
Sets this iterator to findMode or not. If mode = false, then it applies the current ViewCriteria to this binding's ViewObject to execute the criteria if applyVC = true;


isFindMode

public final boolean isFindMode()
Returns true if this iterator binding is in find mode.


needsEstimatedRowCount

public final boolean needsEstimatedRowCount()

executeQuery

public void executeQuery()
Executes the query or the RowSet behind this iterator binding object.


executeQueryIfNeeded

public void executeQueryIfNeeded()
Executes the query or the RowSet behind this iterator binding object if not already executed.


getCurrentRow

public Row getCurrentRow()
Returns the current row of the iterator with which this binding object is associated. In find mode, this returns an instance of ViewCriteriaRow.


getRowAtRangeIndex

public Row getRowAtRangeIndex(int rangeIndex)
Returns the row of given range index.

Parameters:
rangeIndex - The range index of the row.

getAllRowsInRange

public Row[] getAllRowsInRange()
Returns an array of rows in the current range of the current RowIterator.


getBindingContainer

public DCBindingContainer getBindingContainer()
Return form binding object of this iterator binding's container.


setBindingContainer

public void setBindingContainer(DCBindingContainer formBnd)

getDataControl

public final DCDataControl getDataControl()
Helper method to return the DCDataControl from this binding's BindingContainer.


initDataControl

protected DCDataControl initDataControl()

fetchAttributeProperties

protected void fetchAttributeProperties()

getValueBindingList

public java.util.ArrayList getValueBindingList()
Returns a list of DCCtrlValueBinding objects that are associated with this iterator binding. Returns null if no control binding is registered with this object.


addValueBinding

public void addValueBinding(DCControlBinding bnd)
Adds the given control binding object to its list.


removeValueBinding

public boolean removeValueBinding(DCControlBinding bnd)
Removes the given control binding object from its list. Returns true if remove was successful.


getActionBindingList

public java.util.ArrayList getActionBindingList()
Returns a list of DCCtrlActionBinding objects that are associated with this iterator binding. Returns null if no action control binding is registered with this object.


addActionBinding

public void addActionBinding(DCControlBinding bnd)
Adds the given action control binding object to its list.


removeCurrentRow

public void removeCurrentRow()

removeActionBinding

public boolean removeActionBinding(DCControlBinding bnd)
Removes the given action control binding object from its list. Returns true if remove was successful.


getLovRowSetIterator

public RowSetIterator getLovRowSetIterator()

release

public void release()

release

public void release(int flags)

processInputException

public void processInputException()
Deprecated. use processInputException(JboException);


processInputException

public void processInputException(JboException errExc)

getError

public JboException getError()

getAttributeDefs

public AttributeDef[] getAttributeDefs()
get all attribute defs for the RSI that this iterator binding is bound to.


getIteratorDefName

public java.lang.String getIteratorDefName()

getAttributeDefs

public AttributeDef[] getAttributeDefs(java.lang.String[] attrNames)
return attribute defs for attributes that are named in the given array. If this array is null, return only those attribute defs that are not marked with control hint of hide. To get all attributes, use DCIteratorBinding.getAttributeDefs()


getRangeSize

public int getRangeSize()
Returns current rowsetiterator's range size


setRangeSize

public void setRangeSize(int val)
Set current rowsetiterator's range size


getRangeStart

public int getRangeStart()
Returns current rowsetiterator's range start


setRangeStart

public void setRangeStart(int val)
Set current rowsetiterator's range start


getCurrentRowIndexInRange

public int getCurrentRowIndexInRange()
Returns current row index in the current Range in the Rowsetiterator


setCurrentRowIndexInRange

public void setCurrentRowIndexInRange(int val)

setCurrentRowWithKeyValue

public void setCurrentRowWithKeyValue(java.lang.String stringKeyValue)
Find the row in the associated row iterator based on the value for a key attribute and if found set that as the current row. This method only works for cases where there's one key attribute on the collection.


getCurrentRowKeyString

public java.lang.String getCurrentRowKeyString()
Returns String version of the row key for the current row in the associated iterator. This key string can be used in setCurrentRowWithKey(). This method will return null if there is no current row in the associated iterator.


createKey

public Key createKey(java.lang.String stringKey)
Given the key string, convert it to a Key using the associated RowSetIterator's StructureDef.


setCurrentRowWithKey

public void setCurrentRowWithKey(java.lang.String stringKey)
Find the row in the associated row iterator based on the Key object and if found set that as the current row.

Parameters:
stringKey - String form of the Key object created using Key.toStringFormat(true/false)

setAlive

protected void setAlive(boolean flag)

isBound

public final boolean isBound()

getEstimatedRowCount

public long getEstimatedRowCount()

applySortCriteria

public void applySortCriteria(SortCriteria[] sortby)
Sets the sort critiera that will be applied next time when the source for this iteratorBinding is executed.


getSortCriteria

public SortCriteria[] getSortCriteria()
Returns an ordered array of SortCriteria that will be applied when the source for this iteratorBinding is executed.


isSortable

public boolean isSortable()

cacheCreatedRow

protected void cacheCreatedRow(RowSetIterator rsi,
                               Row row)

Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

 

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