Package de.aristaflow.adept2.core.runtimemanager.executionenvironments

Class NullExecution

java.lang.Object

de.aristaflow.adept2.core.runtimemanager.executionenvironments.ExecutionEnvironment

de.aristaflow.adept2.core.runtimemanager.executionenvironments.NullExecution

All Implemented Interfaces:

ExecutableComponent

public class NullExecution
extends ExecutionEnvironment

TODO EBPINSTANCE: Adapt the documentation according to the replacement of Activity by ActivityInstance The null execution just signals an application closed to the runtime environment and returns. This can be used for nodes with no executable business process, for instance, split or join nodes.

Author:

Ulrich Kreher

Nested Class Summary

Nested classes/interfaces inherited from interface de.aristaflow.adept2.model.runtimeenvironment.ExecutableComponent

ExecutableComponent.Signals

Field Summary

Fields inherited from class de.aristaflow.adept2.core.runtimemanager.executionenvironments.ExecutionEnvironment

actData, activityInstance, cleanup, localisedActInst, logger, sessionContext, SUSPEND_SAVEPOINT

Fields inherited from interface de.aristaflow.adept2.model.runtimeenvironment.ExecutableComponent

CONF_DATA_DIRECTORY, CONF_LIB_DIRECTORY, CONF_LOG_DIRECTORY, UNLOADING_CLASS_METHOD

Constructor Summary

Constructors

Constructor	Description
NullExecution(ActivityInstance activityInstance)	Creates a new NullExecution for the designated activity with a logger for this class.

Method Summary

Modifier and Type	Method	Description
boolean	close()	Returns false - overwrite this method to support closing.
boolean	kill()	Returns false - overwrite this method to support killing.
boolean	reset()	Returns false - overwrite this method to support reset.
void	run()	Signals an application close to the the runtime environment and returns.
boolean	signal(int signal)	Returns false - overwrite this method to support signalling.
boolean	suspend()	Returns false - overwrite this method to support suspending.

Methods inherited from class de.aristaflow.adept2.core.runtimemanager.executionenvironments.ExecutionEnvironment

cleanup, commit, createActivityData, getApplicationState, getApplicationState, getRawApplicationState, getRawApplicationState, init, initResume, prepareCommit, requireGUIContext, rollback, setApplicationState, setApplicationState, setRawApplicationState, setRawApplicationState

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

NullExecution

public NullExecution(ActivityInstance activityInstance)

Creates a new NullExecution for the designated activity with a logger for this class. The constructor sets the necessary fields by calling the constructor of the superclass.

Parameters:

activityInstance - The activity instance for this NullExecution.

Method Details

run

public void run()

Signals an application close to the the runtime environment and returns.

Specified by:

run in interface ExecutableComponent

Specified by:

run in class ExecutionEnvironment

close

public boolean close()

Description copied from class: ExecutionEnvironment

Returns false - overwrite this method to support closing.

Instructs the component to terminate. Within this method the component should deallocate all allocated resources.

Specified by:

close in interface ExecutableComponent

Overrides:

close in class ExecutionEnvironment

Returns:

false

reset

public boolean reset()

Description copied from class: ExecutionEnvironment

Returns false - overwrite this method to support reset.

Instructs the component to reset. This is quite similar to ExecutableComponent.kill() but the application does not fail but terminate normally (by calling RuntimeEnvironment.applicationReset(). The component will be re-initialised and executed again later.

Specified by:

reset in interface ExecutableComponent

Overrides:

reset in class ExecutionEnvironment

Returns:

false

signal

public boolean signal(int signal)

Description copied from class: ExecutionEnvironment

Returns false - overwrite this method to support signalling.

Signals an event to the application.

Specified by:

signal in interface ExecutableComponent

Overrides:

signal in class ExecutionEnvironment

Parameters:

signal - Ignored.

Returns:

false

See Also:

• for possible signals. Usually the ones that have corresponding methods, e. g. Signals#SUSPEND or Signals#CLOSE, will not be signaled via this method.

suspend

public boolean suspend()

Description copied from class: ExecutionEnvironment

Returns false - overwrite this method to support suspending.

Instructs the component to store its internal state to the data context and to terminate at once. The application should be able to continue its job later when resuming.

Specified by:

suspend in interface ExecutableComponent

Overrides:

suspend in class ExecutionEnvironment

Returns:

false

kill

public boolean kill()

Description copied from class: ExecutionEnvironment

Returns false - overwrite this method to support killing.

Enforces the application to abort its execution at once. In the case of running a internal transaction application should abort the transaction and should rollback. Within this method the component should deallocate all allocated resources.

Specified by:

kill in interface ExecutableComponent

Overrides:

kill in class ExecutionEnvironment

Returns:

false