org.gcube.vremanagement.executor.api

Interface SmartExecutor

public interface SmartExecutor

Service Endpoint Interface

Author:

Luca Frosini (ISTI - CNR) http://www.lucafrosini.com/

Field Summary

Fields

Modifier and Type	Field and Description
static String	TARGET_NAMESPACE
static String	WEB_SERVICE_SERVICE_NAME

Method Summary

Methods

Modifier and Type	Method and Description
PluginState	getIterationState(String executionIdentifier, int iterationNumber) The method use the provided UUID as String and the iteration number to retrieve the status of the associated execution
PluginState	getState(String executionIdentifier) The method use the provided UUID as String to retrieve the status of the associated execution
String	launch(LaunchParameter launchParameter) Launch the plugin identified by the name provided as parameters with the provided inputs.
boolean	unSchedule(String executionIdentifier) The method use the provided UUID as String to unschedule a previous scheduled task and stop the current execution (if any).

Field Detail

TARGET_NAMESPACE

static final String TARGET_NAMESPACE

See Also:

Constant Field Values

WEB_SERVICE_SERVICE_NAME

static final String WEB_SERVICE_SERVICE_NAME

See Also:

Constant Field Values

Method Detail

launch

String launch(LaunchParameter launchParameter)
              throws InputsNullException,
                     PluginNotFoundException,
                     LaunchException,
                     ExecutorException

Launch the plugin identified by the name provided as parameters with the provided inputs. Inputs cannot be null. If you need to launch an execution with no inputs provide an empty Map. This method return as soon as the plugin has been launched. The execution is made in a separated Thread.

Parameters:

launchParameter - which contains the name of the plugin to launch and the input to be provided to plugin to run.

Returns:

the UUID execution identifier as String which identify the execution of the plugin.

Throws:

InputsNullException - if LaunchParameter contains null inputs.

PluginNotFoundException - if LaunchParameter contains a name of a plugin which is not available on classpath

LaunchException - if an error occurs trying to instantiate and/or launch the plugin execution

ExecutorException - if any other undefined error occur

unSchedule

boolean unSchedule(String executionIdentifier)
                   throws ExecutorException

The method use the provided UUID as String to unschedule a previous scheduled task and stop the current execution (if any).

Parameters:

executionIdentifier - UUID as String which identify the execution

Returns:

return true if the current execution correctly unscheduled and stopped. False otherwise.

Throws:

Exception - if there is no execution identified by the provided UUID execution identifier as String

ExecutorException

getState

PluginState getState(String executionIdentifier)
                     throws PluginInstanceNotFoundException,
                            ExecutorException

The method use the provided UUID as String to retrieve the status of the associated execution

Parameters:

executionIdentifier - UUID as String which identify the execution

Returns:

PluginState which contains the state of the execution

Throws:

Exception - if there is no execution identified by the provided UUID execution identifier as String

PluginInstanceNotFoundException

ExecutorException

getIterationState

PluginState getIterationState(String executionIdentifier,
                            int iterationNumber)
                              throws PluginInstanceNotFoundException,
                                     ExecutorException

The method use the provided UUID as String and the iteration number to retrieve the status of the associated execution

Parameters:

executionIdentifier - UUID as String which identify the execution

iterationNumber - iteration number

Returns:

PluginState which contains the state of the execution

Throws:

Exception - if there is no execution identified by the provided UUID execution identifier as String

PluginInstanceNotFoundException

ExecutorException