org.jboss.util
Interface NestedThrowable

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractNestedThrowable, CoercionException, DataConversionException, NestedError, NestedException, NestedRuntimeException, NestedSQLException, NotCoercibleException, PropertyError, PropertyException, UnexpectedThrowable

public interface NestedThrowable
extends Serializable

Interface which is implemented by all the nested throwable flavors.

Version:

$Revision: 1.6.18.1 $

Author:

Jason Dillon

Nested Class Summary

static class

NestedThrowable.Util Utilitiy methods for the various flavors of NestedThrowable.

Field Summary

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

Throwable	getCause() Return the nested Throwable.
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

Throwable getNested()

Return the nested throwable.

Returns:

Nested throwable.

getCause

Throwable getCause()

Return the nested Throwable.

For JDK 1.4 compatibility.

Returns:

Nested Throwable.