org.mindswap.owls.process.execution
Interface ProcessExecutionEngine

All Superinterfaces:

java.util.EventListener

public interface ProcessExecutionEngine
extends java.util.EventListener

Author:

Evren Sirin

Method Summary

void	addExecutionListener(ProcessExecutionListener listener) Deprecated. Use addMonitor(ProcessMonitor monitor) instead
void	addMonitor(ProcessMonitor monitor)
ValueMap	execute(Perform perform) Execute the given perform construct.
ValueMap	execute(Process p) Execute the given process with no value bindings for input parameters.
ValueMap	execute(Process p, ValueMap bindings) Execute the given OWL-S process with the given input value bindings.
OWLKnowledgeBase	getKB() Get the KB.
boolean	isAllowMultipleSatisifedPreconditions()
boolean	isPreconditionCheck() Get if the execution engine verifies preconditions.
void	setAllowMultipleSatisifedPreconditions(boolean allow) Set the behavior for cases where evaluating a precondition may yield multiple different values for a local variable.
void	setKB(OWLKnowledgeBase kb) Set the KB where preconditions will be evaluated and the results will be put.
void	setPreconditionCheck(boolean checkPreconditions) Enable/disable precondition evaluation.

Method Detail

addExecutionListener

void addExecutionListener(ProcessExecutionListener listener)

Deprecated. Use addMonitor(ProcessMonitor monitor) instead

addMonitor

void addMonitor(ProcessMonitor monitor)

setKB

void setKB(OWLKnowledgeBase kb)

Set the KB where preconditions will be evaluated and the results will be put. This is simply the execution environment.

getKB

OWLKnowledgeBase getKB()

Get the KB.

setPreconditionCheck

void setPreconditionCheck(boolean checkPreconditions)

Enable/disable precondition evaluation. Note that if there are local variables bound by the precondition then the execution may fail when precondition evaluation is disabled.

isPreconditionCheck

boolean isPreconditionCheck()

Get if the execution engine verifies preconditions.

setAllowMultipleSatisifedPreconditions

void setAllowMultipleSatisifedPreconditions(boolean allow)

Set the behavior for cases where evaluating a precondition may yield multiple different values for a local variable. If this option is enabled then the execution engine will simply pick the first value from the possible bindings and conintue. Otherwise an ExecutionException will be thrown indicating that execution failed.

Parameters:

allow - If true one of the multiple bindings for a precondition is chosen else an ExecutionException is thrown

isAllowMultipleSatisifedPreconditions

boolean isAllowMultipleSatisifedPreconditions()

Returns:

Returns if multiple satisifed preconditions are allowed

execute

ValueMap execute(Process p)
                 throws java.lang.Exception

Execute the given process with no value bindings for input parameters. Process is assumed to have no input parameters or all the value bindings were already specified in the defaultValues

Parameters:

p - Process to be executed

Returns:

Value bindings for the output parameters after the execution. Returns null if execution is not successful

Throws:

java.lang.Exception

execute

ValueMap execute(Process p,
                 ValueMap bindings)
                 throws java.lang.Exception

Execute the given OWL-S process with the given input value bindings. If a value is not specified for a parameter in the valueMap then the default values of the process is searched.

Parameters:

p - Process to be executed

map - Value bindings for the input parameters

Returns:

Value bindings for the output parameters after the execution. Returns null if execution is not successful

Throws:

java.lang.Exception

execute

ValueMap execute(Perform perform)
                 throws java.lang.Exception

Execute the given perform construct. Perform shoud contain all the necessary input bindings specified.

Parameters:

perform -

Returns:

Throws:

java.lang.Exception