xapi.io.api

Class StringReader

java.lang.Object

xapi.io.api.StringReader

All Implemented Interfaces:

LineReader

public class StringReader
extends Object
implements LineReader

An implementation of LineReader designed to stream lines of text to one or more delegate LineReaders. It also stores all input so that a new LineReader can be added at any time, and it will still receive all text that was streamed to this reader.

This is handy for such use cases as forwarding an external processes std in and std out, where we might need to add a listener to the process after it has already started.

This class has also been enhanced with the waitToEnd() method, which will block until the line producer (such as a thread streaming input from an external process) has signalled that the stream is finished by calling onEnd().

Author:

"James X. Nelson (james@wetheinter.net)"

Constructor Summary

Constructors

Constructor and Description
StringReader()

Method Summary

Modifier and Type	Method and Description
void	forwardTo(LineReader callback)
void	onEnd()
protected void	onEnd0()
void	onLine(String line)
void	onStart()
String	toString()
void	waitToEnd()
void	waitToEnd(long timeout, int nanos)

Methods inherited from class java.lang.Object

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

Constructor Detail

StringReader

public StringReader()

Method Detail

onStart

public void onStart()

Specified by:

onStart in interface LineReader

onLine

public void onLine(String line)

Specified by:

onLine in interface LineReader

onEnd

public final void onEnd()

Specified by:

onEnd in interface LineReader

onEnd0

protected void onEnd0()

toString

public String toString()

Overrides:

toString in class Object

forwardTo

public void forwardTo(LineReader callback)

waitToEnd

public void waitToEnd()
               throws InterruptedException

Throws:

InterruptedException

waitToEnd

public void waitToEnd(long timeout,
                      int nanos)
               throws InterruptedException

Throws:

InterruptedException