1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package Torello.HTML.Tools.JavaDoc;

/**
 * Exception parsing a Java Source Code File.
 * 
 * <BR /><BR /><EMBED CLASS="external-html" DATA-FILE-ID="EXPM">
 *
 * <BR /><BR />This exception throws when there are errors parsing a {@code '.java'} source code
 * file.  This exception is used while the internal JavaParser-Bridge is running.  If an exception
 * is thrown while parsing a source-code file, it will be wrapped with a
 * {@code SourceCodeParseException}.  In that case, retrieving the {@code getCause() Throwable}
 * to review the Exception Cause Chain will produce the underlying JavaParser-Bridge Exception.
 */
public class SourceCodeParseException extends ParseException
{
    /** <EMBED CLASS="external-html" DATA-FILE-ID="SVUIDEX">  */
    public static final long serialVersionUID = 1;

    /**
     * Constructs a new exception with the specified detail message, and one {@code public, final} 
     * parameter: {@code srcFileName}.
     * 
     * @param message the detail message.
     * 
     * @param signature This is the "signature" of the entity that failed.
     * 
     * @see ParseException#signature
     */
    public SourceCodeParseException(String message, String signature)
    { super(message, signature); }

    /**
     * Constructs a new exception with the specified detail message, cause-chain throwable, and
     * one {@code public, final} parameter: {@code srcFileName}.
     * 
     * @param message The detail message (which is saved for later retrieval by the
     * {@code Throwable.getMessage()} method).
     * 
     * @param cause the cause (which is saved for later retrieval by the
     * {@code Throwable.getCause()} method). 
     * (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
     * 
     * @param signature This is the "signature" of the entity that failed.
     * 
     * @see ParseException#signature
     */
    public SourceCodeParseException(String message, Throwable cause, String signature)
    { super(message, cause, signature); }
}