oracle.jbo.uicli.binding
Class JUCtrlActionBinding

java.lang.Object
  |
  +--oracle.jbo.uicli.binding.JUControlBinding
        |
        +--oracle.jbo.uicli.binding.JUCtrlActionBinding

Direct Known Subclasses:

JUActionBinding

public abstract class JUCtrlActionBinding

extends JUControlBinding

Implements actions on BC4J RowIterator to which this control is bound. This class supports the following actions:

• ACTION_EXECUTE Executes the ViewObject query.
• ACTION_NEXT Moves the currency to the next row.
• ACTION_PREVIOUS Moves the currency to the previous row.
• ACTION_FIRST Moves the currency to the first row.
• ACTION_LAST Moves the currency to the last row.
• ACTION_RESET Resets the currency to the beginning of the RowIterator.
• ACTION_REMOVE_CURRENT_ROW Removes the current row in this iterator.
• ACTION_CREATE_INSERT_ROW Creates a new row and insert it into this iterator before the current row.
• ACTION_COMMIT_TRANSACTION Commits all changes in the current BC4J application module session into database.
• ACTION_ROLLBACK_TRANSACTION Rolls back any changes in the current BC4J application module session.

If a button is bound to this binding class, then, on button press, the action event on the button binding should call doIt() method on this object to perform the desired action.

Field Summary

static int	ACTION_COMMIT_TRANSACTION
static int	ACTION_CREATE_INSERT_ROW
static int	ACTION_EXECUTE
static int	ACTION_FIRST
static int	ACTION_LAST
static int	ACTION_NEXT
static int	ACTION_PREVIOUS
static int	ACTION_REMOVE_CURRENT_ROW
static int	ACTION_RESET
static int	ACTION_ROLLBACK_TRANSACTION

Constructor Summary

JUCtrlActionBinding(java.lang.Object control, JUIteratorBinding iterBinding, int action)
Creates an ActionBinding instance that works with the given control and on control's ActionEvent, call the doIt() method.

Method Summary

static java.lang.String	actionIdToName(int id) *** For internal framework use only ***
static int	actionNameToId(java.lang.String actionName) *** For internal framework use only ***
void	doIt() Invokes the action that this binding is selected to perform.
boolean	isArrayIteratorType()
void	refreshControl() *** For internal framework use only ***
void	setArrayIteratorType()

Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding

addControlToPanel, executeQuery, executeQueryIfNeeded, getAllRowsInRange, getApplicationModule, getControl, getCurrentRow, getDef, getFormBinding, getIteratorBinding, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, isControlQueriable, reportException, reportException, setFormBinding, setName

Methods inherited from class java.lang.Object

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

Field Detail

ACTION_EXECUTE

public static final int ACTION_EXECUTE

See Also:

Constant Field Values

ACTION_NEXT

public static final int ACTION_NEXT

See Also:

Constant Field Values

ACTION_PREVIOUS

public static final int ACTION_PREVIOUS

See Also:

Constant Field Values

ACTION_FIRST

public static final int ACTION_FIRST

See Also:

Constant Field Values

ACTION_LAST

public static final int ACTION_LAST

See Also:

Constant Field Values

ACTION_RESET

public static final int ACTION_RESET

See Also:

Constant Field Values

ACTION_REMOVE_CURRENT_ROW

public static final int ACTION_REMOVE_CURRENT_ROW

See Also:

Constant Field Values

ACTION_CREATE_INSERT_ROW

public static final int ACTION_CREATE_INSERT_ROW

See Also:

Constant Field Values

ACTION_COMMIT_TRANSACTION

public static final int ACTION_COMMIT_TRANSACTION

See Also:

Constant Field Values

ACTION_ROLLBACK_TRANSACTION

public static final int ACTION_ROLLBACK_TRANSACTION

See Also:

Constant Field Values

Constructor Detail

JUCtrlActionBinding

public JUCtrlActionBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
                           int action)

Creates an ActionBinding instance that works with the given control and on control's ActionEvent, call the doIt() method.

Parameters:

control - The control that this binding works with.

iterBinding - JUIteratorBinding instance that this binding works with.

action - Indicates the selected action from the list of actions this class implements.

Method Detail

actionNameToId

public static int actionNameToId(java.lang.String actionName)

*** For internal framework use only ***

actionIdToName

public static java.lang.String actionIdToName(int id)

*** For internal framework use only ***

doIt

public void doIt()

Invokes the action that this binding is selected to perform. This method gets the RowIterator from the associated Iterator binding and then calls an equivalent method on the RowIterator. BC4J runtime then sends appropriate events to various binding objects based on the action to update their display with the latest currency, data, etc.

Here's a list of actions and corresponding method calls on the BC4J side.

• ACTION_EXECUTE Calls ViewObject.executeQuery() on the corresponding ViewObject to which this binding's RowIterator belongs to.
• ACTION_NEXT Calls RowIterator.next() after generating beforeRowNavigated event on the associated JUFormBinding (if currency is moved from an existing current row to another one.)
• ACTION_PREVIOUS Calls RowIterator.previous() after generating beforeRowNavigated event on the associated JUFormBinding (if currency is moved from an existing current row to another one.)
• ACTION_FIRST Calls RowIterator.first() after generating beforeRowNavigated event on the associated JUFormBinding (if currency is moved from an existing current row to the first row.)
• ACTION_LAST Calls RowIterator.last() after generating beforeRowNavigated event on the associated JUFormBinding (if currency is moved from an existing current row to the last row.)
• ACTION_RESET Reset the currency to the beginning of the RowIterator by calling RowIterator.reset() after generating beforeRowNavigated event if currency is taken away from an existing current row.
• ACTION_REMOVE_CURRENT_ROW Remove the current row in this iterator by calling RowIterator.removeCurrentRow()
• ACTION_CREATE_INSERT_ROW Create a new row and insert it into this iterator before the current row after generating beforeRowNavigated event on the containing JUFormBinding.
• ACTION_COMMIT_TRANSACTION Commit all changes in the current BC4J application module session into database by calling commit() method on the related BC4J Transaction object.
• ACTION_ROLLBACK_TRANSACTION Rollback any changes in the current BC4J application module session by calling rollback() method on the related BC4J Transaction object. This method also re-executes the Form (all VOs in the JUFormBinding) after a successful rollback.

setArrayIteratorType

public void setArrayIteratorType()

isArrayIteratorType

public boolean isArrayIteratorType()

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 JUControlBinding