de.ipcon.tools

Class ThrowableTools

java.lang.Object

de.ipcon.tools.ThrowableTools

public class ThrowableTools
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Map	DEFAULT_KNOWN_EXCEPTION_WRAPPERS

Method Summary

Modifier and Type	Method and Description
static void	dumpJVMStack() Prints a filtered thread dump of all active threads in the JVM to System.err.
static void	dumpJVMStack(java.io.PrintStream ps) Prints a filtered thread dump of all active threads in the JVM to the specified stream.
static void	dumpStack() Prints a filtered stack dump of the calling thread to System.err.
static void	dumpStack(java.lang.String msg) Prints a filtered stack dump of the calling thread with an optional prefix message to System.err.
static void	dumpStack(java.lang.String msg, java.io.PrintStream ps) Prints a filtered stack dump of the calling thread to the specified stream.
static boolean	equals(java.lang.Throwable throwable1, java.lang.Throwable throwable2) Evaluates deep equality between two throwable hierarchies.
static void	filterAndDumpStackTrace(java.lang.String str) Reads a stacktrace given as String and dumps it to STDOUT in filtered form.
static java.lang.StackTraceElement[]	filterStackTrace(java.lang.StackTraceElement[] stack) Returns a new array containing only stack trace elements that match standard filter criteria.
static java.lang.StackTraceElement[]	filterStackTrace(java.lang.StackTraceElement[] stack, StackTraceFilter[] filters) Returns a new array containing only stack trace elements that pass all specified filter rules.
static java.lang.Throwable	filterStackTrace(java.lang.Throwable t) Filters the stack trace of a throwable and all its underlying causes using default filters.
static java.lang.Throwable	filterStackTrace(java.lang.Throwable t, StackTraceFilter[] filters) Filters the stack trace of a throwable and all its underlying causes using explicit filter rules.
static java.lang.Throwable[]	getAllCauses(java.lang.Throwable t) Collects the full causal chain of a throwable starting from the given root.
static java.lang.Throwable	getCause(java.lang.Throwable t) Resolves the underlying cause of an exception.
static java.lang.String	getCauseMethod(java.lang.Throwable t) Returns the method name needed to get the 'cause' of the given t.
static java.lang.Throwable	getCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated. Replaced by getCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.
static java.lang.Throwable	getCauseOfClass(java.lang.Throwable t, java.lang.Class clazz) Traverses the exception cause chain to locate the first instance assignable to the specified class.
static java.lang.Throwable	getDeepestCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated. Replaced by getDeepestCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.
static java.lang.Throwable	getDeepestCauseOfClass(java.lang.Throwable t, java.lang.Class clazz) Traverses the full exception cause chain to locate the innermost instance assignable to the specified class.
static java.lang.String	getErrortext(java.lang.Exception ex) Formats an exception into a persistent diagnostic text block containing its class, message, and trace.
static java.lang.String	getErrortext(java.lang.Exception ex, java.lang.String msg) Formats an exception into a persistent diagnostic text block preceded by a custom context message.
static java.lang.Throwable	getRootCause(java.lang.Throwable t) Traverses the exception cause chain to locate the ultimate root cause.
static java.lang.String	getStackTraceAsString(java.lang.Thread t) Formats the full, unfiltered stack trace of a thread as a string.
static java.lang.String	getStackTraceAsString(java.lang.Thread t, boolean filtered) Formats the current stack trace of a thread as a string, optionally applying standard filters.
static java.lang.String	getStackTraceAsString(java.lang.Thread t, OutputConfiguration outputConfig) Formats the current stack trace of a thread as a string using the specified output configuration.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t) Formats the full stack trace of a throwable as an unfiltered string.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t, boolean filtered) Formats the stack trace of a throwable as a string, optionally filtering out standard runtime noise.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t, OutputConfiguration outputConfig) Formats the stack trace of a throwable as a string using the specified output configuration.
static java.lang.StackTraceElement	getStackTraceElement(java.lang.Throwable t, java.lang.String declaringClass, java.lang.String methodName) Locates the first stack trace element within a throwable matching the specified class and method.
static java.lang.StackTraceElement	getStackTraceElement(java.lang.Throwable t, java.lang.String declaringClass, java.lang.String methodName, java.lang.String fileName) Locates the first stack trace element within a throwable matching the specified class, method, and optional filename.
static java.lang.String	getUserRelevantMessage(java.lang.Throwable t) Resolves a user-facing message from a throwable hierarchy, prioritizing runtime exceptions.
static java.lang.String	getUserRelevantMessage(java.lang.Throwable t, java.lang.Class<? extends java.lang.Throwable> preferType) Resolves a user-facing message from a throwable hierarchy using a prioritized resolution chain.
static boolean	hasCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated. Replaced by hasCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.
static boolean	hasCauseOfClass(java.lang.Throwable t, java.lang.Class clazz) Checks whether the causal chain contains an exception assignable to the specified class.
static boolean	isKnownWrapperException(java.lang.Throwable t) Determines whether the specified throwable is a standard reflection or concurrency wrapper.
static void	printStackTrace(java.lang.StackTraceElement[] stackTraceEls, java.io.PrintWriter pw) Prints raw stack trace elements to the target writer without filtering.
static void	printStackTrace(java.lang.StackTraceElement[] stackTraceEls, java.io.PrintWriter pw, OutputConfiguration outputConfig) Prints raw stack trace elements to the target writer using the specified output configuration.
static void	printStackTrace(java.lang.StackTraceElement[] stackTraceEls, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame) Prints raw stack trace elements to the target writer up to the designated frame index limit.
static void	printStackTrace(java.lang.StackTraceElement[] stackTraceEls, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Prints a slice of raw stack trace elements to the target writer.
static void	printStackTrace(java.lang.Throwable t, boolean filtered) Prints the stack trace of a throwable to System.err, optionally applying default filtering.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps) Prints the complete, unfiltered stack trace of a throwable to the target stream.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, boolean filtered) Prints the stack trace of a throwable to the target stream, optionally applying default filtering.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig) Prints the stack trace of a throwable to the target stream using the specified output configuration.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig, int upToFrame) Prints the stack trace of a throwable to the target stream up to the designated frame index limit.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Prints a slice of the stack trace of a throwable to the target stream.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw) Prints the complete, unfiltered stack trace of a throwable to the target writer.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig) Prints the stack trace of a throwable to the target writer using the specified output configuration.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame) Prints the stack trace of a throwable to the target writer up to the designated frame index limit.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Prints a slice of the stack trace of a throwable to the target writer, cascading down the causal chain.
static void	printStackTraceAsCause(java.lang.String cm, java.lang.Throwable t, java.io.PrintWriter pw, java.lang.StackTraceElement[] causedTrace, OutputConfiguration outputConfig) Prints a nested causal exception trace, trimming frames shared with the enclosing caused trace.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_KNOWN_EXCEPTION_WRAPPERS

