com.microsoft.alm.oauth2.useragent.subprocess

Class ProcessCoordinator

java.lang.Object

com.microsoft.alm.oauth2.useragent.subprocess.ProcessCoordinator

public class ProcessCoordinator
extends Object

Provides a façade for working with a subprocess where a request is sent via command-line parameters and/or a string sent to the child process's standard input (stdin) stream and a response is read from the child process's standard output (stdout) and standard error (stderr) streams.

Constructor Summary

Constructors

Constructor and Description
ProcessCoordinator(TestableProcess process) Initializes the ProcessCoordinator with an instance of TestableProcess.

Method Summary

Modifier and Type	Method and Description
String	getStdErr() Gets the contents of the child process's standard error stream.
String	getStdOut() Gets the contents of the child process's standard output stream.
void	print(String s) Writes the specified string to the child process's stdin stream.
void	println(String s) Writes the specified string to the child process's stdin stream, followed by a new line.
int	waitFor() Causes the current thread to wait, if necessary, until the child process has terminated and both its stdout and stderr streams have been consumed.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProcessCoordinator

public ProcessCoordinator(TestableProcess process)

Initializes the ProcessCoordinator with an instance of TestableProcess.

Parameters:

process - a process which has already been started

Method Detail

print

public void print(String s)

Writes the specified string to the child process's stdin stream.

Parameters:

s - The string to write.

println

public void println(String s)

Writes the specified string to the child process's stdin stream, followed by a new line.

Parameters:

s - The string to write.

waitFor

public int waitFor()
            throws InterruptedException

Causes the current thread to wait, if necessary, until the child process has terminated and both its stdout and stderr streams have been consumed.

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.

getStdOut

public String getStdOut()

Gets the contents of the child process's standard output stream.

Returns:

a string representing stdout

getStdErr

public String getStdErr()

Gets the contents of the child process's standard error stream.

Returns:

a string representing stderr