bsh

Class ParseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

bsh.EvalError

bsh.ParseException

All Implemented Interfaces:

java.io.Serializable

public class ParseException
extends EvalError

This exception is thrown when parse errors are encountered. You can explicitly create objects of this exception type by calling the method generateParseException in the generated parser. You can modify this class to customize your error reporting mechanisms so long as you retain the public fields.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
Token	currentToken This is the last token that has been consumed successfully.
int[][]	expectedTokenSequences Each entry in this array is an array of integers.
java.lang.String[][]	expectedTokenSequencesLoc Source locations of each expected token sequence, parallel to expectedTokenSequences.
java.lang.String	location The grammar expansion in which the error arose.
java.lang.String[]	tokenImage This is a reference to the "tokenImage" array of the generated parser within which the parse error occurred.

Constructor Summary

Constructors

Constructor and Description
ParseException() The following constructors are for use by you for whatever purpose you can think of.
ParseException(java.lang.String message) Constructor with message.
ParseException(java.lang.String message, java.lang.Throwable cause)
ParseException(Token currentTokenVal, int[][] expectedTokenSequencesVal, java.lang.String[][] expectedTokenSequencesLocVal, java.lang.String[] tokenImageVal, java.lang.String locationVal) This constructor is used by the method "generateParseException" in the generated parser.

Method Summary

Modifier and Type	Method and Description
int	getErrorLineNumber()
java.lang.String	getErrorSourceFile() Accessor method to retrieve source file info.
java.lang.String	getErrorText()
java.lang.String	getMessage() Print the error with line number and stack trace.
java.lang.String	getMessage(boolean debug)
void	setErrorSourceFile(java.lang.String file) Used to add source file info to exception
java.lang.String	toString()

Methods inherited from class bsh.EvalError

getRawMessage, getScriptStackTrace, prependMessage, reThrow

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

currentToken

public Token currentToken

This is the last token that has been consumed successfully. If this object has been created due to a parse error, the token followng this token will (therefore) be the first error token.

expectedTokenSequences

public int[][] expectedTokenSequences

Each entry in this array is an array of integers. Each array of integers represents a sequence of tokens (by their ordinal values) that is expected at this point of the parse.

tokenImage

public java.lang.String[] tokenImage

This is a reference to the "tokenImage" array of the generated parser within which the parse error occurred. This array is defined in the generated ...Constants interface.

expectedTokenSequencesLoc

public java.lang.String[][] expectedTokenSequencesLoc

Source locations of each expected token sequence, parallel to expectedTokenSequences.

location

public java.lang.String location

The grammar expansion in which the error arose.

Constructor Detail

ParseException

public ParseException(Token currentTokenVal,
                      int[][] expectedTokenSequencesVal,
                      java.lang.String[][] expectedTokenSequencesLocVal,
                      java.lang.String[] tokenImageVal,
                      java.lang.String locationVal)

This constructor is used by the method "generateParseException" in the generated parser. Calling this constructor generates a new object of this type with the fields "currentToken", "expectedTokenSequences", and "tokenImage" set.

ParseException

public ParseException()

The following constructors are for use by you for whatever purpose you can think of. Constructing the exception in this manner makes the exception behave in the normal way - i.e., as documented in the class "Throwable". The fields "errorToken", "expectedTokenSequences", and "tokenImage" do not contain relevant information. The JavaCC generated code does not use these constructors.

ParseException

public ParseException(java.lang.String message)

Constructor with message.

ParseException

public ParseException(java.lang.String message,
                      java.lang.Throwable cause)

Method Detail

setErrorSourceFile

public void setErrorSourceFile(java.lang.String file)

Used to add source file info to exception

Parameters:

file - source file

getErrorSourceFile

public java.lang.String getErrorSourceFile()

Accessor method to retrieve source file info.

Overrides:

getErrorSourceFile in class EvalError

getErrorLineNumber

public int getErrorLineNumber()

Overrides:

getErrorLineNumber in class EvalError

getErrorText

public java.lang.String getErrorText()

Overrides:

getErrorText in class EvalError

getMessage

public java.lang.String getMessage()

Description copied from class: EvalError

Print the error with line number and stack trace.

Overrides:

getMessage in class EvalError

getMessage

public java.lang.String getMessage(boolean debug)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Throwable