Package net.ssehub.easy.producer.core.mgmt

Class VilExecutionThread

java.lang.Object

net.ssehub.easy.producer.core.mgmt.VilExecutionThread

All Implemented Interfaces:

java.lang.Runnable

public class VilExecutionThread
extends java.lang.Object
implements java.lang.Runnable

Responsible class for the execution of VIL scripts, i.e., instantiation of product line artifacts. Runs the VIL execution in an own thread. Usage:

1. Create new thread (one per PLPInfo object, should be called by the PLPInfo):
   vilExecutor = new VilExecutionThread(this);
2. Register listener to get informed when the instantiation is finished/aborted:
   vilExecutor.addListener(newListener);
3. Start the instantiation:
   vilExecutor.startInstantiation(observer);
4. Abort the instantiation if necessary, e.g. in an endless loop:
   vilExecutor.abortInstantiation(observer);

Author:

El-Sharkawy

Field Summary

Fields

Modifier and Type	Field	Description
private Executor	executor
private java.util.List<IVilExecutionListener>	listeners
private ProgressObserver	observer
private PLPInfo	plp
private boolean	successful

Constructor Summary

Constructors

Constructor	Description
VilExecutionThread(PLPInfo plp)	Creates a new VIL execution thread for the given PLPInfo, but will not start the instantiation.

Method Summary

Modifier and Type	Method	Description
void	abortInstantiation()	Aborts the current execution of the VIL script at the next possible point (that is not any time possible, e.g., during the execution of third party tools like embedded maven scripts).
void	addListener(IVilExecutionListener listener)	Adds a new IVilExecutionListener to get informed when the instantiation was finished/aborted.
protected Executor	createExecutor()	Creates a VIL executor for the contained PLP.
void	removeListener(IVilExecutionListener listener)	Removes an IVilExecutionListener.
void	run()
void	startInstantiation(ProgressObserver observer, boolean waitFor)	Starts the execution of the underlying VIL script (PLPInfo.getBuildScript()) in an own thread.

Methods inherited from class java.lang.Object

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

Field Detail

executor

private Executor executor

plp

private PLPInfo plp

observer

private ProgressObserver observer

successful

private boolean successful

listeners

private java.util.List<IVilExecutionListener> listeners

Constructor Detail

VilExecutionThread

public VilExecutionThread(PLPInfo plp)

Creates a new VIL execution thread for the given PLPInfo, but will not start the instantiation.

Parameters:

plp - The PLPInfo, which may be instantiated (must not be null).

Method Detail

createExecutor

protected Executor createExecutor()

Creates a VIL executor for the contained PLP.

Returns:

the created executor

addListener

public void addListener(IVilExecutionListener listener)

Adds a new IVilExecutionListener to get informed when the instantiation was finished/aborted.

Parameters:

listener - The listener to be informed.

See Also:

removeListener(IVilExecutionListener)

removeListener

public void removeListener(IVilExecutionListener listener)

Removes an IVilExecutionListener.

Parameters:

listener - The old listener, to be removed.

See Also:

addListener(IVilExecutionListener)

startInstantiation

public void startInstantiation(ProgressObserver observer,
                               boolean waitFor)

Starts the execution of the underlying VIL script (PLPInfo.getBuildScript()) in an own thread.

Parameters:

observer - The observer to inform about the current progress (in case of null ProgressObserver.NO_OBSERVER will be used).

waitFor - true This method will wait until the script was processed completely (blocking method), false script will be processed in an asynchronous manner (usually used in an GUI environment).

See Also:

abortInstantiation()

abortInstantiation

public void abortInstantiation()

Aborts the current execution of the VIL script at the next possible point (that is not any time possible, e.g., during the execution of third party tools like embedded maven scripts).

See Also:

#startInstantiation(ProgressObserver)

run

public void run()

Specified by:

run in interface java.lang.Runnable