public static final java.util.Map DEFAULT_KNOWN_EXCEPTION_WRAPPERS

Method Detail

getCause

public static java.lang.Throwable getCause(java.lang.Throwable t)

Resolves the underlying cause of an exception.

Prefers Throwable.getCause(). If null, inspects engine-specific wrapper accessors defined in CAUSE_METHODS (such as BeanShell's TargetError).

Parameters:

t - the throwable to inspect

Returns:

the resolved cause, or null if no further cause exists

getAllCauses

public static java.lang.Throwable[] getAllCauses(java.lang.Throwable t)

Collects the full causal chain of a throwable starting from the given root.

Parameters:

t - top-level throwable to inspect

Returns:

array of throwables in descending causal order; empty if t is null

getCauseMethod

public static java.lang.String getCauseMethod(java.lang.Throwable t)

Returns the method name needed to get the 'cause' of the given t.

Parameters:

t - a to get the 'cause' method of

Returns:

the name of the method needed to get the 'cause'

getRootCause

public static java.lang.Throwable getRootCause(java.lang.Throwable t)

Traverses the exception cause chain to locate the ultimate root cause.

Uses Floyd’s cycle-finding algorithm to guard against circular cause chains without heap allocations.

Parameters:

t - the throwable to inspect

Returns:

the innermost cause without a deeper cause, or null if t is null

See Also:

Floyd's Cycle-Finding Algorithm

getUserRelevantMessage

public static java.lang.String getUserRelevantMessage(java.lang.Throwable t)

Resolves a user-facing message from a throwable hierarchy, prioritizing runtime exceptions.

Parameters:

t - throwable to inspect

Returns:

extracted user-facing message, or null if t is null

See Also:

getUserRelevantMessage(Throwable, Class)

getUserRelevantMessage

public static java.lang.String getUserRelevantMessage(java.lang.Throwable t,
                                                      java.lang.Class<? extends java.lang.Throwable> preferType)

Resolves a user-facing message from a throwable hierarchy using a prioritized resolution chain.

Message resolution precedence:

1. Innermost cause matching preferType (if specified).
2. Innermost RuntimeException in the causal chain.
3. Root cause of the exception chain.

Strips backend transport prefixes (such as ServerSideException markers) before returning the final text.

Parameters:

t - throwable to inspect

preferType - preferred causal exception class to extract from; defaults to RuntimeException if null

Returns:

cleaned user-facing message, or null if t is null

hasCauseOfClass

@Deprecated
public static boolean hasCauseOfClass(java.lang.Class clazz,
                                                  java.lang.Throwable t)

Deprecated. Replaced by hasCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.

Checks whether the causal chain contains an exception of the specified type.

getCauseOfClass

@Deprecated
public static java.lang.Throwable getCauseOfClass(java.lang.Class clazz,
                                                              java.lang.Throwable t)

Deprecated. Replaced by getCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.

Resolves an underlying cause matching the specified class.

getDeepestCauseOfClass

@Deprecated
public static java.lang.Throwable getDeepestCauseOfClass(java.lang.Class clazz,
                                                                     java.lang.Throwable t)

Deprecated. Replaced by getDeepestCauseOfClass(Throwable, Class) to follow standard (subject, predicate) parameter ordering.

Resolves the deepest underlying cause matching the specified class.

hasCauseOfClass

public static boolean hasCauseOfClass(java.lang.Throwable t,
                                      java.lang.Class clazz)

Checks whether the causal chain contains an exception assignable to the specified class.

Parameters:

t - the root throwable to inspect

clazz - the target exception type to search for

Returns:

true if a matching cause exists; false otherwise

getCauseOfClass

public static java.lang.Throwable getCauseOfClass(java.lang.Throwable t,
                                                  java.lang.Class clazz)

Traverses the exception cause chain to locate the first instance assignable to the specified class.

Parameters:

t - the root throwable to inspect

clazz - the target exception type to search for

Returns:

matching causal instance, or null if not found

getDeepestCauseOfClass

public static java.lang.Throwable getDeepestCauseOfClass(java.lang.Throwable t,
                                                         java.lang.Class clazz)

Traverses the full exception cause chain to locate the innermost instance assignable to the specified class.

Parameters:

t - the root throwable to inspect

clazz - the target exception type to search for

Returns:

innermost matching causal instance, or null if not found

isKnownWrapperException

public static boolean isKnownWrapperException(java.lang.Throwable t)

Determines whether the specified throwable is a standard reflection or concurrency wrapper.

Parameters:

t - throwable to evaluate

Returns:

true if t matches a registered wrapper exception class; false otherwise

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Throwable t,
                                                     boolean filtered)

