Module org.itsallcode.process

Package org.itsallcode.process

Class SimpleProcess<T>

java.lang.Object

org.itsallcode.process.SimpleProcess<T>

Type Parameters:

T - type of stdout and stderr, e.g. String.

public class SimpleProcess<T>
extends Object

Provides control over native processes.

Method Summary

Modifier and Type	Method	Description
void	destroy()	Kill the process.
void	destroyForcibly()	Kill the process forcibly.
int	exitValue()	Get the exit value of the process.
T	getStdErr()	Get the standard error of the process.
T	getStdOut()	Get the standard output of the process.
boolean	isAlive()	Check wether the process is alive.
long	pid()	Get the process ID.
void	waitForSuccessfulTermination()	Wait until the process terminates successfully with exit code 0.
int	waitForTermination()	Wait until the process has terminated.
void	waitForTermination(int expectedExitCode)	Wait until the process terminates successfully with the given exit code.
void	waitForTermination(Duration timeout)	Wait until the process terminates with the given timeout.

Methods inherited from class java.lang.Object

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

Method Details

waitForTermination

public int waitForTermination()

Wait until the process has terminated.

Returns:

exit code

See Also:

• Process.waitFor()

waitForSuccessfulTermination

public void waitForSuccessfulTermination()

Wait until the process terminates successfully with exit code 0.

Throws:

IllegalStateException - if exit code is not equal to 0.

See Also:

• waitForTermination()

waitForTermination

public void waitForTermination(int expectedExitCode)

Wait until the process terminates successfully with the given exit code.

Parameters:

expectedExitCode - expected exit code

Throws:

IllegalStateException - if exit code is not equal to the given expected exit code.

See Also:

• waitForTermination(int)

waitForTermination

public void waitForTermination(Duration timeout)

Wait until the process terminates with the given timeout.

Parameters:

timeout - maximum time to wait for the termination

Throws:

IllegalStateException - if process does not exit within the given timeout.

See Also:

• Process.waitFor(long, TimeUnit)

getStdOut

public T getStdOut()

Get the standard output of the process.

Returns:

standard output

getStdErr

public T getStdErr()

Get the standard error of the process.

Returns:

standard error

isAlive

public boolean isAlive()

Check wether the process is alive.

Returns:

true if the process has not yet terminated

See Also:

• Process.isAlive()

exitValue

public int exitValue()

Get the exit value of the process.

Returns:

exit value

See Also:

• Process.exitValue()

pid

public long pid()

Get the process ID.

Returns:

process ID

See Also:

• Process.pid()

destroy

public void destroy()

Kill the process.

See Also:

• Process.destroy()

destroyForcibly

public void destroyForcibly()

Kill the process forcibly.

See Also:

• Process.destroyForcibly()