Package 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
    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 Details

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