com.massa.mrules.executable

Interface IExecutionResult

All Superinterfaces:

Serializable

All Known Implementing Classes:

ExecutionResultWrapper

public interface IExecutionResult
extends Serializable

Class describing an IExecutable execution results. An execution result might contains two parts :

• First, condition evaluation result.
• Second, action execution feedback.

As the execution feedback is actually mostly handled with Exceptions, action feedback will return OK.
This semantic and the details provided in the result are meant to be improved in future releases.

See Also:

to get standard results and {@link ExecutionResultWrapper} to complete directives and return values.

Method Summary

Modifier and Type	Method and Description
ExecutionResultState	getActionValidated() If this executable contains sub-executables, returns ExecutionResultState.OK if they are correctly executed.
ExecutionResultState	getConditionValidated() If this executable contains conditions, returns ExecutionResultState.OK if they are validated, ExecutionResultState.KO if not.
IExecutionControlDirective	getDirective() Returns the directive to transmit to parent IExecutable, so that they can make appropriate actions.
Object	getReturnedValue() Any executable may return a value.
boolean	isContainingDirective() Tells if this result contains flow control directives, in which case in should be interpreted.

Method Detail

getConditionValidated

ExecutionResultState getConditionValidated()

If this executable contains conditions, returns ExecutionResultState.OK if they are validated, ExecutionResultState.KO if not.
If this executable does not contain conditions, returns ExecutionResultState.NA.
This method should not return ExecutionResultState.PARTIAL.
This result does not include sub-executables condition results.

getActionValidated

ExecutionResultState getActionValidated()

If this executable contains sub-executables, returns

• ExecutionResultState.OK if they are correctly executed.
• ExecutionResultState.KO if not.
• ExecutionResultState.PARTIAL if some are correctly executed, others not.

If this executable does not contain sub-executables or if they are not executed, returns ExecutionResultState.NA.

For the moment, provided base implementations (IAction) will only return ExecutionResultState.OK, as errors are handled via Exceptions.
But more high level IExecutable will handle correctly all types of results.

isContainingDirective

boolean isContainingDirective()

Tells if this result contains flow control directives, in which case in should be interpreted.
If true, getDirective() can't return null.

getDirective

IExecutionControlDirective getDirective()

Returns the directive to transmit to parent IExecutable, so that they can make appropriate actions.
This field cant't be null if isContainingDirective() is true.

getReturnedValue

Object getReturnedValue()

Any executable may return a value. This method is dedicated to it.

Returns:

Value returned by the executable