org.jenkinsci.plugins.durabletask

Class FileMonitoringTask.FileMonitoringController

java.lang.Object

org.jenkinsci.plugins.durabletask.Controller

org.jenkinsci.plugins.durabletask.FileMonitoringTask.FileMonitoringController

All Implemented Interfaces:

Serializable

Enclosing class:

FileMonitoringTask

protected static class FileMonitoringTask.FileMonitoringController
extends Controller

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FileMonitoringController(hudson.FilePath ws)

Method Summary

Modifier and Type	Method and Description
void	cleanup(hudson.FilePath workspace) Cleans up after a task is done.
hudson.FilePath	controlDir(hudson.FilePath ws) Directory in which this controller can place files.
Integer	exitStatus(hudson.FilePath workspace, hudson.Launcher launcher) Checks whether the task has finished.
String	getDiagnostics(hudson.FilePath workspace, hudson.Launcher launcher) Should be overridden to provide specific information about the status of an external process, for diagnostic purposes.
hudson.FilePath	getLogFile(hudson.FilePath workspace) File in which the stdout/stderr (or, if DurableTask.captureOutput() is called, just stderr) is written.
byte[]	getOutput(hudson.FilePath workspace, hudson.Launcher launcher) Obtain the process output.
hudson.FilePath	getOutputFile(hudson.FilePath workspace) File in which the stdout is written, if DurableTask.captureOutput() is called.
hudson.FilePath	getResultFile(hudson.FilePath workspace) File in which the exit code of the process should be reported.
void	stop(hudson.FilePath workspace, hudson.Launcher launcher) Tries to stop any running task.
boolean	writeLog(hudson.FilePath workspace, OutputStream sink) Obtains any new task log output.

Methods inherited from class org.jenkinsci.plugins.durabletask.Controller

exitStatus, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

FileMonitoringController

protected FileMonitoringController(hudson.FilePath ws)
                            throws IOException,
                                   InterruptedException

Throws:

IOException

InterruptedException

Method Detail

writeLog

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

Description copied from class: Controller

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

Specified by:

writeLog in class Controller

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

public Integer exitStatus(hudson.FilePath workspace,
                          hudson.Launcher launcher)
                   throws IOException,
                          InterruptedException

Description copied from class: Controller

Checks whether the task has finished.

Overrides:

exitStatus in class Controller

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

getOutput

public byte[] getOutput(hudson.FilePath workspace,
                        hudson.Launcher launcher)
                 throws IOException,
                        InterruptedException

Description copied from class: Controller

Obtain the process output. Intended for use after Controller.exitStatus(FilePath, Launcher) has returned a non-null status. The result is undefined if DurableTask.captureOutput() was not called before launch; generally an IOException will result.

Overrides:

getOutput in class Controller

Parameters:

workspace - the workspace in use

launcher - a way to start processes

Returns:

the output of the process as raw bytes (may be empty but not null)

Throws:

IOException

InterruptedException

stop

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

Description copied from class: Controller

Tries to stop any running task.

Overrides:

stop in class Controller

Parameters:

workspace - the workspace in use

launcher - a way to start processes

Throws:

IOException

InterruptedException

cleanup

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

Description copied from class: Controller

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).

Specified by:

cleanup in class Controller

Parameters:

workspace - the workspace in use

Throws:

IOException

InterruptedException

controlDir

public hudson.FilePath controlDir(hudson.FilePath ws)
                           throws IOException,
                                  InterruptedException

Directory in which this controller can place files. Unique among all the controllers sharing the same workspace.

Throws:

IOException

InterruptedException

getResultFile

public hudson.FilePath getResultFile(hudson.FilePath workspace)
                              throws IOException,
                                     InterruptedException

File in which the exit code of the process should be reported.

Throws:

IOException

InterruptedException

getLogFile

public hudson.FilePath getLogFile(hudson.FilePath workspace)
                           throws IOException,
                                  InterruptedException

File in which the stdout/stderr (or, if DurableTask.captureOutput() is called, just stderr) is written.

Throws:

IOException

InterruptedException

getOutputFile

public hudson.FilePath getOutputFile(hudson.FilePath workspace)
                              throws IOException,
                                     InterruptedException

File in which the stdout is written, if DurableTask.captureOutput() is called.

Throws:

IOException

InterruptedException

getDiagnostics

public String getDiagnostics(hudson.FilePath workspace,
                             hudson.Launcher launcher)
                      throws IOException,
                             InterruptedException

Description copied from class: Controller

Should be overridden to provide specific information about the status of an external process, for diagnostic purposes.

Overrides:

getDiagnostics in class Controller

Returns:

Object.toString() by default

Throws:

IOException

InterruptedException