com.sun.jbi.ui.common

Class JBIRemoteException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.sun.jbi.ui.common.JBIRemoteException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ManagementRemoteException

public class JBIRemoteException
extends Exception
implements Serializable

A Remote Exception class that saves the cause exception stack trace in a buffer for serialization. By throwing this exception on jmx server side on mbean operations and attributes, we don't have to include the cause exception classes on the client side. This class also allows the server side code to add error code, so that the remote client can get the error code and display the message from its local bundle.

Author:

graj

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String[]	mCauseMessageTrace aCuase Message trace
protected StringBuffer	mCauseStackTrace aCuase StackTrace

Constructor Summary

Constructors

Constructor and Description
JBIRemoteException(JBIRemoteException exception) Creates a new instance of JBIException.
JBIRemoteException(String aMessage) Creates a new instance of JBIException with an exception message.
JBIRemoteException(String aMessage, Throwable aCause) Creates a new instance of JBIException with the specified message and cause.
JBIRemoteException(Throwable aCause) Creates a new instance of JBIException with the specified cause.

Method Summary

Methods

Modifier and Type	Method and Description
JBIManagementMessage	extractJBIManagementMessage() retrieves the exception message and try to construct the jbi mgmt message
static JBIRemoteException	filterJmxExceptions(Exception jmxEx) filters the jmx exception and wraps the root cause user exception int the JBIRemoteException
String[]	getCauseMessageTrace() gets the cuase trace in a string buffer
StringBuffer	getCauseStackTrace() gets the cuase trace in a string buffer
String	getMessage() Returns the detail message string of this throwable.
void	initCauseTrace(Throwable aCause) initializes the stacktrace and messages from cause
void	printStackTrace(PrintStream s) override method
void	printStackTrace(PrintWriter s) override method

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

mCauseStackTrace

protected StringBuffer mCauseStackTrace

aCuase StackTrace

mCauseMessageTrace

protected String[] mCauseMessageTrace

aCuase Message trace

Constructor Detail

JBIRemoteException

public JBIRemoteException(String aMessage)

Creates a new instance of JBIException with an exception message.

Parameters:

aMessage - String describing this exception.

JBIRemoteException

public JBIRemoteException(Throwable aCause)

Creates a new instance of JBIException with the specified cause.

Parameters:

aCause - Throwable which represents an underlying problem (or null).

JBIRemoteException

public JBIRemoteException(String aMessage,
                  Throwable aCause)

Creates a new instance of JBIException with the specified message and cause.

Parameters:

aMessage - String describing this exception.

aCause - Throwable which represents an underlying problem (or null).

JBIRemoteException

public JBIRemoteException(JBIRemoteException exception)

Creates a new instance of JBIException.

Parameters:

exception -

Method Detail

initCauseTrace

public void initCauseTrace(Throwable aCause)

initializes the stacktrace and messages from cause

Parameters:

aCause - a cause

getMessage

public String getMessage()

Returns the detail message string of this throwable.

Overrides:

getMessage in class Throwable

Returns:

the detail message string of this Throwable instance (which may be null). + the cause messages

getCauseMessageTrace

public String[] getCauseMessageTrace()

gets the cuase trace in a string buffer

Returns:

trace in a string buffer

getCauseStackTrace

public StringBuffer getCauseStackTrace()

gets the cuase trace in a string buffer

Returns:

trace in a string buffer

printStackTrace

public void printStackTrace(PrintWriter s)

override method

Overrides:

printStackTrace in class Throwable

Parameters:

s - writer

printStackTrace

public void printStackTrace(PrintStream s)

override method

Overrides:

printStackTrace in class Throwable

Parameters:

s - stream

extractJBIManagementMessage

public JBIManagementMessage extractJBIManagementMessage()

retrieves the exception message and try to construct the jbi mgmt message

Returns:

JBIManagementMessage object

filterJmxExceptions

public static JBIRemoteException filterJmxExceptions(Exception jmxEx)

filters the jmx exception and wraps the root cause user exception int the JBIRemoteException

Parameters:

jmxEx - exception

Returns:

remote exception