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     * 
021     * @param message the detail message.
022     */
023    public EmptyListException(String message)
024    { super(message); }
025
026    /**
027     * Constructs a new {@code EmptyListException} 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 EmptyListException(String message, Throwable cause)
042    { super(message, cause); }
043
044    /**
045     * Constructs a new {@code EmptyListException} 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 EmptyListException(Throwable cause)
055    { super(cause); }
056}