teetime.framework

Class Execution<T extends Configuration>

java.lang.Object

teetime.framework.Execution<T>

Type Parameters:

T - the type of the Configuration

public final class Execution<T extends Configuration>
extends Object

Represents an Execution to which stages can be added and executed later. This class requires a Configuration, in which the adding and configuring of stages takes place. To start the analysis executeBlocking() needs to be executed. This class will automatically create threads and join them without any further commitment.

Since:

2.0

Author:

Christian Wulf, Nelson Tavares de Sousa

Constructor Summary

Constructors

Constructor and Description
Execution(T configuration) Creates a new Execution.
Execution(T configuration, boolean validationEnabled) Uses PushPullScheduling as default scheduler.
Execution(T configuration, boolean validationEnabled, TeeTimeScheduler scheduler)

Method Summary

Modifier and Type	Method and Description
void	abortEventually() Terminates all producer stages, interrupts all threads, and waits for a graceful termination.
void	executeBlocking() This method will start this execution and block until it is finished.
Future<Void>	executeNonBlocking() This method starts this execution without waiting for its termination.
T	getConfiguration() Retrieves the Configuration which was used to add and arrange all stages needed for this execution.
static void	main(String... args)
void	waitForTermination() Calling this method will block the current thread until the execution terminates.

Methods inherited from class java.lang.Object

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

Constructor Detail

Execution

public Execution(T configuration)

Creates a new Execution. It validates the given configuration and uses the PushPullScheduling as default scheduler.

Parameters:

configuration - to be executed

Execution

public Execution(T configuration,
                 boolean validationEnabled)

Uses PushPullScheduling as default scheduler.

Parameters:

configuration - to be executed.

validationEnabled - true if validation should be performed after initialization; false otherwise.

Execution

public Execution(T configuration,
                 boolean validationEnabled,
                 TeeTimeScheduler scheduler)

Parameters:

configuration - to be executed.

validationEnabled - true if validation should be performed after initialization; false otherwise.

scheduler - to be used for the given configuration.

Method Detail

waitForTermination

public void waitForTermination()

Calling this method will block the current thread until the execution terminates.

Throws:

ExecutionException - if at least one exception in one thread has occurred within the execution. The exception contains the pairs of thread and throwable

Since:

2.0

abortEventually

public void abortEventually()

Terminates all producer stages, interrupts all threads, and waits for a graceful termination.

executeNonBlocking

public Future<Void> executeNonBlocking()

This method starts this execution without waiting for its termination. The method waitForTermination() must be called to unsure a correct termination of the execution.

Returns:

a future object to cancel the execution or to wait for the execution to finish.

Since:

2.0

executeBlocking

public void executeBlocking()

This method will start this execution and block until it is finished.

Throws:

ExecutionException - if at least one exception in one thread has occurred within the execution. The exception contains the pairs of thread and throwable.

Since:

2.0

getConfiguration

public T getConfiguration()

Retrieves the Configuration which was used to add and arrange all stages needed for this execution.

Returns:

the configuration used for this execution

main

public static void main(String... args)