Package oracle.rules.sdk2.ruleset

Class Action

java.lang.Object
oracle.rules.sdk2.dictionary.DictionaryObject
oracle.rules.sdk2.dictionary.DictionaryComponent<T>
oracle.rules.sdk2.ruleset.RuleComponent<T>
oracle.rules.sdk2.ruleset.UnnamedRuleComponent<Action>
oracle.rules.sdk2.ruleset.Action
All Implemented Interfaces:
Serializable, Cloneable, Map<String,Object>, UnnamedComponent, ExpressionContext, ScopedVariable, VariableScope, VerbalRuleComponent
Direct Known Subclasses:
DTAction
public class Action extends UnnamedRuleComponent<Action> implements ScopedVariable, ExpressionContext, VerbalRuleComponent
An action, such as assert, assign, call, or retract.

When using this interface, selecting the Form property first will fix the options for target, which in turn will fix the number of expressions and the option list for each. The expressions cannot be added to the table; this is done automatically when the form or target is selected.

Actions are described using a combination of properties, dictated by the Form property:

  • SimpleTestTable
  • ExpressionTable
  • ActionTable
  • Variable
  • Target
The valid combinations and meaning are described in the following table.
Form SimpleTestTable ExpressionTable ActionTable Variable Target
rl - - - - RL
call - arguments - - function or method
assert - object to assert - - object to assert
assert tree - tree to assert - - tree to assert
assert new - property values - - fact type
retract - fact to retract - - fact to retract
assign - RHS - - LHS
assign new - initial value - name fact type
expression - expression - - -
modify - property values - - fact to modify
synchronized- lock object - - lock object
if - boolean expression if actions - -
else if - boolean expression if actions - -
if test test - if actions - -
else if testtest - if actions - -
else - - else actions - -
for - List expression loop actions loop var list content type
while - boolean expression loop actions - -
while test test - loop actions - -
return - return expression - - -
throw - throw expression - - -
try - - try actions - -
catch - - catch actionsexcep nameexcep type
finally - - final actions- -
Actions may be executed conditionally and in blocks by using an Action form that provides a nested ActionTable. Actions listed in a nested ActionTable are only executed if the conditions in the parent action are satisfied, or a preceeding Action conditional dropped through to the nested Action Table. Tests that apply property of an ActionTable should not be confused with the Test property of a Rule's Pattern. A Pattern test is used to match and select FACTS in working memory. An Action Test does not refer to facts; it only contains expressions consisting of variable references and literals. For Actions that complete the action portion of a rule, a variable may be an instance reference to FACT selected by the rule's Pattern. For Actions used in a Function body, no FACT instances are available.
For example, an If action (FORM_IF) is required to have a nested block. The nested block contains any statements that in within the scope of the if test FORM_IF ActionTable contains the statment belonging to the if condition expression

The for action supports both for (i = 0; i < 10; i = i + 1) and for (Foo f : listFoo). The first form is deprecated. The UI should support the second form as follows: for (<type> <var> : <collection>) { The type is bound to Action.target, the var is bound to Action.variable, and collection is bound to Action.expression(0).value

See Also: