Class HTMLNotFoundException

  • All Implemented Interfaces:
    java.io.Serializable
    public class HTMLNotFoundException
extends java.lang.RuntimeException
    Indicates that an HTML segment, or a single HTML-Tag, was not found at a particular location on an HTML Page-Vector where that piece of HTML was expected.

    One of the more difficult issues that can happen when writing HTML Methods that parse and search for sections and elements that are not actually present on the page or sub-page being searched. If a section of HTML does not contain an element that a programmer expects it to contain, any search method that returns a DotPair would return 'null'.

    Rather than allowing a method to throw an unintended NullPointerException just because the 'Find' returned a null reference - it is better to check the result of a search, and if the section was not found to throw an HTMLNotFoundException.
    See Also:
    Serialized Form


    • Field Summary

       
      Serializable ID
      Modifier and Type Field
      static long serialVersionUID

    • Constructor Summary

      Constructors 
      Constructor Description
      HTMLNotFoundException()
      Constructs an HTMLNotFoundException with no detail message.
      HTMLNotFoundException​(String message)
      Constructs an HTMLNotFoundException with the specified detail message.
      HTMLNotFoundException​(String message, Throwable cause)
      Constructs a new exception with the specified detail message and cause.
      HTMLNotFoundException​(Throwable cause)
      Constructs a new exception 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

      • HTMLNotFoundException

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

      • HTMLNotFoundException

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

        NOTE:

        The detail message associated with cause is not automatically incorporated into 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.)

      • HTMLNotFoundException

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