de.ipcon.tools

Class IRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

de.ipcon.tools.IRuntimeException

All Implemented Interfaces:

InspectableThrowableI, java.io.Serializable

Direct Known Subclasses:

AbstractScriptException, AttributeIsReadOnlyException, BackendException, BotNotKnownException, CodebausteinException, ContentHandlerException, DataIntegrityException, DBMan.SaveResultException, EntityInstantiationException, ExceptionWithFilteredStacktrace, FillBOException, FutureEvaluationException, ImmutableInstanceException, IncompatibleProtocolException, InitializationException, InvalidObjectStateException, IParsedValueException, LicenseException, MEXParseException, MEXUnavailableException, MissingBLOBException, MultipleMatchingBOsException, NavigationActionException, NotImplementedException, NotIncludedInTransactionException, NotLoadedByTransactionException, ObjectNotFoundException, OperationCanceledException, ReflectionException, ResolveException, SchemaLoadingException, SchemaViolationException, ScriptedAttributeInitializationException, ServerConnectionException, ServerConnectionTimeoutException, ServerRestartRequiredException, StubAttributeIsReadOnlyException, SyncServiceTools.InvalidSyncAccountConfigurationException, TransactionIncludeException, WrappedThrowableException, XMLDefinitionException

public class IRuntimeException
extends java.lang.RuntimeException
implements java.io.Serializable, InspectableThrowableI

Extended version of standard RuntimeException with better "cause" handling (also handles TargetException or CastorPersistenceException for example). Additionally provides various tools methods for filtering and converting stacktraces. Originally introduced to provide Java 1.4 "cause" functionality without actually requiring Java 1.4.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IRuntimeException() Constructs a new `IRuntimeException` with the specified detail message (optional).
IRuntimeException(java.lang.String message)
IRuntimeException(java.lang.String message, java.lang.Throwable cause) Constructs a new `IRuntimeException` with the specified detail message and cause.
IRuntimeException(java.lang.Throwable cause) Constructs a new `IRuntimeException` with the specified cause and a detail message of {@code (cause==null ?

Method Summary

Modifier and Type	Method and Description
static IRuntimeException	createFromStackTraceString(java.lang.String str) Deprecated. please use {@link #ofStackTraceString(String) instead
static void	dumpJVMStack() Deprecated.
static void	dumpJVMStack(java.io.PrintStream ps) Deprecated.
static void	dumpStack() Deprecated.
static void	dumpStack(java.lang.String msg) Deprecated.
static void	dumpStack(java.lang.String msg, java.io.PrintStream ps) Deprecated.
static void	filterAndDumpStackTrace(java.lang.String str) Deprecated.
IRuntimeException	filterStackTrace() non-static version of filterStackTrace(Throwable)
static java.lang.Throwable	filterStackTrace(java.lang.Throwable t) Deprecated.
static java.lang.Throwable[]	getAllCauses(java.lang.Throwable t) Deprecated.
static java.lang.Throwable	getCause(java.lang.Throwable t) Deprecated.
static java.lang.String	getCauseMethod(java.lang.Throwable t) Deprecated.
static java.lang.Throwable	getCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated.
static java.lang.Throwable	getDeepestCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated.
static java.lang.String	getErrortext(java.lang.Exception ex) Deprecated.
static java.lang.String	getErrortext(java.lang.Exception ex, java.lang.String msg) Deprecated.
static java.lang.Throwable	getRootCause(java.lang.Throwable t) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Thread t) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Thread t, boolean filtered) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Thread t, OutputConfiguration outputConfig) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t, boolean filtered) Deprecated.
static java.lang.String	getStackTraceAsString(java.lang.Throwable t, OutputConfiguration outputConfig) Deprecated.
static java.lang.StackTraceElement	getStackTraceElement(java.lang.Throwable t, java.lang.String declaringClass, java.lang.String methodName) Deprecated.
static java.lang.StackTraceElement	getStackTraceElement(java.lang.Throwable t, java.lang.String declaringClass, java.lang.String methodName, java.lang.String fileName) Deprecated.
static boolean	hasCauseOfClass(java.lang.Class clazz, java.lang.Throwable t) Deprecated.
static boolean	isKnownWrapperException(java.lang.Throwable t) Deprecated.
static IRuntimeException	ofStackTraceString(java.lang.String str) Creates an IRuntimeException instance from a given stacktrace string.
void	printStackTrace(java.io.PrintStream ps) Prints stacktrace of this IRuntimeException to the given PrintStream, filtering out certain stack frames if requested.
void	printStackTrace(java.io.PrintStream ps, OutputConfiguration outputConfig)
void	printStackTrace(java.io.PrintWriter pw) Prints stacktrace of this IRuntimeException to the given PrintWriter, filtering out certain stack frames if requested.
void	printStackTrace(java.io.PrintWriter pw, OutputConfiguration outputConfig)
static void	printStackTrace(java.lang.StackTraceElement[] stacktrace, java.io.PrintWriter pw) Deprecated.
static void	printStackTrace(java.lang.StackTraceElement[] stacktrace, java.io.PrintWriter pw, OutputConfiguration outputConfig) Deprecated.
static void	printStackTrace(java.lang.StackTraceElement[] stacktrace, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame) Deprecated.
static void	printStackTrace(java.lang.StackTraceElement[] stacktrace, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Deprecated.
static void	printStackTrace(java.lang.Throwable t, boolean filtered) Deprecated.
void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, boolean filtered) Deprecated.
void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig, int upToFrame) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintStream ps, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame) Deprecated.
static void	printStackTrace(java.lang.Throwable t, java.io.PrintWriter pw, OutputConfiguration outputConfig, int upToFrame, int fromFrame) Deprecated.
static void	printStackTraceAsCause(java.lang.String cm, java.lang.Throwable t, java.io.PrintWriter pw, java.lang.StackTraceElement[] causedTrace, OutputConfiguration outputConfig) Deprecated.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.ipcon.tools.InspectableThrowableI

