net.aichler.jupiter.internal.listeners

Class OutputCapture

java.lang.Object

net.aichler.jupiter.internal.listeners.OutputCapture

public class OutputCapture
extends java.lang.Object

Hijacks the systems standard output and error streams on a per-thread basis and redirects to given streams.

Constructor Summary

Constructors

Constructor and Description
OutputCapture()

Method Summary

Modifier and Type	Method and Description
static void	deregister() Deregister streams for the current thread, and restore the previous if any.
static void	install(StreamPair system) Possibly installs delegating print streams.
static void	register(java.io.PrintStream out, java.io.PrintStream err) Register streams for the current thread.
static void	uninstall() Possibly restores the original print streams.

Methods inherited from class java.lang.Object

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

Constructor Detail

OutputCapture

public OutputCapture()

Method Detail

install

public static void install(StreamPair system)

Possibly installs delegating print streams.

Checks whether the current thread is the first thread to install output capturing. If true, the original print streams will be overwritten by custom, delegating print streams.

In any case this method stores the specified system stream pair, so that it can be successfully restored later on.

Parameters:

system - A stream pair containing the original system streams.

See Also:

register(PrintStream, PrintStream)

uninstall

public static void uninstall()

Possibly restores the original print streams.

Checks whether the current thread is the last thread which previously installed output capturing. If true, then the original print streams will be restored.

See Also:

install(StreamPair)

register

public static void register(java.io.PrintStream out,
                            java.io.PrintStream err)

Register streams for the current thread.

Parameters:

out - The standard output stream which is to be registered.

err - The error stream which is to be registered.

Throws:

java.lang.IllegalStateException - If output capturing has not been installed.

deregister

public static void deregister()

Deregister streams for the current thread, and restore the previous if any.