com.microsoft.alm.oauth2.useragent.subprocess

Interface TestableProcess

All Known Implementing Classes:

DefaultProcess

public interface TestableProcess

Supports the abstraction around sub-processes, to make it easier to unit test programs that launch other programs by simulating said launch with test doubles.

See Also:

TestableProcessFactory

Method Summary

Modifier and Type	Method and Description
InputStream	getErrorStream() Gets the error stream of the subprocess.
InputStream	getInputStream() Gets the input stream of the subprocess.
OutputStream	getOutputStream() Gets the output stream of the subprocess.
int	waitFor() causes the current thread to wait, if necessary, until the process represented by this TestableProcess object has terminated.

Method Detail

getErrorStream

InputStream getErrorStream()

Gets the error stream of the subprocess. The stream obtains data piped from the error output stream of the process represented by this TestableProcess object.

Implementation note: It is a good idea for the input stream to be buffered.

Returns:

the input stream connected to the error stream of the subprocess.

getInputStream

InputStream getInputStream()

Gets the input stream of the subprocess. The stream obtains data piped from the standard output stream of the process represented by this TestableProcess object.

Implementation note: It is a good idea for the input stream to be buffered.

Returns:

the input stream connected to the normal output of the subprocess.

getOutputStream

OutputStream getOutputStream()

Gets the output stream of the subprocess. Output to the stream is piped into the standard input stream of the process represented by this TestableProcess object.

Implementation note: It is a good idea for the output stream to be buffered.

Returns:

the output stream connected to the normal input of the subprocess.

waitFor

int waitFor()
     throws InterruptedException

causes the current thread to wait, if necessary, until the process represented by this TestableProcess object has terminated. This method returns immediately if the subprocess has already terminated. If the subprocess has not yet terminated, the calling thread will be blocked until the subprocess exits.

Returns:

the exit value of the process. By convention, 0 indicates normal termination.

Throws:

InterruptedException - if the current thread is interrupted by another thread while it is waiting, then the wait is ended and an InterruptedException is thrown.