info.monitorenter.util

类 ExceptionUtil

java.lang.Object

info.monitorenter.util.ExceptionUtil

public final class ExceptionUtil
extends Object

Nice static helpers for working with Strings.

Maybe not always the fastest solution to call in here, but working. Also usable for seeing examples and cutting code for manual inlining.

版本:

$Revision: 1.1 $

作者:

Achim.Westermann@gmx.de

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	ExceptionUtil.InputStreamTracer Helper runnable to find a String within an output stream.

构造器概要

构造器

构造器和说明
ExceptionUtil()

方法概要

方法

限定符和类型	方法和说明
static InputStream	captureSystemErrForDebuggingPurposesOnly(boolean teeToOriginalSysErr) Returns an input stream that contains what will written in this Application to System.err.
static InputStream	captureSystemOutForDebuggingPurposesOnly(boolean teeToOriginalSysOut) Returns an input stream that contains what will written in this Application to System.out.
static void	dumpThreadStack(PrintStream outprint) Prints out the current Thread stack to the given stream.
static ExceptionUtil.InputStreamTracer	findMatchInSystemErr(String expectMatch) Returns an instance to a runnable running in a separate Thread that tries to match the expected output in System.err.
static ExceptionUtil.InputStreamTracer	findMatchInSystemOut(String expectMatch) Returns an instance to a runnable running in a separate Thread that tries to match the expected output in System.out.
static ExceptionUtil	instance() Returns the singleton instance of this class.

从类继承的方法 java.lang.Object

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

构造器详细资料

ExceptionUtil

public ExceptionUtil()

方法详细资料

captureSystemErrForDebuggingPurposesOnly

public static InputStream captureSystemErrForDebuggingPurposesOnly(boolean teeToOriginalSysErr)
                                                            throws IOException

Returns an input stream that contains what will written in this Application to System.err.

Caution
If you do not consume the bytes to read from the result you may block the whole application. Do only use this for debugging purposes or end to end test code!

Attempting to read from the result in the same thread that called here is not recommended as it may deadlock the thread. Also the thread reading from the stream result should not write anything to System.err.

Prefer using findMatchInSystemErr(String) to avoid deadlocks.

参数:

teeToOriginalSysErr - if true, all writes to the newly installed System.err will also sent to the original one (thus be visible on the console if the original one was untouched before).

返回:

an input stream that contains what will written in this Application to System.err.

抛出:

IOException - if something goes wrong.

captureSystemOutForDebuggingPurposesOnly

public static InputStream captureSystemOutForDebuggingPurposesOnly(boolean teeToOriginalSysOut)
                                                            throws IOException

Returns an input stream that contains what will written in this Application to System.out.

Caution
If you do not consume the bytes to read from the result you may block the whole application. Do only use this for debugging purposes or end to end test code!

Attempting to read from the result in the same thread that called here is not recommended as it may deadlock the thread. Also the thread reading from the stream result should not write anything to System.out.

Prefer using findMatchInSystemOut(String) to avoid deadlocks.

参数:

teeToOriginalSysOut - if true, all writes to the newly installed System.out will also sent to the original one (thus be visible on the console if the original one was untouched before).

返回:

an input stream that contains what will written in this Application to System.out.

抛出:

IOException - if something goes wrong.

findMatchInSystemOut

public static ExceptionUtil.InputStreamTracer findMatchInSystemOut(String expectMatch)
                                                            throws IOException

Returns an instance to a runnable running in a separate Thread that tries to match the expected output in System.out.

Ensure that you found the expected String in the input stream given by calling ExceptionUtil.InputStreamTracer.isMatched(). But take into account that it is time - critical (concurrency) if your result was found.

Prefer this instead of captureSystemOutForDebuggingPurposesOnly(boolean) as this will avoid blocking your application.

返回:

an instance to a runnable running in a separate Thread that tries to match the expected output in System.out.

抛出:

IOException - if something goes wrong.

findMatchInSystemErr

public static ExceptionUtil.InputStreamTracer findMatchInSystemErr(String expectMatch)
                                                            throws IOException

Returns an instance to a runnable running in a separate Thread that tries to match the expected output in System.err.

Ensure that you found the expected String in the input stream given by calling ExceptionUtil.InputStreamTracer.isMatched(). But take into account that it is time - critical (concurrency) if your result was found.

Prefer this instead of captureSystemErrForDebuggingPurposesOnly(boolean) as this will avoid blocking your application.

返回:

an instance to a runnable running in a separate Thread that tries to match the expected output in System.out.

抛出:

IOException - if something goes wrong.

dumpThreadStack

public static void dumpThreadStack(PrintStream outprint)

Prints out the current Thread stack to the given stream.

参数:

outprint - the stream to print to (e.g. System.err).

另请参阅:

Thread.getStackTrace()

instance

public static ExceptionUtil instance()

Returns the singleton instance of this class.

This method is useless for now as all methods are static. It may be used in future if VM-global configuration will be put to the state of the instance.

返回:

the singleton instance of this class.