org.jenkinsci.plugins.durabletask

Class Controller

java.lang.Object

org.jenkinsci.plugins.durabletask.Controller

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

FileMonitoringTask.FileMonitoringController

public abstract class Controller
extends Object
implements Serializable

Defines how to control the execution of a task after it has started. Expected to be XStream and Java serializable.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Controller()

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	cleanup(hudson.FilePath workspace) Cleans up after a task is done.
abstract Integer	exitStatus(hudson.FilePath workspace) Checks whether the task has finished.
abstract void	stop(hudson.FilePath workspace) Tries to stop any running task.
abstract boolean	writeLog(hudson.FilePath workspace, OutputStream sink) Obtains any new task log output.

Methods inherited from class java.lang.Object

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

Constructor Detail

Controller

public Controller()

Method Detail

writeLog

public abstract boolean writeLog(hudson.FilePath workspace,
               OutputStream sink)
                          throws IOException,
                                 InterruptedException

Obtains any new task log output. Could use a serializable field to keep track of how much output has been previously written.

Parameters:

workspace - the workspace in use

sink - where to send new log output

Returns:

true if something was written and the controller should be resaved, false if everything is idle

Throws:

IOException

InterruptedException

exitStatus

@CheckForNull
public abstract Integer exitStatus(hudson.FilePath workspace)
                            throws IOException,
                                   InterruptedException

Checks whether the task has finished.

Parameters:

workspace - the workspace in use

Returns:

an exit code (zero is successful), or null if the task appears to still be running

Throws:

IOException

InterruptedException

stop

public abstract void stop(hudson.FilePath workspace)
                   throws IOException,
                          InterruptedException

Tries to stop any running task.

Parameters:

workspace - the workspace in use

Throws:

IOException

InterruptedException

cleanup

public abstract void cleanup(hudson.FilePath workspace)
                      throws IOException,
                             InterruptedException

Cleans up after a task is done. Should delete any temporary files created by #launch.

Parameters:

workspace - the workspace in use

Throws:

IOException

InterruptedException