Formats the stack trace of a throwable as a string, optionally filtering out standard runtime noise.

Parameters:

t - throwable to render; returns an empty string if null

filtered - true to apply OutputConfiguration.DEFAULT_FILTERED_OUTPUT; false to retain all frames

Returns:

formatted stack trace string

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Throwable t)

Formats the full stack trace of a throwable as an unfiltered string.

Parameters:

t - throwable to render; returns an empty string if null

Returns:

complete formatted stack trace string

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Throwable t,
                                                     OutputConfiguration outputConfig)

Formats the stack trace of a throwable as a string using the specified output configuration.

Parameters:

t - throwable to render; returns an empty string if null

outputConfig - format configuration and frame filter rules; defaults to full output if null

Returns:

formatted stack trace string

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Thread t,
                                                     boolean filtered)

Formats the current stack trace of a thread as a string, optionally applying standard filters.

Parameters:

t - thread to inspect; returns an empty string if null

filtered - true to apply OutputConfiguration.DEFAULT_FILTERED_OUTPUT; false to retain all frames

Returns:

formatted stack trace string

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Thread t)

Formats the full, unfiltered stack trace of a thread as a string.

Parameters:

t - thread to inspect; returns an empty string if null

Returns:

complete formatted stack trace string

getStackTraceAsString

public static java.lang.String getStackTraceAsString(java.lang.Thread t,
                                                     OutputConfiguration outputConfig)

Formats the current stack trace of a thread as a string using the specified output configuration.

