001package Torello.HTML;
002
003import Torello.HTML.NodeSearch.InclusiveException;
004
005/**
006 * An exception that's mostly identical to the {@code class InclusiveException}, but is thrown only
007 * when attempting to instantiate a Singleton HTML Element with a closing-tag forward-slash.
008 * 
009 * <BR /><BR />"Inclusive" searches are searches for the {@code Vector}-Contents between an opening
010 * and closing {@code TagNode} pair.  Such a search fails when an HTML singleton / self-closing tag
011 * is passed to the search method.  Such errors should be reported using the
012 * {@link InclusiveException} in the {@code NodeSearch} package.  The {@code SingletonException} is
013 * used specifically for problems <I>instantiating a singleton tag.</I>
014 */
015public class SingletonException extends RuntimeException
016{
017    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX> */
018    public static final long serialVersionUID = 1;
019
020    /** Constructs a {@code SingletonException} with no detail message. */
021    public SingletonException()
022    { super(); }
023
024    /**
025     * Constructs a {@code SingletonException} with the specified detail message.
026     * @param message the detail message.
027     */
028    public SingletonException(String message)
029    { super(message); }
030
031    /**
032     * Constructs a new exception with the specified detail message and cause.
033     * 
034     * <BR /><BR /><B CLASS=JDDescLabel>NOTE:</B>
035     * 
036     * <BR /><BR />The detail message associated with cause is not automatically incorporated into
037     * this exception's detail message.
038     * 
039     * @param message The detail message (which is saved for later retrieval by the
040     * {@code Throwable.getMessage()} method).
041     * 
042     * @param cause the cause (which is saved for later retrieval by the
043     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
044     * cause is nonexistent or unknown).
045     */
046    public SingletonException(String message, Throwable cause)
047    { super(message, cause); }
048
049    /**
050     * Constructs a new exception with the specified cause and a detail message of
051     * {@code (cause==null ? null : cause.toString())} (which typically contains the class and
052     * detail message of cause).
053     * 
054     * <BR /><BR />This constructor is useful for exceptions that are little more than wrappers for
055     * other throwables.
056     * 
057     * @param cause The cause (which is saved for later retrieval by the
058     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
059     * cause is nonexistent or unknown).
060     */
061    public SingletonException(Throwable cause)
062    { super(cause); }
063}