com.entrust.toolkit.xencrypt.exceptions

Class XMLERuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.entrust.toolkit.xencrypt.exceptions.XMLERuntimeException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

XMLEIllegalArgumentException

public class XMLERuntimeException
extends java.lang.RuntimeException

This is the base class for Runtime exceptions thrown by XMLE.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
XMLERuntimeException() Simple constructor with no arguments — Invokes the Exception() constructor.
XMLERuntimeException(java.lang.String messageId) Simple constructor with a message identifier argument.
XMLERuntimeException(java.lang.String messageId, java.lang.Object[] messageParameters) Constructor with a message identifier argument.
XMLERuntimeException(java.lang.String message, java.lang.Object[] messageParameters, java.lang.Throwable wrapped) Constructor with a message identifier, message parameters and a wrapped Throwable as arguments.
XMLERuntimeException(java.lang.String messageId, java.lang.Throwable wrapped) Constructor with a message identifier and a wrapped Throwable as arguments.
XMLERuntimeException(java.lang.Throwable wrapped) Constructor with a wrapped Throwable as argument.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getMessageId() Retrieves the message identifier for this exception.
static void	init(java.lang.String languageCode, java.lang.String countryCode) Initializes the XMLE runtime exception handling.
void	printStackTrace() Prints the stack trace of the XMLERuntimeException to System.err.
void	printStackTrace(java.io.PrintStream ps) Prints the stack trace of the XMLERuntimeException to the specified PrintStream.
void	printStackTrace(java.io.PrintWriter pw) Prints the stack trace of the XMLERuntimeException to the specified PrintWriter .

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLERuntimeException

public XMLERuntimeException()

Simple constructor with no arguments — Invokes the Exception() constructor.

XMLERuntimeException

public XMLERuntimeException(java.lang.Throwable wrapped)

Constructor with a wrapped Throwable as argument.

The Throwable is used by the printStackTrace methods.

Parameters:

wrapped - the Throwable used by the printStackTrace methods

See Also:

printStackTrace()

XMLERuntimeException

public XMLERuntimeException(java.lang.String messageId)

Simple constructor with a message identifier argument.

Resolves the message id into a text message and invokes the Exception(String) constructor.

Parameters:

messageId - the message identifier for the exception.

XMLERuntimeException

public XMLERuntimeException(java.lang.String messageId,
                            java.lang.Throwable wrapped)

Constructor with a message identifier and a wrapped Throwable as arguments.

Parameters:

messageId - the message identifier for the exception

wrapped - the Throwable used by the printStackTrace methods

See Also:

XMLERuntimeException(String), XMLERuntimeException(Throwable)

XMLERuntimeException

public XMLERuntimeException(java.lang.String messageId,
                            java.lang.Object[] messageParameters)

Constructor with a message identifier argument.

The Java java.text.MessageFormat meachanism is used to incorporate the values of the given Object array into the resolved message.

Parameters:

messageId - the message identifier for the exception

messageParameters - parameters to be incorporated into the resolved message

See Also:

XMLERuntimeException(String)

XMLERuntimeException

public XMLERuntimeException(java.lang.String message,
                            java.lang.Object[] messageParameters,
                            java.lang.Throwable wrapped)

Constructor with a message identifier, message parameters and a wrapped Throwable as arguments.

Parameters:

message - the message identifier for the exception

wrapped - the Throwable used by the printStackTrace methods

messageParameters - parameters to be incorporated into the message

See Also:

XMLERuntimeException(String, Object[]), XMLERuntimeException(Throwable)

Method Detail

init

public static void init(java.lang.String languageCode,
                        java.lang.String countryCode)

Initializes the XMLE runtime exception handling.

This method is used internally used by the main initialization class. If one of the specified parameters equals null, the default exception message resource bundle is opened.

Parameters:

languageCode - the ISO language code for selecting the exception message resource bundle

countryCode - The ISO country code for selecting the exception message resource bundle

getMessageId

public java.lang.String getMessageId()

Retrieves the message identifier for this exception.

Returns:

the message identifier for this exception.

printStackTrace

public void printStackTrace()

Prints the stack trace of the XMLERuntimeException to System.err.

If a wrapped Throwable has been specified by the constructor, the stack trace of this wrapped Throwable will be printed.

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream ps)

Prints the stack trace of the XMLERuntimeException to the specified PrintStream.

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

ps - specifies the destination for printing

See Also:

printStackTrace()

printStackTrace

public void printStackTrace(java.io.PrintWriter pw)

Prints the stack trace of the XMLERuntimeException to the specified PrintWriter .

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

pw - specifies the destination for printing

See Also:

printStackTrace()