getCauseOfClass, getDeepestCauseOfClass, getRootCause, getThisAsThrowable, hasCauseOfClass, printStackTrace

Constructor Detail

IRuntimeException

public IRuntimeException(java.lang.Throwable cause)

Constructs a new `IRuntimeException` with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for runtime exceptions that are little more than wrappers for other throwables.

Parameters:

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

IRuntimeException

public IRuntimeException()

Constructs a new `IRuntimeException` with the specified detail message (optional).

This constructor allows for the possibility of setting the cause of this exception later using the `initCause()` method, which can be useful in testing scenarios.

**Note:** This constructor was added, as the NetRexx transpiler handles an optional 'cause' parameter (method IRuntimeException(s = String null, cause = Throwable null) by passing `null` as 2nd parameter to super, which would prevent calling the `initCause()` method later on.

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method) (optional).

IRuntimeException

public IRuntimeException(java.lang.String message)

IRuntimeException

public IRuntimeException(java.lang.String message,
                         java.lang.Throwable cause)

Constructs a new `IRuntimeException` with the specified detail message and cause.

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Method Detail

ofStackTraceString

public static IRuntimeException ofStackTraceString(java.lang.String str)

Creates an IRuntimeException instance from a given stacktrace string. Mainly for convenience handling of debugging output.

Parameters:

str - the stacktrace as a String

Returns:

the matching new IRuntimeException

getCause

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

Deprecated.

getAllCauses

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

Deprecated.

getCauseMethod

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

Deprecated.

getRootCause

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

Deprecated.

hasCauseOfClass

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

Deprecated.

getCauseOfClass

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

Deprecated.

getDeepestCauseOfClass

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

Deprecated.

isKnownWrapperException

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

Deprecated.

getStackTraceAsString

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

Deprecated.

getStackTraceAsString

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

Deprecated.

getStackTraceAsString

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

Deprecated.

getStackTraceAsString

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

Deprecated.

getStackTraceAsString

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

Deprecated.

getStackTraceAsString

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

Deprecated.

dumpStack

@Deprecated
public static void dumpStack()

Deprecated.

dumpStack

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

Deprecated.

dumpStack

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

Deprecated.

dumpJVMStack

@Deprecated
public static void dumpJVMStack()

Deprecated.

dumpJVMStack

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTraceAsCause

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

printStackTrace

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

Deprecated.

filterStackTrace

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

Deprecated.

getStackTraceElement

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

Deprecated.

getStackTraceElement

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

Deprecated.

filterAndDumpStackTrace

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

Deprecated.

createFromStackTraceString

@Deprecated
public static IRuntimeException createFromStackTraceString(java.lang.String str)

Deprecated. please use {@link #ofStackTraceString(String) instead

getErrortext

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

Deprecated.

getErrortext

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

Deprecated.

printStackTrace

public void printStackTrace(java.io.PrintStream ps)

Prints stacktrace of this IRuntimeException to the given PrintStream, filtering out certain stack frames if requested.

Specified by:

printStackTrace in interface InspectableThrowableI

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

ps - the PrintStream to print to

outputConfig - a OutputConfiguration to configure text written to s

printStackTrace

public void printStackTrace(java.io.PrintStream ps,
                            OutputConfiguration outputConfig)

Specified by:

printStackTrace in interface InspectableThrowableI

printStackTrace

public void printStackTrace(java.io.PrintWriter pw)

Prints stacktrace of this IRuntimeException to the given PrintWriter, filtering out certain stack frames if requested.

Specified by:

printStackTrace in interface InspectableThrowableI

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

pw - the PrintWriter to print to

outputConfig - a OutputConfiguration to configure text written to s

printStackTrace

public void printStackTrace(java.io.PrintWriter pw,
                            OutputConfiguration outputConfig)

Specified by:

printStackTrace in interface InspectableThrowableI

filterStackTrace

public IRuntimeException filterStackTrace()

non-static version of filterStackTrace(Throwable)

Specified by:

filterStackTrace in interface InspectableThrowableI

Returns:

this