001package Torello.Java;
002
003/**
004 * Intended to signal that a required-parameter or configuration has been passed a Data-Structure
005 * that is an empty or null list.  Currently, this exception is utilized by the {@code 'Build'}
006 * package to signal that a required list of data, passed as a configuration, was passed an empty
007 * list.
008 */
009public class EmptyListException extends IllegalArgumentException
010{
011    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX>  */
012    public static final long serialVersionUID = 1;
013    
014    /** Constructs a {@code EmptyListException} with no detail message. */
015    public EmptyListException()
016    { super(); }
017
018    /**
019     * Constructs a {@code EmptyListException} with the specified detail message.
020     * @param message the detail message.
021     */
022    public EmptyListException(String message)
023    { super(message); }
024
025    /**
026     * Constructs a new {@code EmptyListException} with the specified detail message and cause.
027     * 
028     * <BR /><BR /><DIV CLASS=JDHint>
029     * <B STYLE='color:red;'>Note:</B> The detail message associated with cause is not
030     * automatically incorporated into this exception's detail message.
031     * </DIV>
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 EmptyListException(String message, Throwable cause)
041    { super(message, cause); }
042
043    /**
044     * Constructs a new {@code EmptyListException} 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).  This constructor is useful for exceptions that are little more
047     * than wrappers for other throwables.
048     * 
049     * @param cause The cause (which is saved for later retrieval by the
050     * {@code Throwable.getCause()} method).  (A null value is permitted, and indicates that the
051     * cause is nonexistent or unknown.)
052     */
053    public EmptyListException(Throwable cause)
054    { super(cause); }
055}