public class JUCtrlActionBinding extends JUControlBinding implements OperationBinding
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.
      mAction = action;
 ACTION_RESET Resets the currency to the beginning of the RowIterator.
 ACTION_EXECUTE_WITH_PARAMS Executes the corresponding VO with the given set of parameters.
 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 invoke() method on this object to perform the desired action.
| Modifier and Type | Field and Description | 
|---|---|
| static int | ACTION_BINDING_CONTAINER_EXECUTE | 
| static int | ACTION_BINDING_CONTAINER_FIND | 
| static int | ACTION_COMMIT_TRANSACTION | 
| static int | ACTION_CREATE_INSERT_ROW | 
| static int | ACTION_CREATE_ROW | 
| static int | ACTION_CREATE_TEMP_WITH_PARAMS | 
| static int | ACTION_CREATE_WITH_PARAMS | 
| static int | ACTION_EXECUTE | 
| static int | ACTION_EXECUTE_WITH_PARAMS | 
| static int | ACTION_FIND | 
| static int | ACTION_FIRST | 
| static int | ACTION_INVOKE_METHOD | 
| static int | ACTION_ITERATOR_BINDING_EXECUTE | 
| static int | ACTION_ITERATOR_BINDING_FIND | 
| static int | ACTION_LAST | 
| static int | ACTION_NEXT | 
| static int | ACTION_NEXT_SET | 
| static int | ACTION_PREVIOUS | 
| static int | ACTION_PREVIOUS_SET | 
| static int | ACTION_REMOVE_CURRENT_ROW | 
| static int | ACTION_REMOVEROW_WITH_KEY | 
| static int | ACTION_RESET | 
| static int | ACTION_RESET_STATE | 
| static int | ACTION_ROLLBACK_TRANSACTION | 
| static int | ACTION_SETCURRENTROW_WITH_KEY | 
| static int | ACTION_SETCURRENTROW_WITH_KEYVALUE | 
ATTR_CURRENTROW, ATTR_DEF, ATTR_ERROR, ATTR_ERRORS, ATTR_FULLNAME, ATTR_ITER, ATTR_NAME, DC_BINDING_ERROR, mAttributeListener, mInternalGet_KeyResolved, mPermission, mPermissionInfo, ROW_KEY_STRMAP_NULL_VALUE| Constructor and Description | 
|---|
| JUCtrlActionBinding(java.lang.Object control,
                   DCBindingContainer form,
                   DCInvokeMethodDef methodInfo) | 
| JUCtrlActionBinding(java.lang.Object control,
                   DCDataControl dc,
                   int action)Creates an ActionBinding instance that works with the given control and
 on control's ActionEvent, call the invoke() method. | 
| JUCtrlActionBinding(java.lang.Object control,
                   DCIteratorBinding iterBinding,
                   int action)Creates an ActionBinding instance that works with the given control and
 on control's ActionEvent, call the invoke() method. | 
| Modifier and Type | Method and Description | 
|---|---|
| void | _dbg_AfterInvokeOperation() | 
| void | _dbg_invokeOperation(DCIteratorBinding iterBinding,
                    java.lang.Object[] actionParams) | 
| 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 | addActionBindingListener(JUCtrlActionBindingListener l)Adds the given listener to this Action Binding's listeners list. | 
| void | addControlToPanel(java.lang.Object panel,
                 java.lang.Object layoutObject,
                 java.lang.Object layoutCons)*** For internal framework use only *** | 
| void | addInvokeMethodListener(DCInvokeMethodListener l) | 
| protected JUCtrlActionBindingEvent | createActionBindingEvent() | 
| void | doIt()Performs the action that this binding is selected to perform. | 
| java.lang.Object | execute()Invoke the bound action and return the operation returned value. | 
| java.util.ArrayList | getActionBindingListeners()Returns a list of JUActionBindingListener  (returns an empty list if no such listener was registered). | 
| int | getActionId()Returns Action Id for this Action binding. | 
| DCDataControl | getDataControl()Returns the datacontrol that this action or it's iteratorBinding is associated with. | 
| java.lang.Boolean | getEnabled()Returns true if this action should be enabled. | 
| java.lang.String | getEnabledString() | 
| JboException | getError()Primarily for spel support. | 
| java.util.List | getErrors()Added for satisfying the oracle.binding.ActionBinding interface. | 
| EventConsumer | getEventConsumer()getEventConsumer returns the EventConsumer | 
| EventHandlerInvoker | getEventHandlerInvoker() | 
| EventProducer | getEventProducer()getEventProducer returns the EventProducer | 
| DCInvokeMethodDef | getInvokeMethodDef()*** For internal framework use only ***
 Used for testing purposes only. | 
| OperationInfo | getOperationInfo()Returns a description of the operation to invoke. | 
| java.util.ArrayList | getParams()Returns an ordered list of parameter expressions that will be passed
 to the bound method on invocation. | 
| java.util.Map | getParamsMap()Returns a map of parameter expressions. | 
| java.lang.String | getPath()Returns a / separated name to the setInvoke() that could
 be used in el-expressions to invoke the method bound in this action binding. | 