Parameters:

t - thread to inspect; returns an empty string if null

outputConfig - format configuration and frame filter rules; defaults to full output if null

Returns:

formatted stack trace string

dumpStack

public static void dumpStack()

Prints a filtered stack dump of the calling thread to System.err.

dumpStack

public static void dumpStack(java.lang.String msg)

Prints a filtered stack dump of the calling thread with an optional prefix message to System.err.

Parameters:

msg - header message to precede the dump; defaults to current thread name if null

dumpStack

public static void dumpStack(java.lang.String msg,
                             java.io.PrintStream ps)

Prints a filtered stack dump of the calling thread to the specified stream.

Parameters:

msg - header message to precede the dump; defaults to current thread name if null

ps - target print stream; defaults to System.err if null

dumpJVMStack

public static void dumpJVMStack()

Prints a filtered thread dump of all active threads in the JVM to System.err.

dumpJVMStack

public static void dumpJVMStack(java.io.PrintStream ps)

Prints a filtered thread dump of all active threads in the JVM to the specified stream.

Parameters:

ps - target print stream; defaults to System.err if null

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   boolean filtered)

Prints the stack trace of a throwable to System.err, optionally applying default filtering.

Parameters:

t - throwable to print

filtered - true to filter out framework and runtime noise; false to print all frames

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintStream ps,
                                   boolean filtered)

Prints the stack trace of a throwable to the target stream, optionally applying default filtering.

Parameters:

t - throwable to print

ps - destination print stream

filtered - true to filter out framework and runtime noise; false to print all frames

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintStream ps)

Prints the complete, unfiltered stack trace of a throwable to the target stream.

Parameters:

t - throwable to print

ps - destination print stream

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintStream ps,
                                   OutputConfiguration outputConfig)

Prints the stack trace of a throwable to the target stream using the specified output configuration.

Parameters:

t - throwable to print

ps - destination print stream

outputConfig - format configuration and frame filters; defaults to full output if null

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintStream ps,
                                   OutputConfiguration outputConfig,
                                   int upToFrame)

Prints the stack trace of a throwable to the target stream up to the designated frame index limit.

Parameters:

t - throwable to print

ps - destination print stream

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintStream ps,
                                   OutputConfiguration outputConfig,
                                   int upToFrame,
                                   int fromFrame)

Prints a slice of the stack trace of a throwable to the target stream.

Parameters:

t - throwable to print

ps - destination print stream

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

fromFrame - initial frame index to start printing from; -1 to start at index 0

printStackTraceAsCause

public static void printStackTraceAsCause(java.lang.String cm,
                                          java.lang.Throwable t,
                                          java.io.PrintWriter pw,
                                          java.lang.StackTraceElement[] causedTrace,
                                          OutputConfiguration outputConfig)

Prints a nested causal exception trace, trimming frames shared with the enclosing caused trace.

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintWriter pw)

Prints the complete, unfiltered stack trace of a throwable to the target writer.

Parameters:

t - throwable to print

pw - destination print writer

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig)

Prints the stack trace of a throwable to the target writer using the specified output configuration.

Parameters:

t - throwable to print

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig,
                                   int upToFrame)

Prints the stack trace of a throwable to the target writer up to the designated frame index limit.

Parameters:

t - throwable to print

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

printStackTrace

public static void printStackTrace(java.lang.Throwable t,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig,
                                   int upToFrame,
                                   int fromFrame)

Prints a slice of the stack trace of a throwable to the target writer, cascading down the causal chain.

Parameters:

t - throwable to print

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

fromFrame - initial frame index to start printing from; -1 to start at index 0

printStackTrace

public static void printStackTrace(java.lang.StackTraceElement[] stackTraceEls,
                                   java.io.PrintWriter pw)

Prints raw stack trace elements to the target writer without filtering.

Parameters:

stackTraceEls - array of stack trace frames to output

pw - destination print writer

printStackTrace

public static void printStackTrace(java.lang.StackTraceElement[] stackTraceEls,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig)

Prints raw stack trace elements to the target writer using the specified output configuration.

Parameters:

stackTraceEls - array of stack trace frames to output

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

printStackTrace

public static void printStackTrace(java.lang.StackTraceElement[] stackTraceEls,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig,
                                   int upToFrame)

Prints raw stack trace elements to the target writer up to the designated frame index limit.

Parameters:

