org.jboss.util

Interface NestedThrowable

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

AbstractNestedThrowable, NestedError, NestedException, NestedRuntimeException, NestedSQLException, PropertyError, PropertyException, UnexpectedThrowable

public interface NestedThrowable
extends java.io.Serializable

Interface which is implemented by all the nested throwable flavors.

Version:

$Revision$

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	NestedThrowable.Util Utilitiy methods for the various flavors of NestedThrowable.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DETECT_DUPLICATE_NESTING A system wide flag to enable or disable checking of parent and child types to detect uneeded nesting
static boolean	NESTED_TRACE_ENABLED A system wide flag to enable or disable printing of the nested detail throwable traces.
static boolean	PARENT_TRACE_ENABLED A system wide flag to enable or disable printing of the parent throwable traces.

Method Summary

Modifier and Type	Method and Description
java.lang.Throwable	getCause() Return the nested Throwable.
java.lang.Throwable	getNested() Return the nested throwable.

Field Detail

PARENT_TRACE_ENABLED

static final boolean PARENT_TRACE_ENABLED

A system wide flag to enable or disable printing of the parent throwable traces.

This value is set from the system property org.jboss.util.NestedThrowable.parentTraceEnabled or if that is not set defaults to true.

NESTED_TRACE_ENABLED

static final boolean NESTED_TRACE_ENABLED

A system wide flag to enable or disable printing of the nested detail throwable traces.

This value is set from the system property org.jboss.util.NestedThrowable.nestedTraceEnabled or if that is not set defaults to true unless using JDK 1.4 with PARENT_TRACE_ENABLED set to false, then false since there is a native mechansim for this there.

Note then when running under 1.4 is is not possible to disable the nested trace output, since that is handled by java.lang.Throwable which we delegate the parent printing to.

DETECT_DUPLICATE_NESTING

static final boolean DETECT_DUPLICATE_NESTING

A system wide flag to enable or disable checking of parent and child types to detect uneeded nesting

This value is set from the system property org.jboss.util.NestedThrowable.detectDuplicateNesting or if that is not set defaults to true.

Method Detail

getNested

java.lang.Throwable getNested()

Return the nested throwable.

Returns:

Nested throwable.

getCause

java.lang.Throwable getCause()

Return the nested Throwable.

For JDK 1.4 compatibility.

Returns:

Nested Throwable.