| PermissionInfo | getPermissionInfo() | 
| java.lang.String | getPermissionTargetName() | 
| java.lang.Object | getResult()Returns the return value (if any) from the method that this binding invokes,
 of there are no exceptions during the action execution. | 
| java.lang.String | getResultType()Returns the return type (if any) from the method that this binding invokes. | 
| boolean | ignoreUpdates() | 
| protected void | initResources()Invoked when the bindingContainer is being initialized for the first
 time or after it's locale is changed. | 
| protected java.lang.Object | internalGet(java.lang.String key)Subclasses should override this to handle a specific key. | 
| protected DCDataControl | internalGetDataControl() | 
| protected DCDataControl | internalGetDataControlReference()use isAssociatedWithDataControl() to find if this binding
 is associated with a datacontrol. | 
| protected boolean | internalHasPermission(java.lang.String target,
                     java.lang.String actions) | 
| void | invoke()If this action is bound to a datacontrol, then calls
 dataControl.invokeAction to perform the action operations
 otherwise calls doIt() to perform the method action. | 
| boolean | isActionEnabled()Returns true if this action should be enabled for a given
 iterator or datacontrol. | 
| boolean | isArrayIteratorType() | 
| boolean | isOperationEnabled()Returns true if this action should be enabled for a given
 iterator or datacontrol. | 
| void | refreshControl()*** For internal framework use only *** | 
| void | release(int flag) | 
| void | removeActionBindingListener(JUCtrlActionBindingListener l)Removes the given listener from this Action Binding's listeners list. | 
| void | removeInvokeMethodListener(DCInvokeMethodListener l) | 
| void | reportException(java.lang.Exception ex)Report the given exception via the containing BindingContainer object. | 
| protected void | resetInputState()Resets any exceptions and client-side values that this binding may hold. | 
| boolean | resolvePath(java.util.Map postMap)Return true if this binding's path is found as a key in the given map. | 
| void | setArrayIteratorType() | 
| void | setEventHandlerInvoker(EventHandlerInvoker invoker) | 
| void | setInvoke(java.lang.Object dummy) | 
| void | setParams(java.util.ArrayList al)Set the ordered list of parameter expressions that should be passed
 to the bound method on invocation. | 
| protected void | setupMethodInfo(DCBindingContainer form,
               DCInvokeMethodDef def) | 
getCurrentRow, getFormBinding, getIteratorBinding, reportException, setFormBindingaddToDCExceptions, clearAttrDefs, evaluateBooleanExpression, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getAttributeListener, getBindingContainer, getControl, getControlModel, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getPermission, getRowAtRangeIndex, getRowIterator, getState, getTransaction, getViewableExpr, getViewObject, hasAttributeListener, hashCode, internalHasPermission, internalSetName, isAssociatedWithDataControl, isControlQueriable, isControlViewable, isReleased, needsEstimatedRowCount, processInputException, release, removeFromDCExceptions, resetAttributeExceptionInRow, restoreFromState, setBindingContainer, setControl, setDataControlPinned, setDef, setIteratorBinding, setListener, setListener, setName, setViewableExpr, toStringentrySet, equals, internalPut, put, setThrowIfPropertyNotFoundOnGetclear, clone, containsKey, containsValue, isEmpty, keySet, putAll, remove, size, valuesfinalize, getClass, notify, notifyAll, wait, wait, waitsetListenergetName, release, setListenerpublic static final int ACTION_EXECUTE
public static final int ACTION_FIND
public static final int ACTION_BINDING_CONTAINER_EXECUTE
public static final int ACTION_BINDING_CONTAINER_FIND
public static final int ACTION_ITERATOR_BINDING_EXECUTE
public static final int ACTION_ITERATOR_BINDING_FIND
public static final int ACTION_NEXT
public static final int ACTION_PREVIOUS
public static final int ACTION_FIRST
public static final int ACTION_LAST
public static final int ACTION_NEXT_SET
public static final int ACTION_PREVIOUS_SET
public static final int ACTION_RESET
public static final int ACTION_EXECUTE_WITH_PARAMS
public static final int ACTION_REMOVE_CURRENT_ROW
public static final int ACTION_CREATE_INSERT_ROW
public static final int ACTION_CREATE_ROW
public static final int ACTION_CREATE_WITH_PARAMS
public static final int ACTION_CREATE_TEMP_WITH_PARAMS
public static final int ACTION_SETCURRENTROW_WITH_KEY
public static final int ACTION_SETCURRENTROW_WITH_KEYVALUE
public static final int ACTION_REMOVEROW_WITH_KEY
public static final int ACTION_COMMIT_TRANSACTION
public static final int ACTION_ROLLBACK_TRANSACTION
public static final int ACTION_RESET_STATE
public static final int ACTION_INVOKE_METHOD
public JUCtrlActionBinding(java.lang.Object control,
                   DCBindingContainer form,
                   DCInvokeMethodDef methodInfo)
