001package Torello.HTML;
002
003/**
004 * Thrown by class {@code Scrape} when a scrape-download fails.
005 * 
006 * <BR /><BR />In Java-HTML class {@code Scrape} it is used, specifically, when the line-numbers or
007 * the starting-ending {@code String}-Tags do not correspond to the page that is downloaded from a
008 * URL.  This exception may be generalized for use with any kind of HTML-Scraping errors.
009 */
010public class ScrapeException extends IllegalStateException
011{
012    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX> */
013    public static final long serialVersionUID = 1;
014
015    /** Constructs a {@code ScrapeException} with no detail message. */
016    public ScrapeException()
017    { super(); }
018
019    /**
020     * Constructs a {@code ScrapeException} with the specified detail message.
021     * @param message the detail message.
022     */
023    public ScrapeException(String message)
024    { super(message); }
025
026    /**
027     * Constructs a new exception with the specified detail message and cause.
028     * 
029     * <BR /><BR /><B CLASS=JDDescLabel>NOTE:</B>
030     * 
031     * <BR /><BR />The detail message associated with cause is not automatically incorporated into
032     * this exception's detail message.
033     * 
034     * @param message The detail message (which is saved for later retrieval by the
035     * {@code Throwable.getMessage()} method).
036     * 
037     * @param cause the cause (which is saved for later retrieval by the
038     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
039     * cause is nonexistent or unknown.)
040     */
041    public ScrapeException(String message, Throwable cause)
042    { super(message, cause); }
043
044    /**
045     * Constructs a new exception with the specified cause and a detail message of
046     * {@code (cause==null ? null : cause.toString())} (which typically contains the class and
047     * detail message of cause).  This constructor is useful for exceptions that are little more
048     * than wrappers for other throwables.
049     * 
050     * @param cause The cause (which is saved for later retrieval by the
051     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
052     * cause is nonexistent or unknown.)
053     */
054    public ScrapeException(Throwable cause)
055    { super(cause); }
056}