001package Torello.HTML;
002
003/**
004 * This can be used to catch different types of exceptions using the same code-branch, since
005 * it is the parent-class of several 'Node Expected Exceptions'.
006 * 
007 * <BR /><BR />A "node expected" exception means that an HTML-Page {@code Vector} contained a
008 * {@code TextNode} where it expected to find {@code TagNode}, for instance.  It may also be used
009 * to indicate that an "Opening Tag" was found when a "Closing Tag" was expected (or vice-versa!)
010 */
011public abstract class NodeExpectedException extends RuntimeException
012{
013    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX> */
014    public static final long serialVersionUID = 1;
015
016    /** Constructs a {@code NodeExpectedException} with no detail message. */
017    public NodeExpectedException()
018    { super(); }
019
020    /**
021     * Constructs a {@code NodeExpectedException} with the specified detail message.
022     * @param message the detail message.
023     */
024    public NodeExpectedException(String message)
025    { super(message); }
026
027    /**
028     * Constructs a new exception with the specified detail message and cause.
029     * 
030     * <BR /><BR /><B>NOTE:</B> The detail message associated with cause is not automatically
031     * incorporated in this exception's detail message.
032     * 
033     * @param message The detail message (which is saved for later retrieval by the
034     * {@code Throwable.getMessage()} method).
035     * 
036     * @param cause the cause (which is saved for later retrieval by the
037     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
038     * cause is nonexistent or unknown.)
039     */
040    public NodeExpectedException(String message, Throwable cause)
041    { super(message, cause); }
042
043    /**
044     * Constructs a new exception with the specified cause and a detail message of
045     * {@code (cause==null ? null : cause.toString())} (which typically contains the class and
046     * detail message of cause).
047     * 
048     * This constructor is useful for exceptions that are little more than wrappers for other
049     * throwables.
050     * 
051     * @param cause The cause (which is saved for later retrieval by the
052     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
053     * cause is nonexistent or unknown.)
054     */
055    public NodeExpectedException(Throwable cause)
056    { super(cause); }
057}