control - View-layer object that this action binding works with.public JUCtrlActionBinding(java.lang.Object control,
                   DCIteratorBinding iterBinding,
                   int action)
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.public JUCtrlActionBinding(java.lang.Object control,
                   DCDataControl dc,
                   int action)
control - The control that this binding works with.dc - JUIteratorBinding instance that this binding works with.action - Indicates the selected action from the list of actions this class implements.public EventHandlerInvoker getEventHandlerInvoker()
public void setEventHandlerInvoker(EventHandlerInvoker invoker)
public java.lang.String getEnabledString()
protected void setupMethodInfo(DCBindingContainer form, DCInvokeMethodDef def)
public boolean isActionEnabled()
public boolean isOperationEnabled()
isOperationEnabled in interface OperationBindingprotected DCDataControl internalGetDataControl()
internalGetDataControl in class DCControlBindingprotected final DCDataControl internalGetDataControlReference()
internalGetDataControlReference in class DCControlBindingpublic final DCDataControl getDataControl()
public static int actionNameToId(java.lang.String actionName)
public static java.lang.String actionIdToName(int id)
public java.lang.Object execute()
execute in interface OperationBindingpublic final void invoke()
This allows datacontrol subclasses to perform custom implementation for all actions in the framework
public java.util.List getErrors()
getErrors in interface OperationBindinggetErrors in class DCControlBindingOperationBinding.invoke()public void doIt()
Here's a list of actions and corresponding method calls on the BC4J side.
ACTION_ITERATOR_BINDING_FIND Calls IteratorBinding.setFindMode(true)
 ACTION_BINDING_CONTAINER_FIND Calls BindingContainer.setFindMode(true)
 ACTION_ITERATOR_BINDING_EXECUTE Calls IteratorBinding.executeQuery()
 ACTION_BINDING_CONTAINER_EXECUTE Calls BindingContainer.executeQuery()
 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_NEXT_SET Calls RowIterator.scrollRange() with
 this iterator's rangeSize as the number of rows to scroll forward.
 ACTION_PREVIOUS_SET Calls RowIterator.scrollRange() with
 the negative value for this iterator's rangeSize as the number of rows to scroll back.
 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_EXECUTE_WITH_PARAMS Execute iteratorBinding's datasource with
 parameter values collected from this bindingContainer.
 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_CREATE_ROW Create a new row but do not insert it into this iterator. Callers need
 to insert this row programmatically into the iterator.
 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.
 public final void _dbg_invokeOperation(DCIteratorBinding iterBinding, java.lang.Object[] actionParams)
public void setArrayIteratorType()
public boolean isArrayIteratorType()
public void refreshControl()
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.
refreshControl in class DCControlBindingpublic boolean ignoreUpdates()
public int getActionId()
public void addControlToPanel(java.lang.Object panel,
                     java.lang.Object layoutObject,
                     java.lang.Object layoutCons)
JUControlBindingaddControlToPanel in class JUControlBindingpublic OperationInfo getOperationInfo()
OperationBindinggetOperationInfo in interface OperationBindingpublic DCInvokeMethodDef getInvokeMethodDef()
public void setInvoke(java.lang.Object dummy)
protected void initResources()
DCControlBindinginitResources in class DCControlBindingprotected void resetInputState()
DCControlBindingresetInputState in class DCControlBindingpublic JboException getError()
Returns exception that occured on last setInputValue
getError in class DCControlBindingpublic final java.lang.Boolean getEnabled()
public final java.lang.String getPath()
getPath in interface ControlBindingpublic boolean resolvePath(java.util.Map postMap)
resolvePath in interface ControlBindingprotected java.lang.Object internalGet(java.lang.String key)
Properties returned vis getter on this control bindings are:
params - returns getParams()paramsMap - returns getParamsMap()result  - returns getResult()enabled  - returns isActionEnabled()path  - returns getPath()text  - returns getText()internalGet in class DCControlBindingpublic java.util.Map getParamsMap()
getParamsMap in interface OperationBindingpublic java.lang.Object getResult()
getResult in interface OperationBindingpublic java.lang.String getResultType()
public java.util.ArrayList getParams()
public void setParams(java.util.ArrayList al)
public void reportException(java.lang.Exception ex)
reportException in class DCControlBindingpublic void release(int flag)
release in class DCControlBindingpublic PermissionInfo getPermissionInfo()
getPermissionInfo in class DCControlBindingpublic java.lang.String getPermissionTargetName()
getPermissionTargetName in class DCControlBindingprotected boolean internalHasPermission(java.lang.String target,
                            java.lang.String actions)
internalHasPermission in class DCControlBindingpublic void addInvokeMethodListener(DCInvokeMethodListener l)
public void removeInvokeMethodListener(DCInvokeMethodListener l)
public final java.util.ArrayList getActionBindingListeners()
protected JUCtrlActionBindingEvent createActionBindingEvent()
public final void addActionBindingListener(JUCtrlActionBindingListener l)
public final void removeActionBindingListener(JUCtrlActionBindingListener l)
public EventConsumer getEventConsumer()
JUEventConsumerpublic EventProducer getEventProducer()
JUEventProducerpublic void _dbg_AfterInvokeOperation()