org.spincast.plugins.processutils

Interface ProcessExecutionHandler

All Known Subinterfaces:

HttpServerProcessHandlerExecutionHandler

All Known Implementing Classes:

ProcessExecutionHandlerDefault, ProcessExecutionHandlerSync

public interface ProcessExecutionHandler

Handler to be inform of an exit code, an exception and to be able to kill the started process.

Method Summary

Modifier and Type	Method and Description
boolean	isProcessAlive() Returns true if the process is alive;
void	killProcess() Kill the process.
void	onEnd() Always called at the end, whether the process exited or an exception occured.
void	onExit(int exitVal) Called when the process exits.
void	onLaunchException(Exception ex) Called if an exception occured during the launch of the program.
void	onSystemErr(String line) Called when a line is written to the standard errors by the created process.
void	onSystemOut(String line) Called when a line is written to the standard output by the created process.
void	onTimeoutException() Called if the execution of the program exceeds the specified timeout.
void	setProcessAndProcessKiller(Process process, ProcessKiller processKiller) Internal use.

Method Detail

setProcessAndProcessKiller

void setProcessAndProcessKiller(Process process,
                                ProcessKiller processKiller)

Internal use.

Will be called automatically when the process is created.

isProcessAlive

boolean isProcessAlive()

Returns true if the process is alive;

onLaunchException

void onLaunchException(Exception ex)

Called if an exception occured during the launch of the program.

onTimeoutException

void onTimeoutException()

Called if the execution of the program exceeds the specified timeout.

onExit

void onExit(int exitVal)

Called when the process exits. In general, a 0 value means that no error occured.

Note that this method will not be called if there is an exception while launching the program! In that case, onLaunchException(Exception) will be called instead.

onEnd

void onEnd()

Always called at the end, whether the process exited or an exception occured.

onSystemOut

void onSystemOut(String line)

Called when a line is written to the standard output by the created process.

onSystemErr

void onSystemErr(String line)

Called when a line is written to the standard errors by the created process.

killProcess

void killProcess()

Kill the process.