net.sf.sillyexceptions
Class OutOfTheBlueException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              net.sf.sillyexceptions.OutOfTheBlueException

All Implemented Interfaces:

java.io.Serializable

public class OutOfTheBlueException

extends java.lang.RuntimeException

This exception should be used at places where you don't expect an exceptional situation to occur.

For example, sometimes you have to catch an exception (because an API demands it), while you are absolutely sure that the exception will never occur. In that case you can better:

    throw new OutOfTheBlueException("Properties could not be loaded, although they are always there.");
 

instead of:

    //This can never happen, since the properties are always there.
 

Since:

1.0

Version:

$Id: OutOfTheBlueException.java,v 1.3 2004/09/06 16:53:22 hippe Exp $

Author:

W.H. Schraal

See Also:

Serialized Form

Field Summary

Fields inherited from class java.lang.RuntimeException

Constructor Summary

OutOfTheBlueException(java.lang.String message)
Constructs a new OutOfTheBlueException with the specified detail message.

OutOfTheBlueException(java.lang.String message, java.lang.Throwable cause)
Constructs a new OutOfTheBlueException with the specified detail message and cause.

OutOfTheBlueException(java.lang.Throwable cause)
Constructs a new OutOfTheBlueException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

OutOfTheBlueException

public OutOfTheBlueException(java.lang.String message)

Constructs a new OutOfTheBlueException with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:

message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method.

OutOfTheBlueException

public OutOfTheBlueException(java.lang.String message,
                             java.lang.Throwable cause)

Constructs a new OutOfTheBlueException with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

OutOfTheBlueException

public OutOfTheBlueException(java.lang.Throwable cause)

Constructs a new OutOfTheBlueException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for exceptions that are little more than wrappers for other throwables.

Parameters:

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)