de.ipcon.tools.io

Class ServerSideException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

de.ipcon.tools.io.ServerSideException

All Implemented Interfaces:

SecureExternalizable, java.io.Externalizable, java.io.Serializable

Direct Known Subclasses:

PersistenceException, SessionNotFoundException

public class ServerSideException
extends java.lang.RuntimeException
implements java.io.Serializable, java.io.Externalizable, SecureExternalizable

A wrapper for server-side exceptions that avoids direct references to classes or other exceptions.

This class addresses the issue of potential class loading or serialization problems when transmitting exceptions across network boundaries. Instead of directly referencing classes or exceptions in the cause chain, it decomposes the causes into individual strings and reconstructs them on the receiving end using a dedicated wrapper class. This ensures that the exception information can be safely transmitted and reconstructed without encountering class definition conflicts or inconsistencies.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServerSideException.Cause A wrapper for the cause chain of a ServerSideException, allowing reconstruction of the stack trace on the remote end.

Constructor Summary

Constructors

Constructor and Description
ServerSideException()
ServerSideException(java.lang.String s)
ServerSideException(java.lang.String s, java.lang.Throwable _cause)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getMessage()
java.lang.String	getMessageWithoutBackendPrefix()
java.lang.Throwable	getRootCauseIfOfType(java.lang.Class clazz) Retrieves the root cause of this exception on the server if it was or is of the specified type.
static java.lang.Throwable	getRootCauseIfOfType(java.lang.Throwable t, java.lang.Class clazz) Retrieves the root cause of the given Throwable if it was or is of the specified type.
void	readExternal(java.io.ObjectInput s)
void	readInstance(SecureObjectInputI s) Reads an instance of this class from the given SecureObjectInputI without using readObject.
static java.lang.String	stripBackendPrefix(java.lang.String s)
void	writeExternal(java.io.ObjectOutput s)
void	writeInstance(SecureObjectOutputI s) Writes an instance of this class to the given SecureObjectOutputI without using writeObject.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerSideException

public ServerSideException()

ServerSideException

public ServerSideException(java.lang.String s)

ServerSideException

public ServerSideException(java.lang.String s,
                           java.lang.Throwable _cause)

Method Detail

stripBackendPrefix

public static final java.lang.String stripBackendPrefix(java.lang.String s)

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

getMessageWithoutBackendPrefix

public java.lang.String getMessageWithoutBackendPrefix()

readInstance

public void readInstance(SecureObjectInputI s)
                  throws java.io.IOException

Description copied from interface: SecureExternalizable

Reads an instance of this class from the given SecureObjectInputI without using readObject.

Specified by:

readInstance in interface SecureExternalizable

Throws:

java.io.IOException

writeInstance

public void writeInstance(SecureObjectOutputI s)
                   throws java.io.IOException

Description copied from interface: SecureExternalizable

Writes an instance of this class to the given SecureObjectOutputI without using writeObject.

Specified by:

writeInstance in interface SecureExternalizable

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput s)
                  throws java.io.IOException

Specified by:

readExternal in interface java.io.Externalizable

Throws:

java.io.IOException

writeExternal

public void writeExternal(java.io.ObjectOutput s)
                   throws java.io.IOException

Specified by:

writeExternal in interface java.io.Externalizable

Throws:

java.io.IOException

getRootCauseIfOfType

public java.lang.Throwable getRootCauseIfOfType(java.lang.Class clazz)

Retrieves the root cause of this exception on the server if it was or is of the specified type. Keep in mind that the exception might just be a ServerSideException.Cause, not the actual exception type.

Parameters:

clazz - The expected type of the original exception on the server.

Returns:

The root cause if it is of the specified type, null otherwise.

getRootCauseIfOfType

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

Retrieves the root cause of the given Throwable if it was or is of the specified type. Keep in mind that the exception might just be a ServerSideException.Cause, not the actual exception type.

Parameters:

t - The Throwable to check for a root cause.

clazz - The expected type of the root cause.

Returns:

The root cause if it was or is of the specified type, null otherwise.