iaik.ixsil.exceptions

Class IXSILException

java.lang.Object

java.lang.Throwable

java.lang.Exception

iaik.ixsil.exceptions.IXSILException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

AlgorithmException, AlgorithmFactoryException, CanonicalXMLSerializerException, DOMUtilsException, ExternalReferenceResolverException, InitException, InternalReferenceResolverException, KeyManagerException, KeyProviderException, ManifestException, ReferenceException, SignatureException, SignatureHandlerException, SignedInfoException, TransformInstructionException, URIException, UtilsException, X509TrustManagerException, XPathUtilsException

public class IXSILException
extends java.lang.Exception

Base class for all Exceptions used within IXSIL. Defines their common behaviour.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.ResourceBundle	exceptionMessages_ Contains the ResourceBundle for the exception messages.
protected java.lang.String	messageId_ The exception message id.
protected java.lang.Throwable	wrappedThrowable_ Wrapped Throwable.
protected static java.lang.String	wrappingMessage_ String displayed between the stack trace print of wrapped Exceptions.

Constructor Summary

Constructors

Constructor and Description
IXSILException() Simple constructor with no arguments.
IXSILException(java.lang.String messageId) Simple constructor with a message identifier argument.
IXSILException(java.lang.String messageId, java.lang.Object[] messageParameters) Constructor with a message identifier argument.
IXSILException(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.
IXSILException(java.lang.String messageId, java.lang.Throwable wrapped) Constructor with a message identifier and a wrapped Throwable as arguments.
IXSILException(java.lang.Throwable wrapped) Constructor with a wrapped Throwable as argument.

Method Summary

Methods

Modifier and Type	Method and Description
protected static java.lang.String	getExceptionMessage(java.lang.String messageId) Looks up the exception message for a specified message id, provided by a ResourceBundle.
java.lang.String	getMessageId() Gets the message identifier for this exception.
static void	init(java.lang.String languageCode, java.lang.String countryCode) Initializes the IXSIL exception handling.
void	printStackTrace() Prints the stack trace to System.err.
void	printStackTrace(java.io.PrintStream ps) Prints the stack trace to the specified PrintStream.
void	printStackTrace(java.io.PrintWriter pw) Prints the stack trace 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

Field Detail

exceptionMessages_

protected static java.util.ResourceBundle exceptionMessages_

Contains the ResourceBundle for the exception messages.

wrappingMessage_

protected static java.lang.String wrappingMessage_

String displayed between the stack trace print of wrapped Exceptions.

messageId_

protected java.lang.String messageId_

The exception message id.

wrappedThrowable_

protected java.lang.Throwable wrappedThrowable_

Wrapped Throwable. Is set if a corresponding constructor is used to create the exception.

Constructor Detail

IXSILException

public IXSILException()

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

IXSILException

public IXSILException(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(), printStackTrace(PrintStream), printStackTrace(PrintWriter)

IXSILException

public IXSILException(java.lang.String messageId)

Simple constructor with a message identifier argument. Resolves the message id into a human readable text message and invokes the Exception.Exception(String) constructor.

Parameters:

messageId - the message identifier of the exception.

IXSILException

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

Constructor with a message identifier and a wrapped Throwable as arguments. Resolves the message id into a human readable text message.

Parameters:

messageId - The message identifier for the exception.

wrapped - The Throwable used by the printStackTrace methods.

See Also:

IXSILException(String), IXSILException(Throwable)

IXSILException

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

Constructor with a message identifier argument. The Java 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 - Paramters to be incorporated into the resolved message.

See Also:

IXSILException(String)

IXSILException

public IXSILException(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 - Paramters to be incorporated into the message.

See Also:

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

Method Detail

init

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

Initializes the IXSIL exception handling. This method will be internally used by the main initialization class. If one of the specified parameters equals null, the default exception message resource bundle will be 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.

getExceptionMessage

protected static java.lang.String getExceptionMessage(java.lang.String messageId)

Looks up the exception message for a specified message id, provided by a ResourceBundle. This mechanism has been chosen to support internationalization.

Parameters:

messageId - The exception message id, e. g. "Algorithm.01".

Returns:

the exception message corresponding with the specified message id.

getMessageId

public java.lang.String getMessageId()

Gets the message identifier for this exception.

Returns:

the message identifier for this exception.

printStackTrace

public void printStackTrace()

Prints the stack trace to System.err. If a wrapped Throwable has been specified by the constructor, also 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 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 to the specified PrintWriter.

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

pw - Specifies the destination for printing.

See Also:

printStackTrace()