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

Modifier and Type	Method and Description
abstract void	cleanup(hudson.FilePath workspace) Cleans up after a task is done.
Integer	exitStatus(hudson.FilePath workspace) Deprecated. use exitStatus(FilePath, Launcher) instead
Integer	exitStatus(hudson.FilePath workspace, hudson.Launcher launcher) Checks whether the task has finished.
void	stop(hudson.FilePath workspace) Deprecated. use stop(FilePath, Launcher) instead
void	stop(hudson.FilePath workspace, hudson.Launcher launcher) 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 Integer exitStatus(hudson.FilePath workspace,
                                        hudson.Launcher launcher)
                                 throws IOException,
                                        InterruptedException

Checks whether the task has finished.

Parameters:

workspace - the workspace in use

launcher - a way to start processes

Returns:

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

Throws:

IOException

InterruptedException

exitStatus

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

Deprecated. use exitStatus(FilePath, Launcher) instead

Throws:

IOException

InterruptedException

stop

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

Tries to stop any running task.

Parameters:

workspace - the workspace in use

launcher - a way to start processes

Throws:

IOException

InterruptedException

stop

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

Deprecated. use stop(FilePath, Launcher) instead

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 DurableTask.launch(hudson.EnvVars, hudson.FilePath, hudson.Launcher, hudson.model.TaskListener).

Parameters:

workspace - the workspace in use

Throws:

IOException

InterruptedException