Package freemarker.core
Class ParseException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.io.IOException
-
- freemarker.core.ParseException
-
- All Implemented Interfaces:
java.io.Serializable
- Direct Known Subclasses:
Template.WrongEncodingException
public class ParseException extends java.io.IOExceptionParsing-time exception in a template (as opposed to a runtime exception, aTemplateException). This usually signals syntactical/lexical errors. Note that on JavaCC-level lexical errors throwTokenMgrErrorinstead of this, however with the API-s that most users use those will be wrapped intoParseException-s. This is a modified version of file generated by JavaCC from FTL.jj. You can modify this class to customize the error reporting mechanisms so long as the public interface remains compatible with the original.- See Also:
TokenMgrError, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static int_INCLUDEstatic intANDstatic intASstatic intASCII_DIGITstatic intASSIGNstatic intATTEMPTstatic intAUTOESCstatic intBLANKstatic intBREAKstatic intBUILT_INstatic intCALLstatic intCASEstatic intCLOSE_BRACKETstatic intCLOSE_PARENstatic intCLOSE_TAG1static intCLOSE_TAG2static intCLOSING_CURLY_BRACKETstatic intCOLONintcolumnNumberstatic intCOMMAstatic intCOMMENTstatic intCOMPRESSstatic intCONTINUEfreemarker.core.TokencurrentTokenThis is the last token that has been consumed successfully.static intDECIMALstatic intDEFAULstatic intDEFAULTstatic intDIRECTIVE_ENDstatic intDIV_EQUALSstatic intDIVIDEstatic intDOLLAR_INTERPOLATION_OPENINGstatic intDOTstatic intDOT_DOTstatic intDOT_DOT_ASTERISKstatic intDOT_DOT_LESSstatic intDOUBLE_EQUALSstatic intDOUBLE_STARstatic intELLIPSISstatic intELSEstatic intELSE_IFstatic intEMPTY_DIRECTIVE_ENDstatic intEND_ASSIGNstatic intEND_ATTEMPTstatic intEND_AUTOESCstatic intEND_COMPRESSstatic intEND_ESCAPEstatic intEND_FOREACHstatic intEND_FUNCTIONstatic intEND_GLOBALstatic intEND_IFstatic intEND_ITEMSstatic intEND_LISTstatic intEND_LOCALstatic intEND_MACROstatic intEND_NOAUTOESCstatic intEND_NOESCAPEstatic intEND_OUTPUTFORMATstatic intEND_RECOVERstatic intEND_SEPstatic intEND_SWITCHstatic intEND_TAGstatic intEND_TRANSFORMintendColumnNumberintendLineNumberstatic intEOFprotected java.lang.StringeolThe end of line string for this machine.static intEQUALSstatic intESCAPEstatic intESCAPED_CHARstatic intESCAPED_GTstatic intESCAPED_GTEstatic intESCAPED_ID_CHARstatic intEXCLAMstatic intEXISTSint[][]expectedTokenSequencesEach entry in this array is an array of integers.static intEXPRESSION_COMMENTstatic intFALLBACKstatic intFALSEstatic intFLUSHstatic intFM_EXPRESSIONstatic intFOREACHstatic intFTL_HEADERstatic intFUNCTIONstatic intGLOBALASSIGNstatic intHALTstatic intHASH_INTERPOLATION_OPENINGstatic intIDstatic intID_START_CHARstatic intIFstatic intIMPORTstatic intINstatic intIN_PARENstatic intINTEGERstatic intITEMSstatic intKEEP_GOINGstatic intLAMBDA_ARROWstatic intLESS_THANstatic intLESS_THAN_EQUALSintlineNumberstatic intLISTstatic intLOCALASSIGNstatic intLONE_LESS_THAN_OR_DASHstatic intLTRIMstatic intMACROstatic intMAYBE_ENDstatic intMINUSstatic intMINUS_EQUALSstatic intMINUS_MINUSstatic intMOD_EQUALSstatic intNAMED_PARAMETER_EXPRESSIONstatic intNATURAL_GTstatic intNATURAL_GTEstatic intNESTEDstatic intNO_DIRECTIVEstatic intNO_PARSEstatic intNO_SPACE_EXPRESSIONstatic intNOAUTOESCstatic intNOESCAPEstatic intNON_ESCAPED_ID_START_CHARstatic intNOPARSEstatic intNOT_EQUALSstatic intNOTRIMstatic intOPEN_BRACKETstatic intOPEN_MISPLACED_INTERPOLATIONstatic intOPEN_PARENstatic intOPENING_CURLY_BRACKETstatic intORstatic intOUTPUTFORMATstatic intPERCENTstatic intPLUSstatic intPLUS_EQUALSstatic intPLUS_PLUSstatic intRAW_STRINGstatic intRECOVERstatic intRECURSEstatic intRETURNstatic intRTRIMstatic intSEMICOLONstatic intSEPstatic intSETTINGstatic intSIMPLE_NESTEDstatic intSIMPLE_RECURSEstatic intSIMPLE_RETURNprotected booleanspecialConstructorDeprecated.Will be remove without replacement in 2.4.static intSQUARE_BRACKET_INTERPOLATION_OPENINGstatic intSTART_TAGstatic intSTATIC_TEXT_FALSE_ALARMstatic intSTATIC_TEXT_NON_WSstatic intSTATIC_TEXT_WSstatic intSTOPstatic intSTRING_LITERALstatic intSWITCHstatic intTERMINATING_EXCLAMstatic intTERMINATING_WHITESPACEstatic intTERSE_COMMENTstatic intTERSE_COMMENT_ENDstatic intTIMESstatic intTIMES_EQUALSjava.lang.String[]tokenImageThis is a reference to the "tokenImage" array of the generated parser within which the parse error occurred.static intTRANSFORMstatic intTRIMstatic intTRIVIAL_FTL_HEADERstatic intTRUEstatic intUNIFIED_CALLstatic intUNIFIED_CALL_ENDstatic intUNKNOWN_DIRECTIVEstatic intUSINGstatic intVISIT
-
Constructor Summary
Constructors Modifier Constructor Description protectedParseException()Deprecated.Use a constructor to which you pass description, template, and positions.ParseException(freemarker.core.Token currentTokenVal, int[][] expectedTokenSequencesVal, java.lang.String[] tokenImageVal)This constructor is used by the method "generateParseException" in the generated parser.ParseException(java.lang.String description, int lineNumber, int columnNumber)Deprecated.Use a constructor to which you can also pass the template, and the end positions.ParseException(java.lang.String description, freemarker.core.TemplateObject tobj)ParseException(java.lang.String description, freemarker.core.TemplateObject tobj, java.lang.Throwable cause)ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber)Deprecated.UseParseException(String, Template, int, int, int, int)instead, as IDE-s need the end position of the error too.ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, int endLineNumber, int endColumnNumber)ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, int endLineNumber, int endColumnNumber, java.lang.Throwable cause)ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, java.lang.Throwable cause)Deprecated.UseParseException(String, Template, int, int, int, int, Throwable)instead, as IDE-s need the end position of the error too.ParseException(java.lang.String description, Template template, freemarker.core.Token tk)ParseException(java.lang.String description, Template template, freemarker.core.Token tk, java.lang.Throwable cause)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected java.lang.Stringadd_escapes(java.lang.String str)Used to convert raw characters to their escaped version when these raw version cannot be used as part of an ASCII string literal.intgetColumnNumber()1-based column number of the failing section, or 0 is the information is not available.java.lang.StringgetEditorMessage()Returns the description of the error without error location or source quotations, ornullif there's no description available.intgetEndColumnNumber()1-based column number of the last character of the failing section, or 0 if the information is not available.intgetEndLineNumber()1-based line number of the last line that contains the failing section, or 0 if the information is not available.intgetLineNumber()1-based line number of the failing section, or 0 is the information is not available.java.lang.StringgetMessage()Returns the error location plus the error description.java.lang.StringgetTemplateName()Returns the name (template-root relative path) of the template whose parsing was failed.voidsetTemplateName(java.lang.String templateName)Should be used internally only; sets the name of the template that contains the error.
-
-
-
Field Detail
-
currentToken
public freemarker.core.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 following this token will (therefore) be the first error token.
-
columnNumber
public int columnNumber
-
lineNumber
public int lineNumber
-
endColumnNumber
public int endColumnNumber
-
endLineNumber
public int endLineNumber
-
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.
-
eol
protected java.lang.String eol
The end of line string for this machine.
-
specialConstructor
@Deprecated protected boolean specialConstructor
Deprecated.Will be remove without replacement in 2.4.
-
EOF
public static final int EOF
- See Also:
- Constant Field Values
-
BLANK
public static final int BLANK
- See Also:
- Constant Field Values
-
START_TAG
public static final int START_TAG
- See Also:
- Constant Field Values
-
END_TAG
public static final int END_TAG
- See Also:
- Constant Field Values
-
CLOSE_TAG1
public static final int CLOSE_TAG1
- See Also:
- Constant Field Values
-
CLOSE_TAG2
public static final int CLOSE_TAG2
- See Also:
- Constant Field Values
-
ATTEMPT
public static final int ATTEMPT
- See Also:
- Constant Field Values
-
RECOVER
public static final int RECOVER
- See Also:
- Constant Field Values
-
IF
public static final int IF
- See Also:
- Constant Field Values
-
ELSE_IF
public static final int ELSE_IF
- See Also:
- Constant Field Values
-
LIST
public static final int LIST
- See Also:
- Constant Field Values
-
ITEMS
public static final int ITEMS
- See Also:
- Constant Field Values
-
SEP
public static final int SEP
- See Also:
- Constant Field Values
-
FOREACH
public static final int FOREACH
- See Also:
- Constant Field Values
-
SWITCH
public static final int SWITCH
- See Also:
- Constant Field Values
-
CASE
public static final int CASE
- See Also:
- Constant Field Values
-
ASSIGN
public static final int ASSIGN
- See Also:
- Constant Field Values
-
GLOBALASSIGN
public static final int GLOBALASSIGN
- See Also:
- Constant Field Values
-
LOCALASSIGN
public static final int LOCALASSIGN
- See Also:
- Constant Field Values
-
_INCLUDE
public static final int _INCLUDE
- See Also:
- Constant Field Values
-
IMPORT
public static final int IMPORT
- See Also:
- Constant Field Values
-
FUNCTION
public static final int FUNCTION
- See Also:
- Constant Field Values
-
MACRO
public static final int MACRO
- See Also:
- Constant Field Values
-
TRANSFORM
public static final int TRANSFORM
- See Also:
- Constant Field Values
-
VISIT
public static final int VISIT
- See Also:
- Constant Field Values
-
STOP
public static final int STOP
- See Also:
- Constant Field Values
-
RETURN
public static final int RETURN
- See Also:
- Constant Field Values
-
CALL
public static final int CALL
- See Also:
- Constant Field Values
-
SETTING
public static final int SETTING
- See Also:
- Constant Field Values
-
OUTPUTFORMAT
public static final int OUTPUTFORMAT
- See Also:
- Constant Field Values
-
AUTOESC
public static final int AUTOESC
- See Also:
- Constant Field Values
-
NOAUTOESC
public static final int NOAUTOESC
- See Also:
- Constant Field Values
-
COMPRESS
public static final int COMPRESS
- See Also:
- Constant Field Values
-
COMMENT
public static final int COMMENT
- See Also:
- Constant Field Values
-
TERSE_COMMENT
public static final int TERSE_COMMENT
- See Also:
- Constant Field Values
-
NOPARSE
public static final int NOPARSE
- See Also:
- Constant Field Values
-
END_IF
public static final int END_IF
- See Also:
- Constant Field Values
-
END_LIST
public static final int END_LIST
- See Also:
- Constant Field Values
-
END_ITEMS
public static final int END_ITEMS
- See Also:
- Constant Field Values
-
END_SEP
public static final int END_SEP
- See Also:
- Constant Field Values
-
END_RECOVER
public static final int END_RECOVER
- See Also:
- Constant Field Values
-
END_ATTEMPT
public static final int END_ATTEMPT
- See Also:
- Constant Field Values
-
END_FOREACH
public static final int END_FOREACH
- See Also:
- Constant Field Values
-
END_LOCAL
public static final int END_LOCAL
- See Also:
- Constant Field Values
-
END_GLOBAL
public static final int END_GLOBAL
- See Also:
- Constant Field Values
-
END_ASSIGN
public static final int END_ASSIGN
- See Also:
- Constant Field Values
-
END_FUNCTION
public static final int END_FUNCTION
- See Also:
- Constant Field Values
-
END_MACRO
public static final int END_MACRO
- See Also:
- Constant Field Values
-
END_OUTPUTFORMAT
public static final int END_OUTPUTFORMAT
- See Also:
- Constant Field Values
-
END_AUTOESC
public static final int END_AUTOESC
- See Also:
- Constant Field Values
-
END_NOAUTOESC
public static final int END_NOAUTOESC
- See Also:
- Constant Field Values
-
END_COMPRESS
public static final int END_COMPRESS
- See Also:
- Constant Field Values
-
END_TRANSFORM
public static final int END_TRANSFORM
- See Also:
- Constant Field Values
-
END_SWITCH
public static final int END_SWITCH
- See Also:
- Constant Field Values
-
ELSE
public static final int ELSE
- See Also:
- Constant Field Values
-
BREAK
public static final int BREAK
- See Also:
- Constant Field Values
-
CONTINUE
public static final int CONTINUE
- See Also:
- Constant Field Values
-
SIMPLE_RETURN
public static final int SIMPLE_RETURN
- See Also:
- Constant Field Values
-
HALT
public static final int HALT
- See Also:
- Constant Field Values
-
FLUSH
public static final int FLUSH
- See Also:
- Constant Field Values
-
TRIM
public static final int TRIM
- See Also:
- Constant Field Values
-
LTRIM
public static final int LTRIM
- See Also:
- Constant Field Values
-
RTRIM
public static final int RTRIM
- See Also:
- Constant Field Values
-
NOTRIM
public static final int NOTRIM
- See Also:
- Constant Field Values
-
DEFAUL
public static final int DEFAUL
- See Also:
- Constant Field Values
-
SIMPLE_NESTED
public static final int SIMPLE_NESTED
- See Also:
- Constant Field Values
-
NESTED
public static final int NESTED
- See Also:
- Constant Field Values
-
SIMPLE_RECURSE
public static final int SIMPLE_RECURSE
- See Also:
- Constant Field Values
-
RECURSE
public static final int RECURSE
- See Also:
- Constant Field Values
-
FALLBACK
public static final int FALLBACK
- See Also:
- Constant Field Values
-
ESCAPE
public static final int ESCAPE
- See Also:
- Constant Field Values
-
END_ESCAPE
public static final int END_ESCAPE
- See Also:
- Constant Field Values
-
NOESCAPE
public static final int NOESCAPE
- See Also:
- Constant Field Values
-
END_NOESCAPE
public static final int END_NOESCAPE
- See Also:
- Constant Field Values
-
UNIFIED_CALL
public static final int UNIFIED_CALL
- See Also:
- Constant Field Values
-
UNIFIED_CALL_END
public static final int UNIFIED_CALL_END
- See Also:
- Constant Field Values
-
FTL_HEADER
public static final int FTL_HEADER
- See Also:
- Constant Field Values
-
TRIVIAL_FTL_HEADER
public static final int TRIVIAL_FTL_HEADER
- See Also:
- Constant Field Values
-
UNKNOWN_DIRECTIVE
public static final int UNKNOWN_DIRECTIVE
- See Also:
- Constant Field Values
-
STATIC_TEXT_WS
public static final int STATIC_TEXT_WS
- See Also:
- Constant Field Values
-
STATIC_TEXT_NON_WS
public static final int STATIC_TEXT_NON_WS
- See Also:
- Constant Field Values
-
STATIC_TEXT_FALSE_ALARM
public static final int STATIC_TEXT_FALSE_ALARM
- See Also:
- Constant Field Values
-
DOLLAR_INTERPOLATION_OPENING
public static final int DOLLAR_INTERPOLATION_OPENING
- See Also:
- Constant Field Values
-
HASH_INTERPOLATION_OPENING
public static final int HASH_INTERPOLATION_OPENING
- See Also:
- Constant Field Values
-
SQUARE_BRACKET_INTERPOLATION_OPENING
public static final int SQUARE_BRACKET_INTERPOLATION_OPENING
- See Also:
- Constant Field Values
-
ESCAPED_CHAR
public static final int ESCAPED_CHAR
- See Also:
- Constant Field Values
-
STRING_LITERAL
public static final int STRING_LITERAL
- See Also:
- Constant Field Values
-
RAW_STRING
public static final int RAW_STRING
- See Also:
- Constant Field Values
-
FALSE
public static final int FALSE
- See Also:
- Constant Field Values
-
TRUE
public static final int TRUE
- See Also:
- Constant Field Values
-
INTEGER
public static final int INTEGER
- See Also:
- Constant Field Values
-
DECIMAL
public static final int DECIMAL
- See Also:
- Constant Field Values
-
DOT
public static final int DOT
- See Also:
- Constant Field Values
-
DOT_DOT
public static final int DOT_DOT
- See Also:
- Constant Field Values
-
DOT_DOT_LESS
public static final int DOT_DOT_LESS
- See Also:
- Constant Field Values
-
DOT_DOT_ASTERISK
public static final int DOT_DOT_ASTERISK
- See Also:
- Constant Field Values
-
BUILT_IN
public static final int BUILT_IN
- See Also:
- Constant Field Values
-
EXISTS
public static final int EXISTS
- See Also:
- Constant Field Values
-
EQUALS
public static final int EQUALS
- See Also:
- Constant Field Values
-
DOUBLE_EQUALS
public static final int DOUBLE_EQUALS
- See Also:
- Constant Field Values
-
NOT_EQUALS
public static final int NOT_EQUALS
- See Also:
- Constant Field Values
-
PLUS_EQUALS
public static final int PLUS_EQUALS
- See Also:
- Constant Field Values
-
MINUS_EQUALS
public static final int MINUS_EQUALS
- See Also:
- Constant Field Values
-
TIMES_EQUALS
public static final int TIMES_EQUALS
- See Also:
- Constant Field Values
-
DIV_EQUALS
public static final int DIV_EQUALS
- See Also:
- Constant Field Values
-
MOD_EQUALS
public static final int MOD_EQUALS
- See Also:
- Constant Field Values
-
PLUS_PLUS
public static final int PLUS_PLUS
- See Also:
- Constant Field Values
-
MINUS_MINUS
public static final int MINUS_MINUS
- See Also:
- Constant Field Values
-
LESS_THAN
public static final int LESS_THAN
- See Also:
- Constant Field Values
-
LESS_THAN_EQUALS
public static final int LESS_THAN_EQUALS
- See Also:
- Constant Field Values
-
ESCAPED_GT
public static final int ESCAPED_GT
- See Also:
- Constant Field Values
-
ESCAPED_GTE
public static final int ESCAPED_GTE
- See Also:
- Constant Field Values
-
LAMBDA_ARROW
public static final int LAMBDA_ARROW
- See Also:
- Constant Field Values
-
PLUS
public static final int PLUS
- See Also:
- Constant Field Values
-
MINUS
public static final int MINUS
- See Also:
- Constant Field Values
-
TIMES
public static final int TIMES
- See Also:
- Constant Field Values
-
DOUBLE_STAR
public static final int DOUBLE_STAR
- See Also:
- Constant Field Values
-
ELLIPSIS
public static final int ELLIPSIS
- See Also:
- Constant Field Values
-
DIVIDE
public static final int DIVIDE
- See Also:
- Constant Field Values
-
PERCENT
public static final int PERCENT
- See Also:
- Constant Field Values
-
AND
public static final int AND
- See Also:
- Constant Field Values
-
OR
public static final int OR
- See Also:
- Constant Field Values
-
EXCLAM
public static final int EXCLAM
- See Also:
- Constant Field Values
-
COMMA
public static final int COMMA
- See Also:
- Constant Field Values
-
SEMICOLON
public static final int SEMICOLON
- See Also:
- Constant Field Values
-
COLON
public static final int COLON
- See Also:
- Constant Field Values
-
OPEN_BRACKET
public static final int OPEN_BRACKET
- See Also:
- Constant Field Values
-
CLOSE_BRACKET
public static final int CLOSE_BRACKET
- See Also:
- Constant Field Values
-
OPEN_PAREN
public static final int OPEN_PAREN
- See Also:
- Constant Field Values
-
CLOSE_PAREN
public static final int CLOSE_PAREN
- See Also:
- Constant Field Values
-
OPENING_CURLY_BRACKET
public static final int OPENING_CURLY_BRACKET
- See Also:
- Constant Field Values
-
CLOSING_CURLY_BRACKET
public static final int CLOSING_CURLY_BRACKET
- See Also:
- Constant Field Values
-
IN
public static final int IN
- See Also:
- Constant Field Values
-
AS
public static final int AS
- See Also:
- Constant Field Values
-
USING
public static final int USING
- See Also:
- Constant Field Values
-
ID
public static final int ID
- See Also:
- Constant Field Values
-
OPEN_MISPLACED_INTERPOLATION
public static final int OPEN_MISPLACED_INTERPOLATION
- See Also:
- Constant Field Values
-
NON_ESCAPED_ID_START_CHAR
public static final int NON_ESCAPED_ID_START_CHAR
- See Also:
- Constant Field Values
-
ESCAPED_ID_CHAR
public static final int ESCAPED_ID_CHAR
- See Also:
- Constant Field Values
-
ID_START_CHAR
public static final int ID_START_CHAR
- See Also:
- Constant Field Values
-
ASCII_DIGIT
public static final int ASCII_DIGIT
- See Also:
- Constant Field Values
-
DIRECTIVE_END
public static final int DIRECTIVE_END
- See Also:
- Constant Field Values
-
EMPTY_DIRECTIVE_END
public static final int EMPTY_DIRECTIVE_END
- See Also:
- Constant Field Values
-
NATURAL_GT
public static final int NATURAL_GT
- See Also:
- Constant Field Values
-
NATURAL_GTE
public static final int NATURAL_GTE
- See Also:
- Constant Field Values
-
TERMINATING_WHITESPACE
public static final int TERMINATING_WHITESPACE
- See Also:
- Constant Field Values
-
TERMINATING_EXCLAM
public static final int TERMINATING_EXCLAM
- See Also:
- Constant Field Values
-
TERSE_COMMENT_END
public static final int TERSE_COMMENT_END
- See Also:
- Constant Field Values
-
MAYBE_END
public static final int MAYBE_END
- See Also:
- Constant Field Values
-
KEEP_GOING
public static final int KEEP_GOING
- See Also:
- Constant Field Values
-
LONE_LESS_THAN_OR_DASH
public static final int LONE_LESS_THAN_OR_DASH
- See Also:
- Constant Field Values
-
DEFAULT
public static final int DEFAULT
- See Also:
- Constant Field Values
-
NO_DIRECTIVE
public static final int NO_DIRECTIVE
- See Also:
- Constant Field Values
-
FM_EXPRESSION
public static final int FM_EXPRESSION
- See Also:
- Constant Field Values
-
IN_PAREN
public static final int IN_PAREN
- See Also:
- Constant Field Values
-
NAMED_PARAMETER_EXPRESSION
public static final int NAMED_PARAMETER_EXPRESSION
- See Also:
- Constant Field Values
-
EXPRESSION_COMMENT
public static final int EXPRESSION_COMMENT
- See Also:
- Constant Field Values
-
NO_SPACE_EXPRESSION
public static final int NO_SPACE_EXPRESSION
- See Also:
- Constant Field Values
-
NO_PARSE
public static final int NO_PARSE
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
ParseException
public ParseException(freemarker.core.Token currentTokenVal, int[][] expectedTokenSequencesVal, java.lang.String[] tokenImageVal)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. This constructor calls its super class with the empty string to force the "toString" method of parent class "Throwable" to print the error message in the form: ParseException: <result of getMessage>
-
ParseException
@Deprecated protected ParseException()
Deprecated.Use a constructor to which you pass description, template, and positions.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
@Deprecated public ParseException(java.lang.String description, int lineNumber, int columnNumber)Deprecated.Use a constructor to which you can also pass the template, and the end positions.
-
ParseException
public ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, int endLineNumber, int endColumnNumber)- Since:
- 2.3.21
-
ParseException
public ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, int endLineNumber, int endColumnNumber, java.lang.Throwable cause)- Since:
- 2.3.21
-
ParseException
@Deprecated public ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber)Deprecated.UseParseException(String, Template, int, int, int, int)instead, as IDE-s need the end position of the error too.- Since:
- 2.3.20
-
ParseException
@Deprecated public ParseException(java.lang.String description, Template template, int lineNumber, int columnNumber, java.lang.Throwable cause)Deprecated.UseParseException(String, Template, int, int, int, int, Throwable)instead, as IDE-s need the end position of the error too.- Since:
- 2.3.20
-
ParseException
public ParseException(java.lang.String description, Template template, freemarker.core.Token tk)- Since:
- 2.3.20
-
ParseException
public ParseException(java.lang.String description, Template template, freemarker.core.Token tk, java.lang.Throwable cause)- Since:
- 2.3.20
-
ParseException
public ParseException(java.lang.String description, freemarker.core.TemplateObject tobj)- Since:
- 2.3.20
-
ParseException
public ParseException(java.lang.String description, freemarker.core.TemplateObject tobj, java.lang.Throwable cause)- Since:
- 2.3.20
-
-
Method Detail
-
setTemplateName
public void setTemplateName(java.lang.String templateName)
Should be used internally only; sets the name of the template that contains the error. This is needed as the constructor that JavaCC automatically calls doesn't pass in the template, so we set it somewhere later in an exception handler.
-
getMessage
public java.lang.String getMessage()
Returns the error location plus the error description.- Overrides:
getMessagein classjava.lang.Throwable- See Also:
getDescription(),getTemplateName(),getLineNumber(),getColumnNumber()
-
getEditorMessage
public java.lang.String getEditorMessage()
Returns the description of the error without error location or source quotations, ornullif there's no description available. This is useful in editors (IDE-s) where the error markers and the editor window itself already carry this information, so it's redundant the repeat in the error dialog.
-
getTemplateName
public java.lang.String getTemplateName()
Returns the name (template-root relative path) of the template whose parsing was failed. Maybenullif this is a non-stored template.- Since:
- 2.3.20
-
getLineNumber
public int getLineNumber()
1-based line number of the failing section, or 0 is the information is not available.
-
getColumnNumber
public int getColumnNumber()
1-based column number of the failing section, or 0 is the information is not available.
-
getEndLineNumber
public int getEndLineNumber()
1-based line number of the last line that contains the failing section, or 0 if the information is not available.- Since:
- 2.3.21
-
getEndColumnNumber
public int getEndColumnNumber()
1-based column number of the last character of the failing section, or 0 if the information is not available. Note that unlike with Java string API-s, this column number is inclusive.- Since:
- 2.3.21
-
add_escapes
protected java.lang.String add_escapes(java.lang.String str)
Used to convert raw characters to their escaped version when these raw version cannot be used as part of an ASCII string literal.
-
-