Package Torello.Java

Class ExceptionCheckError

  • All Implemented Interfaces:
    java.io.Serializable
    Direct Known Subclasses:
    ArrayExpectedError
    public class ExceptionCheckError
extends java.lang.Error
    This class inherits class 'Error' because it is intended to mean that a more serious problems has just occurred. Checking for exceptions is quite common in Java, so much so that automated exception check methods can be very useful - they provide consistenly worded messages that do not need to be repeated over and over in the code.

    WHEN WRITING AN EXCEPTION CHECK METHOD - IT BECOMES POSSIBLE FOR A SITUATION TO ARISE WHERE THE INPUTS TO THAT METHOD ARE, THEMSELVES, INCORRECTLY FORMED. This is not a common situation, but when writing a "Method for Checking Exception Cases", if a programmer has provided erroneous parameter values to that check, then throwing this error relays that the exception check mechanism, itself, has bugs! (And hopefully, the appropriate amount of severity conveyed).
    See Also:
    Serialized Form


    • Constructor Summary

      Constructors 
      Constructor Description
      ExceptionCheckError()
      Constructs an 'ExceptionCheckError' with no detail message.
      ExceptionCheckError​(String message)
      Constructs an 'ExceptionCheckError' with the specified detail message.
      ExceptionCheckError​(String message, Throwable cause)
      Constructs a new error with the specified detail 'message' and 'cause'.
      ExceptionCheckError​(Throwable cause)
      Constructs a new error with the specified 'cause' and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

    • 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 Detail

      • serialVersionUID

        🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static final long serialVersionUID
        This fulfils the SerialVersion UID requirement for all classes that implement Java's interface java.io.Serializable. Using the Serializable Implementation offered by java is very easy, and can make saving program state when debugging a lot easier. It can also be used in place of more complicated systems like "hibernate" to store data as well.

        Note that Java's java.lang.Exception and java.lang.Error classes implement the Serializable interface, and a warning-free build expects this field be defined here.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         public static final long serialVersionUID = 1;

    • Constructor Detail

      • ExceptionCheckError

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public ExceptionCheckError​(java.lang.String message)
        Constructs an 'ExceptionCheckError' with the specified detail message.
        Parameters:
        message - the detail message.

      • ExceptionCheckError

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public ExceptionCheckError​(java.lang.String message,
                           java.lang.Throwable cause)
        Constructs a new error with the specified detail 'message' and 'cause'.

        NOTE: The detail message associated with 'cause' is not automatically incorporated in this error's detail message.
        Parameters:
        message - The detail message (which is saved for later retrieval by th 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.)

      • ExceptionCheckError

        🡅  ⇈  ⮫ 🗕  🗗  🗖 
        public ExceptionCheckError​(java.lang.Throwable cause)
        Constructs a new error 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 errors 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.)