stackTraceEls - array of stack trace frames to output

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

printStackTrace

public static void printStackTrace(java.lang.StackTraceElement[] stackTraceEls,
                                   java.io.PrintWriter pw,
                                   OutputConfiguration outputConfig,
                                   int upToFrame,
                                   int fromFrame)

Prints a slice of raw stack trace elements to the target writer.

Parameters:

stackTraceEls - array of stack trace frames to output

pw - destination print writer

outputConfig - format configuration and frame filters; defaults to full output if null

upToFrame - maximum frame index to print (exclusive); -1 to print through to the end

fromFrame - initial frame index to start printing from; -1 to start at index 0

filterStackTrace

public static java.lang.Throwable filterStackTrace(java.lang.Throwable t)

Filters the stack trace of a throwable and all its underlying causes using default filters.

Mutates the provided throwable in place and returns it for fluid chaining.

Parameters:

t - throwable whose traces are to be filtered; may be null

Returns:

the filtered throwable instance, or null if input was null

See Also:

StackTraceFilter.STANDARD_FILTERS

filterStackTrace

public static java.lang.Throwable filterStackTrace(java.lang.Throwable t,
                                                   StackTraceFilter[] filters)

Filters the stack trace of a throwable and all its underlying causes using explicit filter rules.

Mutates the provided throwable in place and returns it for fluid chaining.

Parameters:

t - throwable whose traces are to be filtered; may be null

filters - array of filter predicates to apply

Returns:

the filtered throwable instance, or null if input was null

filterStackTrace

public static java.lang.StackTraceElement[] filterStackTrace(java.lang.StackTraceElement[] stack)

Returns a new array containing only stack trace elements that match standard filter criteria.

Parameters:

stack - raw stack trace elements; may be null

Returns:

filtered array of stack trace elements

See Also:

StackTraceFilter.STANDARD_FILTERS

filterStackTrace

public static java.lang.StackTraceElement[] filterStackTrace(java.lang.StackTraceElement[] stack,
                                                             StackTraceFilter[] filters)

Returns a new array containing only stack trace elements that pass all specified filter rules.

Parameters:

stack - raw stack trace elements; may be null

filters - array of filter predicates to apply

Returns:

filtered array of stack trace elements

getStackTraceElement

public static java.lang.StackTraceElement getStackTraceElement(java.lang.Throwable t,
                                                               java.lang.String declaringClass,
                                                               java.lang.String methodName)

Locates the first stack trace element within a throwable matching the specified class and method.

Parameters:

t - throwable to inspect

declaringClass - fully qualified class name to match

methodName - method name to match

Returns:

matching stack trace element, or null if not found

getStackTraceElement

public static java.lang.StackTraceElement getStackTraceElement(java.lang.Throwable t,
                                                               java.lang.String declaringClass,
                                                               java.lang.String methodName,
                                                               java.lang.String fileName)

Locates the first stack trace element within a throwable matching the specified class, method, and optional filename.

Parameters:

t - throwable to inspect

declaringClass - fully qualified class name to match

methodName - method name to match

fileName - source filename to match, or null to ignore file origin

Returns:

matching stack trace element, or null if not found

filterAndDumpStackTrace

public static void filterAndDumpStackTrace(java.lang.String str)

Reads a stacktrace given as String and dumps it to STDOUT in filtered form. Mainly for debugging purposes.

Parameters:

str - the stacktrace as a String

getErrortext

public static java.lang.String getErrortext(java.lang.Exception ex)

Formats an exception into a persistent diagnostic text block containing its class, message, and trace.

Parameters:

ex - exception to serialize

Returns:

formatted diagnostic error block

getErrortext

public static java.lang.String getErrortext(java.lang.Exception ex,
                                            java.lang.String msg)

Formats an exception into a persistent diagnostic text block preceded by a custom context message.

Parameters:

ex - exception to serialize

msg - additional context message prefix, or null

Returns:

formatted diagnostic error block

equals

public static boolean equals(java.lang.Throwable throwable1,
                             java.lang.Throwable throwable2)

Evaluates deep equality between two throwable hierarchies.

Compares exception types, messages, stack trace element sequences, recursive cause structures, and suppressed exception arrays.

Parameters:

throwable1 - first throwable hierarchy to compare

throwable2 - second throwable hierarchy to compare

Returns:

true if both exception trees are structurally and content-identical; false otherwise