Module org.tquadrat.foundation.base

Package org.tquadrat.foundation.exception

Class ImpossibleExceptionError

java.lang.Object

java.lang.Throwable

java.lang.Error

java.lang.AssertionError

org.tquadrat.foundation.exception.UnexpectedExceptionError

org.tquadrat.foundation.exception.ImpossibleExceptionError

All Implemented Interfaces:

Serializable

@ClassVersion(sourceVersion="$Id: ImpossibleExceptionError.java 1060 2023-09-24 19:21:40Z tquadrat $")
@API(status=STABLE,
     since="0.0.5")
public final class ImpossibleExceptionError
extends UnexpectedExceptionError

This implementation of Error should be thrown in all cases where an exception was caught that seemed to be impossible to be thrown. An example for this is the method String::getBytes( encoding ) for the encoding == "UTF-8" that should never throw an UnsupportedEncodingException because the encoding UTF-8 is mandatory for all implementations of Java.

This is different from the UnexpectedExceptionError as that is possible in general, but not in the particular context.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: ImpossibleExceptionError.java 1060 2023-09-24 19:21:40Z tquadrat $

Since:

0.0.5

See Also:

• Serialized Form

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.exception.ImpossibleExceptionError"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final String	MSG_ImpossibleException	The text for the default message.

Constructor Summary

Constructors

Constructor	Description
ImpossibleExceptionError(String message, Throwable cause)	Creates a new instance of ImpossibleExceptionError.
ImpossibleExceptionError(Throwable cause)	Creates a new instance of ImpossibleExceptionError.

Method Summary

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Details

MSG_ImpossibleException

public static final String MSG_ImpossibleException

The text for the default message.

See Also:

• Constant Field Values

Constructor Details

ImpossibleExceptionError

public ImpossibleExceptionError(Throwable cause)

Creates a new instance of ImpossibleExceptionError. The message is a constant, only the causing exception can be given.

Parameters:

cause - The causing exception.

ImpossibleExceptionError

public ImpossibleExceptionError(String message,
 Throwable cause)

Creates a new instance of ImpossibleExceptionError. This constructor should be used in cases where an enhanced message is useful or necessary.

Parameters:

message - The message for the error.

cause - The causing exception.