Class UnexpectedExceptionError

java.lang.Object

java.lang.Throwable

java.lang.Error

java.lang.AssertionError

org.tquadrat.foundation.exception.UnexpectedExceptionError

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ImpossibleExceptionError

@ClassVersion(sourceVersion="$Id: UnexpectedExceptionError.java 1163 2026-03-20 15:28:33Z tquadrat $")
@API(status=STABLE,
     since="0.0.5")
public sealed class UnexpectedExceptionError
extends AssertionError
permits ImpossibleExceptionError

This implementation of Error should be thrown in all cases where an unexpected exception was caught. Unlike an ImpossibleExceptionError, the exception is possible, but not expected – probably because the programmer has taken (at least thought to have …) appropriate precautions against its occurrence. An example for this could be an implementation of clone() for a particular class: with implementing that method (and declaring the interface Cloneable …), instances of that class do support cloning and therefore that exception should not be thrown. Unfortunately, changes somewhere else in the source might prevent one of the attributes of the respective class from being cloned, so that exception could be thrown again …

Another example could be this code sequence:

…
final var file = new File( … );
if( file.exists() )
{
    try( final var inputStream = new FileInputStream( file ) )
    {
        …
    }
    catch( final FileNotFoundException e )
    {
        throw new UnexpectedExceptionError( e );
    }
}

Although the code checked that the file exists, it could have vanished unexpectedly just before it was opened.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: UnexpectedExceptionError.java 1163 2026-03-20 15:28:33Z tquadrat $

Since:

0.0.5

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	MSG_UnexpectedException	The message for this exception.

Constructor Summary

Constructors

Constructor	Description
UnexpectedExceptionError(String message, Throwable cause)	Creates a new instance of the Error.
UnexpectedExceptionError(Throwable cause)	Creates a new instance of the Error.

Method Summary

Methods inherited from class Throwable

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

Methods inherited from class Object

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

Field Details

MSG_UnexpectedException

private static final String MSG_UnexpectedException

The message for this exception.

See Also:

• Constant Field Values

Constructor Details

UnexpectedExceptionError

public UnexpectedExceptionError(Throwable cause)

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

Parameters:

cause - The causing exception.

UnexpectedExceptionError

public UnexpectedExceptionError(String message,
 Throwable cause)

Creates a new instance of the Error. 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.