util.io

Class ExecutionHandler

java.lang.Object

util.io.ExecutionHandler

public class ExecutionHandler
extends Object

Handles the execution of external processes.

Since:

2.6.1/2.2.5

Author:

René Mach

Constructor Summary

Constructors

Constructor and Description
ExecutionHandler(String[] parameterWithProgramPath) Creates an instance of this class.
ExecutionHandler(String[] parameterWithProgramPath, File runtimeDirectory) Creates an instance of this class.
ExecutionHandler(String[] parameterWithProgramPath, String runtimeDirectory) Creates an instance of this class.
ExecutionHandler(String parameter, String programPath) Creates an instance of this class.
ExecutionHandler(String parameter, String programPath, File runtimeDirectory) Creates an instance of this class.
ExecutionHandler(String parameter, String programPath, String runtimeDirectory) Creates an instance of this class.

Method Summary

Methods

Modifier and Type	Method and Description
void	execute() Executes the given application with the given parameters in the given runtime directory.
void	execute(boolean logInputStream) Executes the given application with the given parameters in the given runtime directory.
void	execute(boolean logInputStream, boolean logErrorStream) Executes the given application with the given parameters in the given runtime directory.
void	execute(boolean logInputStream, boolean logErrorStream, String encoding) Executes the given application with the given parameters in the given runtime directory.
void	execute(boolean logInputStream, String encoding) Executes the given application with the given parameters in the given runtime directory.
void	execute(String encoding) Executes the given application with the given parameters in the given runtime directory.
int	exitValue() The exit vaule of the process.
StreamReaderThread	getErrorStreamReaderThread() Gets the error stream reader thread.
StreamReaderThread	getInputStreamReaderThread() Gets the input stream reader thread (it logs the console output of the process).
Process	getProcess() Gets the started process.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutionHandler

public ExecutionHandler(String parameter,
                String programPath)

Creates an instance of this class.

Parameters:

parameter - The parameter to parse to the application.

programPath - The path to the application.

ExecutionHandler

public ExecutionHandler(String parameter,
                String programPath,
                String runtimeDirectory)

Creates an instance of this class.

Parameters:

parameter - The parameter to parse to the application.

programPath - The path to the application.

runtimeDirectory - The runtime directory for the application.

ExecutionHandler

public ExecutionHandler(String parameter,
                String programPath,
                File runtimeDirectory)

Creates an instance of this class.

Parameters:

parameter - The parameter to parse to the application.

programPath - The path to the application.

runtimeDirectory - The runtime directory for the application.

ExecutionHandler

public ExecutionHandler(String[] parameterWithProgramPath)

Creates an instance of this class.

Parameters:

parameterWithProgramPath - The parameter to parse to the application with the path to the program.

ExecutionHandler

public ExecutionHandler(String[] parameterWithProgramPath,
                String runtimeDirectory)

Creates an instance of this class.

Parameters:

parameterWithProgramPath - The parameter to parse to the application with the path to the program.

runtimeDirectory - The runtime directory for the application.

ExecutionHandler

public ExecutionHandler(String[] parameterWithProgramPath,
                File runtimeDirectory)

Creates an instance of this class.

Parameters:

parameterWithProgramPath - The parameter to parse to the application with the path to the program.

runtimeDirectory - The runtime directory for the application.

Method Detail

execute

public void execute()
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Throws:

IOException - Thrown if something went wrong on process building.

execute

public void execute(String encoding)
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Parameters:

encoding - The encoding for the reading of the process console output.

Throws:

IOException - Thrown if something went wrong on process building.

execute

public void execute(boolean logInputStream)
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Parameters:

logInputStream - True means that the console output of the output stream of the process will be logged and can be get after the process was stopped (it's output stream is an input stream for the process starter).

Throws:

IOException - Thrown if something went wrong on process building.

execute

public void execute(boolean logInputStream,
           String encoding)
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Parameters:

logInputStream - True means that the console output of the output stream of the process will be logged and can be get after the process was stopped (it's output stream is an input stream for the process starter).

encoding - The encoding for the reading of the process console output.

Throws:

IOException - Thrown if something went wrong on process building.

execute

public void execute(boolean logInputStream,
           boolean logErrorStream)
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Parameters:

logInputStream - True means that the console output of the output stream of the process will be logged and can be get after the process was stopped (it's output stream is an input stream for the process starter).

logErrorStream - True means that the console output of the error stream of the process will be logged and can be get after the process was stopped.

Throws:

IOException - Thrown if something went wrong on process building.

execute

public void execute(boolean logInputStream,
           boolean logErrorStream,
           String encoding)
             throws IOException

Executes the given application with the given parameters in the given runtime directory.

Parameters:

logInputStream - True means that the console output of the output stream of the process will be logged and can be get after the process was stopped (it's output stream is an input stream for the process starter).

logErrorStream - True means that the console output of the error stream of the process will be logged and can be get after the process was stopped.

encoding - The encoding for the reading of the process console output.

Throws:

IOException - Thrown if something went wrong on process building.

getProcess

public Process getProcess()

Gets the started process.

Returns:

The started proccess or null if the process wasn't started.

exitValue

public int exitValue()
              throws IllegalThreadStateException

The exit vaule of the process.

Returns:

The exit value of the process.

Throws:

IllegalThreadStateException - Thrown if the process wasn't started or is not finished.

getInputStreamReaderThread

public StreamReaderThread getInputStreamReaderThread()

Gets the input stream reader thread (it logs the console output of the process).

Returns:

The input stream reader thread.

getErrorStreamReaderThread

public StreamReaderThread getErrorStreamReaderThread()

Gets the error stream reader thread.

Returns:

The error stream reader thread.