/**
* Support "JEP 455: Primitive Types in Patterns, instanceof, and switch (Preview)" (Java 23)
* Changes in InstanceOfExpression
* Support "JEP 476: Module Import Declarations (Preview)" (Java 23)
* Changes in ImportDeclaration
* Support "JEP 477: Implicitly Declared Classes and Instance Main Methods (Third Preview)" (Java 23)
* Changes in CompilationUnit, added new node ImplicitClassDeclaration
* Andreas Dangel 07/2024
*====================================================================
* Support "JEP 447: Statements before super(...) (Preview)" (Java 22)
* Changes in ConstructorBlock
* Support "JEP 456: Unnamed Variables & Patterns" (Java 22)
* This is now a regular language feature. Otherwise no changes.
* Support "JEP 463: Implicitly Declared Classes and Instance Main Methods (Second Preview)" (Java 22)
* No changes.
* Support "JEP 459: String Templates (Second Preview)" (Java 22)
* Use ASTTemplate.setContent instead of setImage.
* Remove support for Record pattern in enhanced for statements. This was only a Java 20 Preview feature.
* Remove support for ParenthesizedPatterns. This was only a Java 20 Preview feature.
* Andreas Dangel 02/2024
*====================================================================
* Renamed various nodes:
* ClassOrInterfaceType -> ClassType
* ClassOrInterfaceDeclaration -> ClassDeclaration
* ClassOrInterfaceBody -> ClassBody
* AnyTypeDeclaration -> TypeDeclaration
* MethodOrConstructorDeclaration -> ExecutableDeclaration
* VariableDeclaratorId -> VariableId
* Andreas Dangel 12/2023
*====================================================================
* Support "JEP 443: Unnamed Patterns and Variables" for Java 21 Preview.
* New AST nodes: ASTUnnamedPattern
* Support "JEP 430: String Templates" for Java 21 Preview.
* New AST nodes: ASTTemplateExpression, ASTTemplate, ASTTemplateFragment
* Promote "JEP 441: Pattern Matching for switch" as permanent language feature for Java 21.
* Renamed SwitchGuard to Guard.
* Promote "JEP 440: Record Patterns" as permanent language feature for Java 21.
* Renamed ComponentPatternList to PatternList
* Andreas Dangel 08/2023
*====================================================================
* Support "JEP 433: Pattern Matching for switch (Fourth Preview)" for Java 20 Preview
* SwitchLabel simplified
* Support "JEP 432: Record Patterns (Second Preview)" for Java 20 Preview
* ForStatement allows record patterns
* Removed named record patterns (optional VariableDeclaratorId following the pattern)
* Remove support for Java 18 preview language features
* GuardedPattern is removed
* Andreas Dangel 02/2023
*====================================================================
* Support "JEP 427: Pattern Matching for switch (Third Preview)" for Java 19 Preview
* Note: GuardedPattern is deprecated and only valid for 17-preview and 18-preview
* New AST node: ASTSwitchGuard (production "Guard") - used within switch case labels for refining a pattern
* Support "JEP 405: Record Patterns (Preview)" for Java 19 Preview
* New AST node: ASTRecordPattern and ASTComponentPatternList (production "RecordStructurePattern")
* Remove support for Java 17 preview language features
* Andreas Dangel 07/2022
*====================================================================
* Improve module grammar.
* Type names in "provides" directives are disambiguated like any other type name.
* ASTName is made redundant and removed for good.
* Clément Fournier 03/2022
*====================================================================
* Support "JEP 420: Pattern Matching for switch (Second Preview)" for Java 18 Preview
* There were no grammar changes between 18-preview and 17-preview
* Remove support for Java 16 preview language features
* Andreas Dangel 03/2022
*====================================================================
* Promote "JEP 409: Sealed Classes" as permanent language feature with Java 17.
* Support "JEP 406: Pattern Matching for switch (Preview)" for Java 17 Preview.
* Remove support for Java 15 preview language features
* Andreas Dangel 07/2021
*====================================================================
* Fix #3117 - infinite loop when parsing invalid code nested in lambdas
* Andreas Dangel 03/2021
*====================================================================
* Fix #3145 - parse exception with local records
* Clément Fournier 03/2021
*====================================================================
* Remove support for Java 14 preview language features
* JEP 397: Sealed Classes (Second Preview) for Java16 Preview
* JEP 395: Records for Java16
* JEP 394: Pattern Matching for instanceof for Java16
* Andreas Dangel 02/2021
*====================================================================
* Remove support for Java 13 preview language features.
* Promote text blocks as a permanent language features with Java 15.
* Support Pattern Matching for instanceof with Java 15 Preview.
* Support Records with Java 15 Preview.
* Support Local Records with Java 15 Preview.
* Support Sealed Classes with Java 15 Preview.
* Andreas Dangel 08/2020
*====================================================================
* Add support for record types introduced as a preview language
* feature with Java 14. See JEP 359.
* Andreas Dangel 02/2020
*====================================================================
* Add support for pattern matching for instance of introduced
* as a preview language feature with Java 14. See JEP 305.
* Clément Fournier 02/2020
*====================================================================
* Switch Expressions are now a standard feature of Java 14.
* Andreas Dangel 02/2020
*====================================================================
* Add support for the yield statement introduced as a preview language
* feature with Java 13. See JEP 354.
* Add support for text block literals introduces as a preview language
* feature with Java 13. See JEP 355.
* Andreas Dangel 08/2019
*====================================================================
* Fix #1848 Local classes should preserve their modifiers
* Clément Fournier 05/2019
*====================================================================
* Add support for Java 12 switch expressions and switch rules.
* Andreas Dangel, Clément Fournier 03/2019
*====================================================================
* Add support for Java 10 Local Variable Type Inference
* See #743. In Java 10 mode, "var" as local variable type is handled special.
* Andreas Dangel 04/2018
*====================================================================
* Fixes #888 [java] ParseException occurs with valid '<>' in Java 1.8 mode
* Juan Martin Sotuyo Dodero 01/2018
*====================================================================
* Fixes #793 [java] Parser error with private method in nested classes in interfaces
* Andreas Dangel 12/2017
*====================================================================
* Add support for Java 9 changes:
* Private interface methods are only allowed with java9.
* A single underscore "_" is an invalid identifier in java9.
* Diamond operator for anonymous classes is only allowed with java9.
* Add support for module-info.java.
* Allow more concise try-with-resources statements with java9.
* Andreas Dangel 09/2017
*====================================================================
* Add support for new Java 8 annotation locations.
* Bugs #414, #415, #417
* @Snap252 06/2017
*====================================================================
* Allow empty statements (";") between package, import
* and type declarations.
* Bug #378
* Andreas Dangel 05/2017
*====================================================================
* Allow method references to specify generics also for
* constructor references ("new").
* Bug #309
* Andreas Dangel 03/2017
*====================================================================
* Provide a better fix for CastExpression, getting rid of most hacks.
* Bug #257
*
* Juan Martin Sotuyo Dodero 02/2017
*====================================================================
* Allow local classes to carry more than one annotation.
* Bug #208
*
* Juan Martin Sotuyo Dodero 01/2017
*====================================================================
* Change lookahead for AnnotationMethodDeclaration in AnnotationTypeMemberDeclaration.
* Bug #206
*
* Juan Martin Sotuyo Dodero 01/2017
*====================================================================
* Allow method references to specify generics.
* Bug #207
*
* Juan Martin Sotuyo Dodero 01/2017
*====================================================================
* Simplify VariableDeclaratorId, forbidding illegal sequences such as
* this[] and MyClass.this[]
*
* Juan Martin Sotuyo Dodero 10/2016
*====================================================================
* Improve lambda detection in PrimaryPrefix to improve parsing performance.
*
* Juan Martin Sotuyo Dodero 10/2016
*====================================================================
* Fix for regression introduced in previous changeset.
* The syntactic lookahead was not properly handled by javacc,
* so it was converted to a semantic one
* Bug #1530
*
* Juan Martin Sotuyo Dodero 10/2016
*====================================================================
* Fix for an expression within an additive expression that was
* wrongly taken as a cast expression.
* Bug #1484
*
* Andreas Dangel 05/2016
*====================================================================
* Fix for Lambda expression with one variable
* Bug #1470
*
* Andreas Dangel 04/2016
*====================================================================
* Added support for explicit receiver parameters.
* Bug #1455
*
* Andreas Dangel 01/2016
*====================================================================
* Added capability for Tracking Tokens.
*
* Amit Kumar Prasad 10/2015
*====================================================================
* Fix for Cast Expression not detected properly in Return statements
* Bug #1429
*
* Andreas Dangel 10/2015
*====================================================================
* Fix for Lambda expressions without variables.
*
* Andreas Dangel 11/2014
*====================================================================
* Fix for Lambda expressions with two or three variables.
*
* Andreas Dangel 07/2014
*====================================================================
* Added support for Java 8 language constructs.
*
* Andreas Dangel 01/2014
* ===================================================================
* Fix ForStatement to allow Annotations within the initializer.
*
* Andreas Dangel 01/2013
* ===================================================================
* Fix wrong consumption of modifiers (e.g. "final") in a for-each loop.
* Check for wrong java usage when catching multiple exceptions.
*
* Andreas Dangel 12/2012
* ===================================================================
* Enhance grammar to use LocalVariableDeclaration in a for-each loop.
* This enhances the symbol table to recognize variables declared in such
* a for-each loop.
*
* Andreas Dangel 10/2012
* ===================================================================
* Fix parser problem #3530124 with generics
*
* Modified the grammar, so that the different usages of generics work.
* Adjusted the rules, that use "super", as super is no longer a PrimarySuffix.
* It's now either a ExplicitConstructorInvocation or a PrimaryPrefix.
* See also test case ParserCornersTest/testParsersCases
*
* Andreas Dangel 05/2012
* ===================================================================
* Added support for Java 7 language constructs
*
* Dinesh Bolkensteyn (SonarSource), 10/2011
* ===================================================================
* Changed the CastLookahead production to use 3 lookaheads for primitive types as suggested by Andreas Dangel
*
* Brian Remedios 07/2011
* ===================================================================
* Added in support for assert as a name using lookaheads
*
* Tom Copeland, 09/03
* ===================================================================
* Copied over the changes made by Andrea Gini and Marco Savard to
* support JDK 1.4 language constructs, i.e., asserts.
* See the java1_4c.jj distributed in the javacc2.1/examples/JavaGrammers directory.
* Made numerous other modifications to support PMD.
*
* Tom Copeland, 6/02
* ===================================================================
* This file is a modified version of one originally found in the
* VTransformer Examples directory of JavaCC1_1. It has been
* modified to accept Java source code for Java 1.2. Basically,
* this means a new key word was added, 'strictfp', and that keyword
* added to the appropriate productions and LOOKAHEADs (where other,
* similar keywords are listed as possible choices). This involved
* changing 11 lines.
*
* Some other minor changes were made, which can be found by doing
* a search on 'DW, 7/99'.
*
* The goal of this effort was for the grammar to be able to parse
* any legal Java 1.2 source code. It does not reject all illegal
* cases, but neither did the original. Plus, when it comes to
* the new 'strictfp' keyword, the Java Compiler from Sun (JDK1.2.1)
* also does not reject all illegal cases, as defined by the
* "Updates" document found at
* http://java.sun.com/docs/books/jls/strictfp-changes.pdf
* (see the testcases.txt file for details).
*
* David Williams, 7/99
* ===================================================================
*
*
* Copyright (C) 1996, 1997 Sun Microsystems Inc.
*
* Use of this file and the system it is part of is constrained by the
* file COPYRIGHT in the root directory of this system. You may, however,
* make any modifications you wish to this file.
*
* Java files generated by running JavaCC on this file (or modified versions
* of this file) may be used in exactly the same manner as Java files
* generated from any grammar developed by you.
*
* Author: Sriram Sankar
* Date: 3/5/97
*
* This file contains a Java grammar and actions that implement a front-end.
*/
options {
UNICODE_INPUT=true;
CACHE_TOKENS = true;
STATIC = false;
MULTI = true;
VISITOR = true;
NODE_PACKAGE="net.sourceforge.pmd.lang.java.ast";
// disable the calculation of expected tokens when a parse error occurs
// depending on the possible allowed next tokens, this
// could be expensive (see https://github.com/pmd/pmd/issues/3117)
//ERROR_REPORTING = false;
//DEBUG_PARSER = true;
//DEBUG_LOOKAHEAD = true;
//DEBUG_TOKEN_MANAGER = true;
}
PARSER_BEGIN(JavaParserImpl)
package net.sourceforge.pmd.lang.java.ast;
import java.util.ArrayDeque;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Deque;
import java.util.EnumSet;
import java.util.List;
import java.util.Set;
import java.util.Map;
import net.sourceforge.pmd.lang.ast.impl.javacc.JavaccToken;
import net.sourceforge.pmd.lang.ast.Node;
import net.sourceforge.pmd.lang.java.types.JPrimitiveType.PrimitiveTypeKind;
class JavaParserImpl {
private int jdkVersion = 0;
private boolean preview = false;
public void setJdkVersion(int jdkVersion) {
this.jdkVersion = jdkVersion;
}
public void setPreview(boolean preview) {
this.preview = preview;
}
private void throwParseException(String message) {
throw new ParseException(message).withLocation(token);
}
private boolean isRecordTypeSupported() {
return jdkVersion >= 16;
}
private boolean localTypesSupported() {
return isRecordTypeSupported();
}
/**
* Keeps track during tree construction, whether we are currently building a switch label.
* A switch label must not contain a LambdaExpression.
* Unfortunately, we have added LambdaExpression as part of PrimaryPrefix, which is wrong.
* To keep compatibility, this flag is used, whether a LambdaExpression should be parsed
* in PrimaryPrefix.
* See also comment at #Expression().
*/
private boolean inSwitchLabel = false;
// This is a semantic LOOKAHEAD to determine if we're dealing with an assert
// Note that this can't be replaced with a syntactic lookahead
// since "assert" isn't a string literal token
private boolean isAssertStart() {
if (jdkVersion <= 3) {
return false;
}
return getToken(1).getImage().equals("assert");
}
private boolean isRecordStart() {
return isRecordTypeSupported() && isKeyword("record") && isToken(2, IDENTIFIER);
}
private boolean isEnumStart() {
return jdkVersion >= 5 && isKeyword("enum");
}
/**
* Semantic lookahead to check if the next identifier is a
* specific restricted keyword.
*
* Restricted keywords are:
* var, yield, record, sealed, permits, "non" + "-" + "sealed"
*
*
enum and assert is used like restricted keywords, as they were not keywords
* in the early java versions.
*/
private boolean isKeyword(String image) {
return isKeyword(1, image);
}
private boolean isKeyword(int index, String image) {
Token token = getToken(index);
return token.kind == IDENTIFIER && token.image.equals(image);
}
private boolean isToken(int index, int kind) {
return getToken(index).kind == kind;
}
/**
* Semantic lookahead which matches "non-sealed".
*
*
"non-sealed" cannot be a token, for several reasons:
* It is only a keyword with java15 preview+, it consists actually
* of several separate tokens, which are valid on their own.
*/
private boolean isNonSealedModifier() {
if (isKeyword(1, "non") && isToken(2, MINUS) && isKeyword(3, "sealed")) {
JavaccToken nonToken = getToken(1);
JavaccToken minusToken = getToken(2);
JavaccToken sealedToken = getToken(3);
return nonToken.getReportLocation().getEndColumn() == minusToken.getReportLocation().getStartColumn()
&& minusToken.getReportLocation().getEndColumn() == sealedToken.getReportLocation().getStartColumn();
}
return false;
}
private boolean classModifierForLocalTypesLookahead() {
Token next = getToken(1);
return next.kind == AT
|| next.kind == PUBLIC
|| next.kind == PROTECTED
|| next.kind == PRIVATE
|| next.kind == ABSTRACT
|| next.kind == STATIC
|| next.kind == FINAL
|| next.kind == STRICTFP;
}
private boolean localTypeDeclAfterModifiers() {
Token next = getToken(1);
return next.kind == CLASS
|| localTypesSupported() && (
next.kind == INTERFACE
|| next.kind == AT && isToken(2, INTERFACE)
|| next.kind == IDENTIFIER && next.getImage().equals("enum")
|| next.kind == IDENTIFIER && next.getImage().equals("record") && isToken(2, IDENTIFIER)
);
}
private boolean localTypeDeclGivenNextIsIdent() {
return localTypesSupported() && (isRecordStart() || isEnumStart());
}
/**
* True if we're in a switch block, one precondition for parsing a yield
* statement.
*/
private boolean inSwitchExprBlock = false;
private boolean isYieldStart() {
return inSwitchExprBlock
&& isKeyword("yield")
&& mayStartExprAfterYield(2);
}
private boolean mayStartExprAfterYield(final int offset) {
// based off of https://hg.openjdk.java.net/jdk/jdk/file/bc3da0226ffa/src/jdk.compiler/share/classes/com/sun/tools/javac/parser/JavacParser.java#l2580
// please don't sue me
JavaccToken token = getToken(offset);
if (token == null) return false; // eof
switch (token.kind) {
case PLUS: case MINUS: case STRING_LITERAL: case CHARACTER_LITERAL:
case INTEGER_LITERAL: case FLOATING_POINT_LITERAL: case HEX_FLOATING_POINT_LITERAL:
case NULL: case IDENTIFIER: case TRUE: case FALSE:
case NEW: case SWITCH: case THIS: case SUPER:
return true;
case INCR: case DECR:
return getToken(offset + 1).kind != SEMICOLON; // eg yield++;
case LPAREN:
int lookahead = offset + 1;
int balance = 1;
JavaccToken t;
while ((t = getToken(lookahead)) != null && balance > 0) {
switch (t.kind) {
case LPAREN: balance++; break;
case RPAREN: balance--; break;
case COMMA: if (balance == 1) return false; // a method call, eg yield(1, 2);
}
lookahead++;
}
// lambda: yield () -> {};
// method call: yield ();
return t != null
&& (lookahead != offset + 2 // ie ()
|| t.kind == LAMBDA);
default:
return false;
}
}
private boolean shouldStartStatementInSwitch() {
switch (getToken(1).kind) {
case _DEFAULT:
case CASE:
case RBRACE:
return false;
default:
return true;
}
}
public Map getSuppressMap() {
return token_source.getSuppressMap();
}
public void setSuppressMarker(String marker) {
token_source.setSuppressMarker(marker);
}
private void setLastTokenImage(AbstractJavaNode node) {
node.setImage(getToken(0).getImage());
}
private void fixLastToken() {
AbstractJavaNode top = (AbstractJavaNode) jjtree.peekNode();
top.setLastToken(getToken(0));
}
private void forceExprContext() {
AbstractJavaNode top = jjtree.peekNode();
if (top instanceof ASTAmbiguousName) {
// see doc on the method
AbstractJavaNode replacement = (AbstractJavaNode) ((ASTAmbiguousName) top).forceExprContext();
jjtree.popNode();
jjtree.pushNode(replacement);
}
}
private void pushEmptyModifierList() {
ASTModifierList emptyMods = new ASTModifierList(JJTMODIFIERLIST);
emptyMods.setDeclaredModifiers(Collections.emptySet());
JavaccToken tok = JavaccToken.implicitBefore(getToken(1));
emptyMods.setFirstToken(tok);
emptyMods.setLastToken(tok);
jjtree.pushNode(emptyMods);
}
private void insertEmptyModifierListWithAnnotations(AbstractJavaNode node, AbstractJavaNode nodeWithAnnotations) {
ASTModifierList emptyMods = new ASTModifierList(JJTMODIFIERLIST);
emptyMods.setDeclaredModifiers(Collections.emptySet());
JavaccToken tok = JavaccToken.implicitBefore(node.getFirstToken());
emptyMods.setFirstToken(tok);
emptyMods.setLastToken(tok);
List annotations = new ArrayList();
while (nodeWithAnnotations.getNumChildren() > 0 && nodeWithAnnotations.getChild(0) instanceof ASTAnnotation) {
ASTAnnotation annotation = (ASTAnnotation) nodeWithAnnotations.getChild(0);
nodeWithAnnotations.removeChildAtIndex(0);
annotations.add(annotation);
}
for (int i = 0; i < annotations.size(); i++) {
emptyMods.addChild(annotations.get(i), i);
}
if (!annotations.isEmpty()) {
emptyMods.setFirstToken(annotations.get(0).getFirstToken());
emptyMods.setLastToken(annotations.get(annotations.size() - 1).getLastToken());
}
node.insertChild(emptyMods, 0);
}
private void forceTypeContext() {
AbstractJavaNode top = jjtree.peekNode();
if (top instanceof ASTAmbiguousName) {
// see doc on the method
AbstractJavaNode replacement = ((ASTAmbiguousName) top).forceTypeContext();
jjtree.popNode();
jjtree.pushNode(replacement);
}
}
// make the top node the last child of the second node on the stack
// If the stack ends with ..[A][B], then it becomes ..[A[B]]
private void injectTop() {
AbstractJavaNode top = (AbstractJavaNode) jjtree.popNode();
AbstractJavaNode prev = (AbstractJavaNode) jjtree.peekNode();
prev.addChild(top, prev.getNumChildren());
prev.setLastToken(top.getLastToken());
}
/**
* Keeps track during tree construction, whether we are currently building an
* explicit constructor invocation. Then the PrimaryExpression that may prefix
* a qualified super constructor call may not consume "super" tokens.
*/
private boolean inExplicitConstructorInvoc = false;
}
PARSER_END(JavaParserImpl)
TOKEN_MGR_DECLS :
{
protected List comments = new ArrayList();
private Deque savedTemplateKind = new ArrayDeque();
private Deque braceDepthInTemplate = new ArrayDeque();
private int braceDepthCurrentTemplate;
private boolean templateKind;
private static final java.util.regex.Pattern TEXT_BLOCK_TEMPLATE_END_PATTERN =
java.util.regex.Pattern.compile("^}[^\"]*\"\"\"");
private static final java.util.regex.Pattern STRING_TEMPLATE_MID_OR_END_PATTERN =
java.util.regex.Pattern.compile("^}(?:[^\"\\\\\n\r]|\\\\(?:[ntbrfs\\\\'\"]|[0-7][0-7]?|[0-3][0-7][0-7]))*(\\{|\")");
private void pushBrace() {
braceDepthCurrentTemplate++;
}
private void pushTemplate(boolean isTextBlockTemplate) {
braceDepthInTemplate.push(braceDepthCurrentTemplate);
savedTemplateKind.push(templateKind);
templateKind = isTextBlockTemplate;
braceDepthCurrentTemplate = 1;
}
private boolean isInTemplate() {
return braceDepthCurrentTemplate > 0;
}
private void popBrace() {
if (!isInTemplate())
return;
if (--braceDepthCurrentTemplate == 0) {
// this brace ends the template
popTemplate();
}
}
private void popTemplate() {
boolean isInTextBlockTemplate = templateKind;
if (!braceDepthInTemplate.isEmpty()) {
braceDepthCurrentTemplate = braceDepthInTemplate.pop();
templateKind = savedTemplateKind.pop();
if (isInTextBlockTemplate) {
SwitchTo(JavaTokenKinds.IN_TEXT_BLOCK_LITERAL);
} else {
SwitchTo(JavaTokenKinds.IN_STRING_TEMPLATE);
}
} else {
SwitchTo(JavaTokenKinds.DEFAULT);
}
}
private net.sourceforge.pmd.lang.ast.impl.javacc.JavaccToken rereadTokenAs(int kind, int length) {
input_stream.backup(lengthOfMatch);
try {
for (int i = 0; i < length; i++) {
input_stream.readChar();
}
} catch (java.io.EOFException eofException) {
throw new IllegalStateException(eofException);
}
jjmatchedKind = kind;
return jjFillToken();
}
private net.sourceforge.pmd.lang.ast.impl.javacc.JavaccToken handleBlock() {
net.sourceforge.pmd.lang.ast.impl.javacc.JavaccToken matchedToken = rereadTokenAs(JavaTokenKinds.RBRACE, 1);
if (!"}".equals(input_stream.getTokenImage())) {
throw new IllegalStateException("Expected '}'");
}
return matchedToken;
}
}
/* WHITE SPACE */
SPECIAL_TOKEN :
{
// those are private, just for code organisation
< #HORIZONTAL_WHITESPACE: [" ", "\t", "\f"] >
| < #LINE_TERMINATOR: "\n" | "\r" | "\r\n" >
// this one is pushed, notice the (..)+ construct, to avoid
// creating one token per character
| < WHITESPACE: ([" ", "\t", "\f", "\n", "\r"])+ >
}
/* COMMENTS */
SPECIAL_TOKEN :
{
< SINGLE_LINE_COMMENT: "//"(~["\n","\r"])* ("\n"|"\r"|"\r\n")? >
{
int startOfNOPMD = matchedToken.getImage().indexOf(suppressMarker);
if (startOfNOPMD != -1) {
suppressMap.put(matchedToken.getReportLocation().getStartLine(), matchedToken.getImage().substring(startOfNOPMD + suppressMarker.length()));
}
comments.add(new JavaComment(matchedToken));
}
}
MORE :
{
<"/**" ~["/"]> { input_stream.backup(1); } : IN_FORMAL_COMMENT
|
"/*" : IN_MULTI_LINE_COMMENT
}
SPECIAL_TOKEN :
{
{ comments.add(new JavadocComment(matchedToken)); } : DEFAULT
}
SPECIAL_TOKEN :
{
{ comments.add(new JavaComment(matchedToken)); } : DEFAULT
}
MORE :
{
< ~[] >
}
/* RESERVED WORDS AND LITERALS */
TOKEN :
{
< ABSTRACT: "abstract" >
| < BOOLEAN: "boolean" >
| < BREAK: "break" >
| < BYTE: "byte" >
| < CASE: "case" >
| < CATCH: "catch" >
| < CHAR: "char" >
| < CLASS: "class" >
| < CONST: "const" >
| < CONTINUE: "continue" >
| < _DEFAULT: "default" >
| < DO: "do" >
| < DOUBLE: "double" >
| < ELSE: "else" >
| < EXTENDS: "extends" >
| < FALSE: "false" >
| < FINAL: "final" >
| < FINALLY: "finally" >
| < FLOAT: "float" >
| < FOR: "for" >
| < GOTO: "goto" >
| < IF: "if" >
| < IMPLEMENTS: "implements" >
| < IMPORT: "import" >
| < INSTANCEOF: "instanceof" >
| < INT: "int" >
| < INTERFACE: "interface" >
| < LONG: "long" >
| < NATIVE: "native" >
| < NEW: "new" >
| < NULL: "null" >
| < PACKAGE: "package">
| < PRIVATE: "private" >
| < PROTECTED: "protected" >
| < PUBLIC: "public" >
| < RETURN: "return" >
| < SHORT: "short" >
| < STATIC: "static" >
| < SUPER: "super" >
| < SWITCH: "switch" >
| < SYNCHRONIZED: "synchronized" >
| < THIS: "this" >
| < THROW: "throw" >
| < THROWS: "throws" >
| < TRANSIENT: "transient" >
| < TRUE: "true" >
| < TRY: "try" >
| < VOID: "void" >
| < VOLATILE: "volatile" >
| < WHILE: "while" >
| < STRICTFP: "strictfp" >
}
/* Restricted Keywords */
// Note: These are commented out, since these keywords
// can still be used as identifiers.
// see isKeyword() semantic lookup
/*
TOKEN :
{
< OPEN: "open" >
| < MODULE: "module" >
| < REQUIRES: "requires" >
| < TRANSITIVE: "transitive" >
| < EXPORTS: "exports" >
| < OPENS: "opens" >
| < TO: "to" >
| < USES: "uses" >
| < PROVIDES: "provides" >
| < WITH: "with" >
}
*/
/* LITERALS */
TOKEN :
{
< INTEGER_LITERAL:
(["l","L"])?
| (["l","L"])?
| (["l","L"])?
| (["l","L"])?
>
| < #DECIMAL_NUMERAL: ["1"-"9"] (("_")* ["0"-"9"])* >
| < #HEX_NUMERAL: "0" ["x","X"] >
| < #BINARY_NUMERAL: "0" ["b","B"] ["0","1"] (("_")* ["0","1"])* >
| < #OCTAL_NUMERAL: "0" (("_")* ["0"-"7"])* >
|
< FLOATING_POINT_LITERAL:
|
>
| < #DECIMAL_FLOATING_POINT_LITERAL:
"." ()? ()? (["f","F", "d","D"])?
| "." ()? (["f","F", "d","D"])?
| (["f","F", "d","D"])?
| ()? ["f","F", "d","D"]
>
| < #HEX_FLOATING_POINT_LITERAL:
"0" ["x","X"] (".")? (["f","F", "d","D"])?
| "0" ["x","X"] ()? "." (["f","F", "d","D"])?
>
| < #DIGIT_SEQ: ["0"-"9"] (("_")* ["0"-"9"])* >
| < #HEX_DIGIT_SEQ: ["0"-"9","a"-"f","A"-"F"] (("_")* ["0"-"9","a"-"f","A"-"F"])* >
| < #EXPONENT: ["e","E"] >
| < #HEX_EXPONENT: ["p","P"] >
| < #EXPONENT_TAIL: (["+","-"])? >
| < CHARACTER_LITERAL: "'" ( ~["'", "\\","\n","\r"] | ) "'" >
| < STRING_LITERAL: "\"" ()* "\"" >
| < #STRING_CHARACTER: ~["\"","\\","\n","\r"] | >
| < #STRING_ESCAPE:
"\\"
( ["n","t","b","r","f","s","\\","'","\""]
// octal escapes
| ["0"-"7"] ( ["0"-"7"] )?
| ["0"-"3"] ["0"-"7"] ["0"-"7"]
)
>
| < #TEXT_BLOCK_CHARACTER: ~["\\"] | | ("\\")? >
| < #STRING_FRAGMENT: ()* >
| < STRING_TEMPLATE_BEGIN: "\"" "\\{" > { pushTemplate(false); }
}
/* TEXT BLOCKS */
// note: Text Blocks need an own lexical state, so that we can reliably determine
// the end of the text block (""") which is 3 characters long.
MORE :
{
< "\"\"\"" ()* > : IN_TEXT_BLOCK_LITERAL
}
TOKEN : {
: DEFAULT
| { pushTemplate(true); }: DEFAULT
}
MORE :
{
< >
}
TOKEN:
{
< STRING_TEMPLATE_END: "\"" > : DEFAULT
| < STRING_TEMPLATE_MID: "\\{" > { pushTemplate(false); } : DEFAULT
}
/* IDENTIFIERS */
TOKEN :
{
< IDENTIFIER : ( )* >
// all chars for which Character.isJavaIdentifierStart is true
| < #LETTER : ["$","A"-"Z","_","a"-"z","\u00a2"-"\u00a5","\u00aa","\u00b5","\u00ba",
"\u00c0"-"\u00d6","\u00d8"-"\u00f6","\u00f8"-"\u021f","\u0222"-"\u0233","\u0250"-"\u02ad",
"\u02b0"-"\u02b8","\u02bb"-"\u02c1","\u02d0"-"\u02d1","\u02e0"-"\u02e4","\u02ee","\u037a",
"\u0386","\u0388"-"\u038a","\u038c","\u038e"-"\u03a1","\u03a3"-"\u03ce","\u03d0"-"\u03d7",
"\u03da"-"\u03f3","\u0400"-"\u0481","\u048c"-"\u04c4","\u04c7"-"\u04c8","\u04cb"-"\u04cc",
"\u04d0"-"\u04f5","\u04f8"-"\u04f9","\u0531"-"\u0556","\u0559","\u0561"-"\u0587",
"\u05d0"-"\u05ea","\u05f0"-"\u05f2","\u0621"-"\u063a","\u0640"-"\u064a","\u0671"-"\u06d3",
"\u06d5","\u06e5"-"\u06e6","\u06fa"-"\u06fc","\u0710","\u0712"-"\u072c","\u0780"-"\u07a5",
"\u0905"-"\u0939","\u093d","\u0950","\u0958"-"\u0961","\u0985"-"\u098c","\u098f"-"\u0990",
"\u0993"-"\u09a8","\u09aa"-"\u09b0","\u09b2","\u09b6"-"\u09b9","\u09dc"-"\u09dd",
"\u09df"-"\u09e1","\u09f0"-"\u09f3","\u0a05"-"\u0a0a","\u0a0f"-"\u0a10","\u0a13"-"\u0a28",
"\u0a2a"-"\u0a30","\u0a32"-"\u0a33","\u0a35"-"\u0a36","\u0a38"-"\u0a39","\u0a59"-"\u0a5c",
"\u0a5e","\u0a72"-"\u0a74","\u0a85"-"\u0a8b","\u0a8d","\u0a8f"-"\u0a91","\u0a93"-"\u0aa8",
"\u0aaa"-"\u0ab0","\u0ab2"-"\u0ab3","\u0ab5"-"\u0ab9","\u0abd","\u0ad0","\u0ae0",
"\u0b05"-"\u0b0c","\u0b0f"-"\u0b10","\u0b13"-"\u0b28","\u0b2a"-"\u0b30","\u0b32"-"\u0b33",
"\u0b36"-"\u0b39","\u0b3d","\u0b5c"-"\u0b5d","\u0b5f"-"\u0b61","\u0b85"-"\u0b8a",
"\u0b8e"-"\u0b90","\u0b92"-"\u0b95","\u0b99"-"\u0b9a","\u0b9c","\u0b9e"-"\u0b9f",
"\u0ba3"-"\u0ba4","\u0ba8"-"\u0baa","\u0bae"-"\u0bb5","\u0bb7"-"\u0bb9","\u0c05"-"\u0c0c",
"\u0c0e"-"\u0c10","\u0c12"-"\u0c28","\u0c2a"-"\u0c33","\u0c35"-"\u0c39","\u0c60"-"\u0c61",
"\u0c85"-"\u0c8c","\u0c8e"-"\u0c90","\u0c92"-"\u0ca8","\u0caa"-"\u0cb3","\u0cb5"-"\u0cb9",
"\u0cde","\u0ce0"-"\u0ce1","\u0d05"-"\u0d0c","\u0d0e"-"\u0d10","\u0d12"-"\u0d28",
"\u0d2a"-"\u0d39","\u0d60"-"\u0d61","\u0d85"-"\u0d96","\u0d9a"-"\u0db1","\u0db3"-"\u0dbb",
"\u0dbd","\u0dc0"-"\u0dc6","\u0e01"-"\u0e30","\u0e32"-"\u0e33","\u0e3f"-"\u0e46",
"\u0e81"-"\u0e82","\u0e84","\u0e87"-"\u0e88","\u0e8a","\u0e8d","\u0e94"-"\u0e97",
"\u0e99"-"\u0e9f","\u0ea1"-"\u0ea3","\u0ea5","\u0ea7","\u0eaa"-"\u0eab","\u0ead"-"\u0eb0",
"\u0eb2"-"\u0eb3","\u0ebd","\u0ec0"-"\u0ec4","\u0ec6","\u0edc"-"\u0edd","\u0f00",
"\u0f40"-"\u0f47","\u0f49"-"\u0f6a","\u0f88"-"\u0f8b","\u1000"-"\u1021","\u1023"-"\u1027",
"\u1029"-"\u102a","\u1050"-"\u1055","\u10a0"-"\u10c5","\u10d0"-"\u10f6","\u1100"-"\u1159",
"\u115f"-"\u11a2","\u11a8"-"\u11f9","\u1200"-"\u1206","\u1208"-"\u1246","\u1248",
"\u124a"-"\u124d","\u1250"-"\u1256","\u1258","\u125a"-"\u125d","\u1260"-"\u1286","\u1288",
"\u128a"-"\u128d","\u1290"-"\u12ae","\u12b0","\u12b2"-"\u12b5","\u12b8"-"\u12be","\u12c0",
"\u12c2"-"\u12c5","\u12c8"-"\u12ce","\u12d0"-"\u12d6","\u12d8"-"\u12ee","\u12f0"-"\u130e",
"\u1310","\u1312"-"\u1315","\u1318"-"\u131e","\u1320"-"\u1346","\u1348"-"\u135a",
"\u13a0"-"\u13f4","\u1401"-"\u166c","\u166f"-"\u1676","\u1681"-"\u169a","\u16a0"-"\u16ea",
"\u1780"-"\u17b3","\u17db","\u1820"-"\u1877","\u1880"-"\u18a8","\u1e00"-"\u1e9b",
"\u1ea0"-"\u1ef9","\u1d00"-"\u1eef","\u1f00"-"\u1f15","\u1f18"-"\u1f1d","\u1f20"-"\u1f45","\u1f48"-"\u1f4d",
"\u1f50"-"\u1f57","\u1f59","\u1f5b","\u1f5d","\u1f5f"-"\u1f7d","\u1f80"-"\u1fb4",
"\u1fb6"-"\u1fbc","\u1fbe","\u1fc2"-"\u1fc4","\u1fc6"-"\u1fcc","\u1fd0"-"\u1fd3",
"\u1fd6"-"\u1fdb","\u1fe0"-"\u1fec","\u1ff2"-"\u1ff4","\u1ff6"-"\u1ffc","\u203f"-"\u2040",
"\u207f","\u20a0"-"\u20af","\u2102","\u2107","\u210a"-"\u2113","\u2115","\u2119"-"\u211d",
"\u2124","\u2126","\u2128","\u212a"-"\u212d","\u212f"-"\u2131","\u2133"-"\u2139",
"\u2160"-"\u2183","\u3005"-"\u3007","\u3021"-"\u3029","\u3031"-"\u3035","\u3038"-"\u303a",
"\u3041"-"\u3094","\u309d"-"\u309e","\u30a1"-"\u30fe","\u3105"-"\u312c","\u3131"-"\u318e",
"\u31a0"-"\u31b7","\u3400"-"\u4db5","\u4e00"-"\u9fa5","\ua000"-"\ua48c","\ua490"-"\uabff","\uac00"-"\ud7a3",
"\uf900"-"\ufa2d","\ufb00"-"\ufb06","\ufb13"-"\ufb17","\ufb1d","\ufb1f"-"\ufb28",
"\ufb2a"-"\ufb36","\ufb38"-"\ufb3c","\ufb3e","\ufb40"-"\ufb41","\ufb43"-"\ufb44",
"\ufb46"-"\ufbb1","\ufbd3"-"\ufd3d","\ufd50"-"\ufd8f","\ufd92"-"\ufdc7","\ufdf0"-"\ufdfb",
"\ufe33"-"\ufe34","\ufe4d"-"\ufe4f","\ufe69","\ufe70"-"\ufe72","\ufe74","\ufe76"-"\ufefc",
"\uff04","\uff21"-"\uff3a","\uff3f","\uff41"-"\uff5a","\uff65"-"\uffbe","\uffc2"-"\uffc7",
"\uffca"-"\uffcf","\uffd2"-"\uffd7","\uffda"-"\uffdc","\uffe0"-"\uffe1","\uffe5"-"\uffe6"]>
// all chars for which Character.isJavaIdentifierPart is true
| < #PART_LETTER: ["\u0000"-"\b","\u000e"-"\u001b","$","0"-"9","A"-"Z","_","a"-"z",
"\u007f"-"\u009f","\u00a2"-"\u00a5","\u00aa","\u00b5","\u00ba","\u00c0"-"\u00d6",
"\u00d8"-"\u00f6","\u00f8"-"\u021f","\u0222"-"\u0233","\u0250"-"\u02ad","\u02b0"-"\u02b8",
"\u02bb"-"\u02c1","\u02d0"-"\u02d1","\u02e0"-"\u02e4","\u02ee","\u0300"-"\u034e",
"\u0360"-"\u0362","\u037a","\u0386","\u0388"-"\u038a","\u038c","\u038e"-"\u03a1",
"\u03a3"-"\u03ce","\u03d0"-"\u03d7","\u03da"-"\u03f3","\u0400"-"\u0481","\u0483"-"\u0486",
"\u048c"-"\u04c4","\u04c7"-"\u04c8","\u04cb"-"\u04cc","\u04d0"-"\u04f5","\u04f8"-"\u04f9",
"\u0531"-"\u0556","\u0559","\u0561"-"\u0587","\u0591"-"\u05a1","\u05a3"-"\u05b9",
"\u05bb"-"\u05bd","\u05bf","\u05c1"-"\u05c2","\u05c4","\u05d0"-"\u05ea","\u05f0"-"\u05f2",
"\u0621"-"\u063a","\u0640"-"\u0655","\u0660"-"\u0669","\u0670"-"\u06d3","\u06d5"-"\u06dc",
"\u06df"-"\u06e8","\u06ea"-"\u06ed","\u06f0"-"\u06fc","\u070f"-"\u072c","\u0730"-"\u074a",
"\u0780"-"\u07b0","\u0901"-"\u0903","\u0905"-"\u0939","\u093c"-"\u094d","\u0950"-"\u0954",
"\u0958"-"\u0963","\u0966"-"\u096f","\u0981"-"\u0983","\u0985"-"\u098c","\u098f"-"\u0990",
"\u0993"-"\u09a8","\u09aa"-"\u09b0","\u09b2","\u09b6"-"\u09b9","\u09bc","\u09be"-"\u09c4",
"\u09c7"-"\u09c8","\u09cb"-"\u09cd","\u09d7","\u09dc"-"\u09dd","\u09df"-"\u09e3",
"\u09e6"-"\u09f3","\u0a02","\u0a05"-"\u0a0a","\u0a0f"-"\u0a10","\u0a13"-"\u0a28",
"\u0a2a"-"\u0a30","\u0a32"-"\u0a33","\u0a35"-"\u0a36","\u0a38"-"\u0a39","\u0a3c",
"\u0a3e"-"\u0a42","\u0a47"-"\u0a48","\u0a4b"-"\u0a4d","\u0a59"-"\u0a5c","\u0a5e",
"\u0a66"-"\u0a74","\u0a81"-"\u0a83","\u0a85"-"\u0a8b","\u0a8d","\u0a8f"-"\u0a91",
"\u0a93"-"\u0aa8","\u0aaa"-"\u0ab0","\u0ab2"-"\u0ab3","\u0ab5"-"\u0ab9","\u0abc"-"\u0ac5",
"\u0ac7"-"\u0ac9","\u0acb"-"\u0acd","\u0ad0","\u0ae0","\u0ae6"-"\u0aef","\u0b01"-"\u0b03",
"\u0b05"-"\u0b0c","\u0b0f"-"\u0b10","\u0b13"-"\u0b28","\u0b2a"-"\u0b30","\u0b32"-"\u0b33",
"\u0b36"-"\u0b39","\u0b3c"-"\u0b43","\u0b47"-"\u0b48","\u0b4b"-"\u0b4d","\u0b56"-"\u0b57",
"\u0b5c"-"\u0b5d","\u0b5f"-"\u0b61","\u0b66"-"\u0b6f","\u0b82"-"\u0b83","\u0b85"-"\u0b8a",
"\u0b8e"-"\u0b90","\u0b92"-"\u0b95","\u0b99"-"\u0b9a","\u0b9c","\u0b9e"-"\u0b9f",
"\u0ba3"-"\u0ba4","\u0ba8"-"\u0baa","\u0bae"-"\u0bb5","\u0bb7"-"\u0bb9","\u0bbe"-"\u0bc2",
"\u0bc6"-"\u0bc8","\u0bca"-"\u0bcd","\u0bd7","\u0be7"-"\u0bef","\u0c01"-"\u0c03",
"\u0c05"-"\u0c0c","\u0c0e"-"\u0c10","\u0c12"-"\u0c28","\u0c2a"-"\u0c33","\u0c35"-"\u0c39",
"\u0c3e"-"\u0c44","\u0c46"-"\u0c48","\u0c4a"-"\u0c4d","\u0c55"-"\u0c56","\u0c60"-"\u0c61",
"\u0c66"-"\u0c6f","\u0c82"-"\u0c83","\u0c85"-"\u0c8c","\u0c8e"-"\u0c90","\u0c92"-"\u0ca8",
"\u0caa"-"\u0cb3","\u0cb5"-"\u0cb9","\u0cbe"-"\u0cc4","\u0cc6"-"\u0cc8","\u0cca"-"\u0ccd",
"\u0cd5"-"\u0cd6","\u0cde","\u0ce0"-"\u0ce1","\u0ce6"-"\u0cef","\u0d02"-"\u0d03",
"\u0d05"-"\u0d0c","\u0d0e"-"\u0d10","\u0d12"-"\u0d28","\u0d2a"-"\u0d39","\u0d3e"-"\u0d43",
"\u0d46"-"\u0d48","\u0d4a"-"\u0d4d","\u0d57","\u0d60"-"\u0d61","\u0d66"-"\u0d6f",
"\u0d82"-"\u0d83","\u0d85"-"\u0d96","\u0d9a"-"\u0db1","\u0db3"-"\u0dbb","\u0dbd",
"\u0dc0"-"\u0dc6","\u0dca","\u0dcf"-"\u0dd4","\u0dd6","\u0dd8"-"\u0ddf","\u0df2"-"\u0df3",
"\u0e01"-"\u0e3a","\u0e3f"-"\u0e4e","\u0e50"-"\u0e59","\u0e81"-"\u0e82","\u0e84",
"\u0e87"-"\u0e88","\u0e8a","\u0e8d","\u0e94"-"\u0e97","\u0e99"-"\u0e9f","\u0ea1"-"\u0ea3",
"\u0ea5","\u0ea7","\u0eaa"-"\u0eab","\u0ead"-"\u0eb9","\u0ebb"-"\u0ebd","\u0ec0"-"\u0ec4",
"\u0ec6","\u0ec8"-"\u0ecd","\u0ed0"-"\u0ed9","\u0edc"-"\u0edd","\u0f00","\u0f18"-"\u0f19",
"\u0f20"-"\u0f29","\u0f35","\u0f37","\u0f39","\u0f3e"-"\u0f47","\u0f49"-"\u0f6a",
"\u0f71"-"\u0f84","\u0f86"-"\u0f8b","\u0f90"-"\u0f97","\u0f99"-"\u0fbc","\u0fc6",
"\u1000"-"\u1021","\u1023"-"\u1027","\u1029"-"\u102a","\u102c"-"\u1032","\u1036"-"\u1039",
"\u1040"-"\u1049","\u1050"-"\u1059","\u10a0"-"\u10c5","\u10d0"-"\u10f6","\u1100"-"\u1159",
"\u115f"-"\u11a2","\u11a8"-"\u11f9","\u1200"-"\u1206","\u1208"-"\u1246","\u1248",
"\u124a"-"\u124d","\u1250"-"\u1256","\u1258","\u125a"-"\u125d","\u1260"-"\u1286",
"\u1288","\u128a"-"\u128d","\u1290"-"\u12ae","\u12b0","\u12b2"-"\u12b5","\u12b8"-"\u12be",
"\u12c0","\u12c2"-"\u12c5","\u12c8"-"\u12ce","\u12d0"-"\u12d6","\u12d8"-"\u12ee",
"\u12f0"-"\u130e","\u1310","\u1312"-"\u1315","\u1318"-"\u131e","\u1320"-"\u1346",
"\u1348"-"\u135a","\u1369"-"\u1371","\u13a0"-"\u13f4","\u1401"-"\u166c","\u166f"-"\u1676",
"\u1681"-"\u169a","\u16a0"-"\u16ea","\u1780"-"\u17d3","\u17db","\u17e0"-"\u17e9",
"\u180b"-"\u180e","\u1810"-"\u1819","\u1820"-"\u1877","\u1880"-"\u18a9","\u1d00"-"\u1d7f","\u1e00"-"\u1e9b",
"\u1ea0"-"\u1ef9","\u1f00"-"\u1f15","\u1f18"-"\u1f1d","\u1f20"-"\u1f45","\u1f48"-"\u1f4d",
"\u1f50"-"\u1f57","\u1f59","\u1f5b","\u1f5d","\u1f5f"-"\u1f7d","\u1f80"-"\u1fb4",
"\u1fb6"-"\u1fbc","\u1fbe","\u1fc2"-"\u1fc4","\u1fc6"-"\u1fcc","\u1fd0"-"\u1fd3",
"\u1fd6"-"\u1fdb","\u1fe0"-"\u1fec","\u1ff2"-"\u1ff4","\u1ff6"-"\u1ffc","\u200c"-"\u200f",
"\u202a"-"\u202e","\u203f"-"\u2040","\u206a"-"\u206f","\u207f","\u20a0"-"\u20af",
"\u20d0"-"\u20dc","\u20e1","\u2102","\u2107","\u210a"-"\u2113","\u2115","\u2119"-"\u211d",
"\u2124","\u2126","\u2128","\u212a"-"\u212d","\u212f"-"\u2131","\u2133"-"\u2139",
"\u2160"-"\u2183","\u3005"-"\u3007","\u3021"-"\u302f","\u3031"-"\u3035","\u3038"-"\u303a",
"\u3041"-"\u3094","\u3099"-"\u309a","\u309d"-"\u309e","\u30a1"-"\u30fe","\u3105"-"\u312c",
"\u3131"-"\u318e","\u31a0"-"\u31b7","\u3400"-"\u4db5","\u4e00"-"\u9fa5","\ua000"-"\ua48c",
"\ua490"-"\uabff",
"\uac00"-"\ud7a3","\uf900"-"\ufa2d","\ufb00"-"\ufb06","\ufb13"-"\ufb17","\ufb1d"-"\ufb28",
"\ufb2a"-"\ufb36","\ufb38"-"\ufb3c","\ufb3e","\ufb40"-"\ufb41","\ufb43"-"\ufb44",
"\ufb46"-"\ufbb1","\ufbd3"-"\ufd3d","\ufd50"-"\ufd8f","\ufd92"-"\ufdc7","\ufdf0"-"\ufdfb",
"\ufe20"-"\ufe23","\ufe33"-"\ufe34","\ufe4d"-"\ufe4f","\ufe69","\ufe70"-"\ufe72","\ufe74",
"\ufe76"-"\ufefc","\ufeff","\uff04","\uff10"-"\uff19","\uff21"-"\uff3a","\uff3f",
"\uff41"-"\uff5a","\uff65"-"\uffbe","\uffc2"-"\uffc7","\uffca"-"\uffcf","\uffd2"-"\uffd7",
"\uffda"-"\uffdc","\uffe0"-"\uffe1","\uffe5"-"\uffe6","\ufff9"-"\ufffb"]>
}
/* SEPARATORS */
TOKEN :
{
< LPAREN: "(" >
| < RPAREN: ")" >
| < LBRACE: "{" > { pushBrace(); }
| < RBRACE: "}" > { popBrace(); }
| < LBRACKET: "[" >
| < RBRACKET: "]" >
| < SEMICOLON: ";" >
| < COMMA: "," >
| < DOT: "." >
| < AT: "@" >
}
/* OPERATORS */
TOKEN :
{
< ASSIGN: "=" >
| < LT: "<" >
| < BANG: "!" >
| < TILDE: "~" >
| < HOOK: "?" >
| < COLON: ":" >
| < EQ: "==" >
| < LE: "<=" >
| < GE: ">=" >
| < NE: "!=" >
| < SC_OR: "||" >
| < SC_AND: "&&" >
| < INCR: "++" >
| < DECR: "--" >
| < PLUS: "+" >
| < MINUS: "-" >
| < STAR: "*" >
| < SLASH: "/" >
| < BIT_AND: "&" >
| < BIT_OR: "|" >
| < XOR: "^" >
| < REM: "%" >
| < LSHIFT: "<<" >
// Notice the absence of >> or >>>, to not conflict with generics
| < PLUSASSIGN: "+=" >
| < MINUSASSIGN: "-=" >
| < STARASSIGN: "*=" >
| < SLASHASSIGN: "/=" >
| < ANDASSIGN: "&=" >
| < ORASSIGN: "|=" >
| < XORASSIGN: "^=" >
| < REMASSIGN: "%=" >
| < LSHIFTASSIGN: "<<=" >
| < RSIGNEDSHIFTASSIGN: ">>=" >
| < RUNSIGNEDSHIFTASSIGN: ">>>=" >
| < ELLIPSIS: "..." >
| < LAMBDA: "->" >
| < METHOD_REF: "::" >
}
/* >'s need special attention due to generics syntax. */
TOKEN :
{
< RUNSIGNEDSHIFT: ">>>" > { input_stream.backup(2); }
| < RSIGNEDSHIFT: ">>" > { input_stream.backup(1); }
| < GT: ">" >
}
/*****************************************
* THE JAVA LANGUAGE GRAMMAR STARTS HERE *
*****************************************/
/*
* Program structuring syntax follows.
*/
ASTCompilationUnit CompilationUnit() :
{}
{
[ LOOKAHEAD( ( Annotation() )* "package" ) PackageDeclaration() ( EmptyDeclaration() )* ]
( ImportDeclaration() ( EmptyDeclaration() )* )*
// ModularCompilationUnit:
// the module decl lookahead needs to be before the type declaration branch,
// looking for annotations + "open" | "module" will fail faster if it's *not*
// a module (most common case)
[ LOOKAHEAD(ModuleDeclLahead()) ModuleDeclaration() ( EmptyDeclaration() )* ]
// OrdinaryCompilationUnit: -> TopLevelClassOrInterfaceDeclaration
( TypeDeclaration() ( EmptyDeclaration() )* )*
// SimpleCompilationUnit:
[
(
{ pushEmptyModifierList(); }
(
( LOOKAHEAD(3) ClassMemberDeclarationNoMethod() )*
ModifierList() MethodDeclaration()
( ClassOrInterfaceBodyDeclaration() )*
) #ClassBody
) #ImplicitClassDeclaration
]
{
jjtThis.setComments(token_source.comments);
return jjtThis;
}
}
// see ClassOrInterfaceBodyDeclaration()
void ClassMemberDeclarationNoMethod() #void:
{}
{
ModifierList()
( LOOKAHEAD(3) ClassOrInterfaceDeclaration()
| LOOKAHEAD({isKeyword("enum")}) EnumDeclaration()
| LOOKAHEAD({isKeyword("record")}) RecordDeclaration()
| LOOKAHEAD( [ TypeParameters() ] "(" ) ConstructorDeclaration()
| LOOKAHEAD( Type() (AnnotationList() "[" "]")* ( "," | "=" | ";" ) ) FieldDeclaration()
| LOOKAHEAD(2) AnnotationTypeDeclaration()
)
}
private void ModuleDeclLahead() #void:
{}
{
(Annotation())* LOOKAHEAD({isKeyword("open") || isKeyword("module")})
}
void PackageDeclaration() :
{String image;}
{
ModAnnotationList() "package" image=VoidName() { jjtThis.setImage(image); } ";"
}
void ImportDeclaration() :
{String image;}
{
"import"
(
"static" {jjtThis.setStatic();}
| LOOKAHEAD({isKeyword("module")}) {jjtThis.setModuleImport();}
)?
image=VoidName() { jjtThis.setImage(image); }
[ "." "*" {jjtThis.setImportOnDemand();} ] ";"
}
/*
* Modifiers. We match all modifiers in a single rule to reduce the chances of
* syntax errors for simple modifier mistakes. It will also enable us to give
* better error messages.
*/
void ModifierList():
{
EnumSet modifiers = EnumSet.noneOf(JModifier.class);
}
{
(
LOOKAHEAD(2)
(
"public" { modifiers.add(JModifier.PUBLIC); }
| "static" { modifiers.add(JModifier.STATIC); }
| "protected" { modifiers.add(JModifier.PROTECTED); }
| "private" { modifiers.add(JModifier.PRIVATE); }
| "final" { modifiers.add(JModifier.FINAL); }
| "abstract" { modifiers.add(JModifier.ABSTRACT); }
| "synchronized" { modifiers.add(JModifier.SYNCHRONIZED); }
| "native" { modifiers.add(JModifier.NATIVE); }
| "transient" { modifiers.add(JModifier.TRANSIENT); }
| "volatile" { modifiers.add(JModifier.VOLATILE); }
| "strictfp" { modifiers.add(JModifier.STRICTFP); }
| "default" { modifiers.add(JModifier.DEFAULT); }
| LOOKAHEAD({isKeyword("sealed")}) { modifiers.add(JModifier.SEALED); }
| LOOKAHEAD({isNonSealedModifier()}) { modifiers.add(JModifier.NON_SEALED); }
| Annotation()
)
)*
{ jjtThis.setDeclaredModifiers(modifiers); }
{ jjtree.injectRight(1); } // inject the modifier node in the follower
}
/*
* Declaration syntax follows.
*/
void TypeDeclaration() #void:
{}
{
ModifierList()
(
ClassOrInterfaceDeclaration()
| AnnotationTypeDeclaration()
| LOOKAHEAD({isKeyword("enum")}) EnumDeclaration()
| LOOKAHEAD({isKeyword("record")}) RecordDeclaration()
)
}
void ClassOrInterfaceDeclaration() #ClassDeclaration:
{}
{
( "class" | "interface" { jjtThis.setInterface(); } )
{ jjtThis.setSimpleName(getToken(0).getImage()); }
[ TypeParameters() ]
[ ExtendsList() ]
[ ImplementsList() ]
[ LOOKAHEAD({isKeyword("permits")}) PermittedSubclasses() ]
ClassOrInterfaceBody()
}
void ExtendsList():
{}
{
"extends" AnnotatedClassOrInterfaceType()
( "," AnnotatedClassOrInterfaceType() )*
}
void ImplementsList():
{}
{
"implements" AnnotatedClassOrInterfaceType()
( "," AnnotatedClassOrInterfaceType() )*
}
void PermittedSubclasses() #PermitsList:
{}
{
softKeyword("permits")
ClassOrInterfaceType()
( "," ClassOrInterfaceType() )*
}
void EnumDeclaration():
{}
{
softKeyword("enum")
{ jjtThis.setSimpleName(getToken(0).getImage()); }
[ ImplementsList() ]
EnumBody()
}
void EnumBody():
{}
{
"{"
[ EnumConstant() ( LOOKAHEAD(2) "," EnumConstant() )* ]
[ "," { jjtThis.setTrailingComma(); } ]
[ ";" { jjtThis.setSeparatorSemi(); } ( ClassOrInterfaceBodyDeclaration() )* ]
"}"
}
void EnumConstant():
{}
{
ModAnnotationList() VariableDeclaratorId() [ ArgumentList() ] [ AnonymousClassDeclaration() ]
}
void RecordDeclaration():
{}
{
softKeyword("record")
{ jjtThis.setSimpleName(getToken(0).getImage()); }
[ TypeParameters() ]
RecordHeader()
[ ImplementsList() ]
RecordBody()
}
void RecordHeader() #void:
{}
{
"(" RecordComponentList() ")"
}
void RecordComponentList() :
{}
{
[ RecordComponent() ("," RecordComponent())* ]
}
void RecordComponent():
{}
{
ModAnnotationList()
FormalParamType()
VariableDeclaratorId()
}
void RecordBody():
{}
{
"{"
( RecordBodyDeclaration() )*
"}"
}
void RecordBodyDeclaration() #void :
{}
{
LOOKAHEAD(CompactConstructorDeclarationLookahead()) ModifierList() CompactConstructorDeclaration()
|
ClassOrInterfaceBodyDeclaration()
}
private void CompactConstructorDeclarationLookahead() #void:
{}
{
ModifierList() "{"
}
void CompactConstructorDeclaration():
{}
{
{ jjtThis.setImage(token.image); }
Block()
}
void TypeParameters():
{}
{
"<" TypeParameter() ( "," TypeParameter() )* ">"
}
void TypeParameter():
{}
{
AnnotationList()
{setLastTokenImage(jjtThis);} [ "extends" IntersectionType() ]
}
void ClassOrInterfaceBody() #ClassBody:
{}
{
"{"
( ClassOrInterfaceBodyDeclaration() )*
"}"
}
void ClassOrInterfaceBodyDeclaration() #void:
{}
{ LOOKAHEAD(["static"] "{" ) Initializer()
| ModifierList()
( LOOKAHEAD(3) ClassOrInterfaceDeclaration()
| LOOKAHEAD({isKeyword("enum")}) EnumDeclaration()
| LOOKAHEAD({isKeyword("record")}) RecordDeclaration()
| LOOKAHEAD( [ TypeParameters() ] "(" ) ConstructorDeclaration()
| LOOKAHEAD( Type() (AnnotationList() "[" "]")* ( "," | "=" | ";" ) ) FieldDeclaration()
| LOOKAHEAD(2) MethodDeclaration()
| LOOKAHEAD(2) AnnotationTypeDeclaration()
)
|
";" #EmptyDeclaration
}
void FieldDeclaration() :
{}
{
Type() VariableDeclarator() ( "," VariableDeclarator() )* ";"
}
void VariableDeclarator() :
{}
{
VariableIdWithDims() [ "=" VariableInitializer() ]
}
void VariableDeclaratorId() #VariableId:
{}
{
{ jjtThis.setName(getToken(0).getImage()); }
}
void VariableIdWithDims() #VariableId :
{}
{
{ jjtThis.setName(getToken(0).getImage()); }
[ Dims() ]
}
void ReceiverParameter():
{}
{
AnnotatedClassOrInterfaceType() [ "." ] "this"
}
void VariableInitializer() #void:
{}
{
ArrayInitializer()
| Expression()
}
void ArrayInitializer() :
{}
{
"{"
[ VariableInitializer() ( LOOKAHEAD(2) "," VariableInitializer() )* ] [ "," ]
"}"
}
void MethodDeclaration() :
{}
{
[ TypeParameters() ]
ResultType()
{ jjtThis.setName(getToken(0).getImage()); }
FormalParameters()
[ Dims() ]
[ ThrowsList() ]
( Block() | ";" )
}
void FormalParameters() :
{}
{
"(" [ ( LOOKAHEAD(ReceiverParameter()) ReceiverParameter() | FormalParameter() ) ( "," FormalParameter() )* ] ")"
}
void FormalParameter() :
{}
{
LocalVarModifierList()
FormalParamType() ("|" FormalParamType())* // remove this stuff when #2202 is merged
VariableIdWithDims()
}
void FormalParamType() #void:
{}
{
PrimitiveType() [ LOOKAHEAD(2) VarargsDimensions() #ArrayType(2) ]
| ClassOrInterfaceType() [ LOOKAHEAD(2) VarargsDimensions() #ArrayType(2) ]
}
void VarargsDimensions() #ArrayDimensions:
{}
{
// like ArrayDimensions but allows for a varargs ellipsis at the end ("...")
LOOKAHEAD(AnnotationList() "[") (LOOKAHEAD(AnnotationList() "[") ArrayTypeDim())+ [ VarargsDim() ]
| VarargsDim()
}
void VarargsDim() #ArrayTypeDim:
{}
{
TypeAnnotListNoInject() "..." {jjtThis.setVarargs();}
}
void ConstructorDeclaration() :
{}
{
[ TypeParameters() ]
{setLastTokenImage(jjtThis);}
FormalParameters()
[ ThrowsList() ]
ConstructorBlock()
}
private void ConstructorBlock() #Block:
{}
{
"{"
(
LOOKAHEAD(ExplicitConstructorInvocation()) ExplicitConstructorInvocation()
|
( LOOKAHEAD(2) BlockStatement() )*
[ LOOKAHEAD(ExplicitConstructorInvocation()) ExplicitConstructorInvocation() ]
)
( BlockStatement() )*
"}"
}
void ExplicitConstructorInvocation() :
{boolean prev = inExplicitConstructorInvoc; inExplicitConstructorInvoc = true;}
{
// We may only lookahead one token here, because:
// * "this" or "super" can't appear in the primary expression in case of
// qualified super call (last branch), or else compile error, so if we
// see one of them, then the rest is necessarily the arguments
// But: "this" may appear if it's qualified!
// * No primary expression may start with "<", meaning we can use it to
// know we're looking forward to type arguments
( LOOKAHEAD("<") TypeArguments() ( "this" | "super" {jjtThis.setIsSuper();} )
| LOOKAHEAD("this") "this"
| LOOKAHEAD("super") "super" {jjtThis.setIsSuper();}
| PrimaryExpression() "." [ TypeArguments() ] "super" {jjtThis.setIsSuper();}
)
// reset this before parsing the arguments list
{inExplicitConstructorInvoc = prev;}
ArgumentList() ";"
}
void Initializer() :
{}
{
[ "static" {jjtThis.setStatic();} ] Block()
}
/* JLS: https://docs.oracle.com/javase/specs/jls/se8/html/jls-4.html#jls-4.3
ReferenceType:
ClassOrInterfaceType
TypeVariable
ArrayType
ClassOrInterfaceType:
ClassType
InterfaceType
ClassType:
{Annotation} Identifier [TypeArguments]
ClassOrInterfaceType . {Annotation} Identifier [TypeArguments]
InterfaceType:
ClassType
TypeVariable:
{Annotation} Identifier
ArrayType:
PrimitiveType Dims
ClassOrInterfaceType Dims
TypeVariable Dims
Dims:
{Annotation} [ ] {{Annotation} [ ]}
*/
void IntersectionType() #IntersectionType(isIntersection):
{boolean isIntersection=false;}
{
AnnotatedType() ( "&" {isIntersection=true;} AnnotatedClassOrInterfaceType() )*
}
void AnnotationList() #void:
{}
{
(Annotation())*
}
void ModAnnotationList() #ModifierList:
{jjtThis.setDeclaredModifiers(Collections.emptySet());}
{
(Annotation())*
}
int TypeAnnotListNoInject() #void:
{int num = 0;}
{
( TypeAnnotation() {num++;} )*
{
return num;
}
}
// Type annotation lists are by default injected in the
// next node to be opened (most likely a type).
// Sometimes (array dims), this need not be and TypeAnnotListNoInject
// should be used.
void TypeAnnotationList() #void:
{int size=0;}
{
size=TypeAnnotListNoInject() { jjtree.injectRight(size); }
}
void AnnotatedType() #void:
{}
{
TypeAnnotationList() Type()
}
void AnnotatedRefType() #void:
{}
{
TypeAnnotationList() ReferenceType()
}
void AnnotatedClassOrInterfaceType() #void:
{}
{
TypeAnnotationList() ClassOrInterfaceType()
}
/*
* Type, name and expression syntax follows.
* Type is the same as "UnannType" in JLS
*
* See https://docs.oracle.com/javase/specs/jls/se10/html/jls-8.html#jls-UnannType
*/
void Type() #void:
{}
{
PrimitiveType() [ LOOKAHEAD(2) Dims() #ArrayType(2) ]
| ClassOrInterfaceType() [ LOOKAHEAD(2) Dims() #ArrayType(2) ]
}
void Dims() #ArrayDimensions:
{}
{
// the list of dimensions is flat, but annotations are
// preserved within each specific dim.
(ArrayTypeDim())+
}
void ArrayTypeDim():
{}
{
TypeAnnotListNoInject() "[" "]"
}
void ReferenceType() #void:
{}
{
// We parse it that way because the right injection considers node openings,
// which means if we want the annotations to belong to the element type, then
// the ArrayType node needs to be opened after eg the PrimitiveType
PrimitiveType() Dims() #ArrayType(2)
| ClassOrInterfaceType() [ LOOKAHEAD(2) Dims() #ArrayType(2) ]
}
/**
* Parses a ClassOrInterfaceType. The production itself is #void,
* but the node exists (declared inline within the production).
*/
void ClassOrInterfaceType() #void:
{}
{
(LOOKAHEAD({jjtree.isInjectionPending()})
// Perhaps surprisingly a type annotation binds to the closest segment
// So in "@B Map.Entry", "@B" binds to "Map", and Map is required to be a type name.
// If the annotation is not applicable to TYPE_USE then it doesn't compile
// So if there are annotations pending injection here, then they're necessarily
// type annotations, since otherwise they would have been consumed in the
// annotation list of a declaration.
// Eg in "public abstract @F int foo();", "@F" is part of the modifier list of the method.
// but in "public abstract @F T foo();", "@F" is necessarily a type annotation, and indeed
// is in a separate AnnotationList (it follows the type parameters so is not a modifier).
// To sum it up, if we have annotations pending, then the first segment is necessarily
// a type name, otherwise it wouldn't have compiled. So it's not ambiguous and we can
// start fresh: "@B Map.Entry" will be unambiguously [[@B Map].Entry]
( { jjtThis.setSimpleName(getToken(0).getImage()); } [ TypeArguments() ]) #ClassType
|
// Otherwise, for now we have no clue until the first type arguments
// or annotation is found. The name is ambiguous between package or
// type name unless type arguments are present, in which case we can
// be sure that the last segment is a type name.
AmbiguousName()
[ TypeArguments() #ClassType(2) ]
{
// At this point the first ClassType may be on top of the stack,
// but its image is not set. If it is on the stack we need to shrink the bounds
// of the ambiguous name, or delete it.
Node first = jjtree.peekNode();
if (first instanceof ASTClassType) {
// then we saw type arguments, so the last segment is definitely a type name
ASTAmbiguousName name = first.firstChild(ASTAmbiguousName.class);
name.shrinkOrDeleteInParentSetImage();
}
}
)
/*
Now if there are other segments, either the previous segment specified type
arguments, or the next has an annotation. Either way we know that all the
following segments is a type name. Each segment is parsed as its own ClassOrInterfaceType
which encloses the previous one. The resulting structure appears left-recursive, but the parser just
executes a loop. That scheme preserves the position of type arguments and annotations.
See #1150.
*/
( LOOKAHEAD(2) "." ClassTypeSegment() )*
{ forceTypeContext(); }
}
private void ClassTypeSegment() #ClassType(jjtree.nodeArity() + 1):
{}
{
TypeAnnotListNoInject()
// We'll enclose the previous segment
{ jjtThis.setSimpleName(getToken(0).getImage()); }
[ TypeArguments() ]
}
void TypeArguments():
{}
{
LOOKAHEAD(2)
"<" TypeArgument() ( "," TypeArgument() )* ">"
|
"<" ">"
}
void TypeArgument() #void:
{}
{
TypeAnnotationList() (ReferenceType() | WildcardType())
}
void WildcardType():
{}
{
"?" [ ("extends" | "super" {jjtThis.setLowerBound(true);}) AnnotatedRefType() ]
}
/* JLS https://docs.oracle.com/javase/specs/jls/se10/html/jls-4.html#jls-PrimitiveType
PrimitiveType:
{Annotation} NumericType
{Annotation} boolean
NumericType:
IntegralType
FloatingPointType
IntegralType:
(one of)
byte short int long char
FloatingPointType:
(one of)
float double
*/
void PrimitiveType() :
{}
{
"boolean" {jjtThis.setKind(PrimitiveTypeKind.BOOLEAN);}
| "char" {jjtThis.setKind(PrimitiveTypeKind.CHAR);}
| "byte" {jjtThis.setKind(PrimitiveTypeKind.BYTE);}
| "short" {jjtThis.setKind(PrimitiveTypeKind.SHORT);}
| "int" {jjtThis.setKind(PrimitiveTypeKind.INT);}
| "long" {jjtThis.setKind(PrimitiveTypeKind.LONG);}
| "float" {jjtThis.setKind(PrimitiveTypeKind.FLOAT);}
| "double" {jjtThis.setKind(PrimitiveTypeKind.DOUBLE);}
}
void ResultType() #void:
{}
{
"void" #VoidType
| AnnotatedType()
}
void ThrowsList() :
{}
{
"throws" AnnotatedClassOrInterfaceType() ( "," AnnotatedClassOrInterfaceType())*
}
/*
* Expression syntax follows.
*/
void Expression() #AssignmentExpression(>1):
/*
* This expansion has been written this way instead of:
* Assignment() | ConditionalExpression()
* for performance reasons.
* However, it is a weakening of the grammar for it allows the LHS of
* assignments to be any conditional expression whereas it can only be
* a primary expression. Consider adding a semantic predicate to work
* around this.
*/
{AssignmentOp op = null;}
{
ConditionalExpression()
[
LOOKAHEAD(1) op=AssignmentOperator() {jjtThis.setOp(op);} Expression()
]
}
AssignmentOp AssignmentOperator() #void:
{}
{
"=" { return AssignmentOp.ASSIGN; }
| "*=" { return AssignmentOp.MUL_ASSIGN; }
| "/=" { return AssignmentOp.DIV_ASSIGN; }
| "%=" { return AssignmentOp.MOD_ASSIGN; }
| "+=" { return AssignmentOp.ADD_ASSIGN; }
| "-=" { return AssignmentOp.SUB_ASSIGN; }
| "<<=" { return AssignmentOp.LEFT_SHIFT_ASSIGN; }
| ">>=" { return AssignmentOp.RIGHT_SHIFT_ASSIGN; }
| ">>>=" { return AssignmentOp.UNSIGNED_RIGHT_SHIFT_ASSIGN; }
| "&=" { return AssignmentOp.AND_ASSIGN; }
| "^=" { return AssignmentOp.XOR_ASSIGN; }
| "|=" { return AssignmentOp.OR_ASSIGN; }
}
void ConditionalExpression() #ConditionalExpression(>1) :
{}
{
ConditionalOrExpression() [LOOKAHEAD(1) "?" Expression() ":" ConditionalExpression() ]
}
void ConditionalOrExpression() #void:
{}
{
ConditionalAndExpression() (LOOKAHEAD(1) ("||" {jjtThis.setOp(BinaryOp.CONDITIONAL_OR);} ConditionalAndExpression()) #InfixExpression(2))*
}
void ConditionalAndExpression() #void:
{}
{
InclusiveOrExpression() (LOOKAHEAD(1) ("&&" {jjtThis.setOp(BinaryOp.CONDITIONAL_AND);} InclusiveOrExpression()) #InfixExpression(2))*
}
void InclusiveOrExpression() #void:
{}
{
ExclusiveOrExpression() (LOOKAHEAD(1) ("|" {jjtThis.setOp(BinaryOp.OR);} ExclusiveOrExpression()) #InfixExpression(2))*
}
void ExclusiveOrExpression() #void:
{}
{
AndExpression() (LOOKAHEAD(1) ("^" {jjtThis.setOp(BinaryOp.XOR);} AndExpression()) #InfixExpression(2))*
}
void AndExpression() #void:
{}
{
EqualityExpression() (LOOKAHEAD(1) ("&" {jjtThis.setOp(BinaryOp.AND);} EqualityExpression()) #InfixExpression(2))*
}
void EqualityExpression() #void:
{}
{
InstanceOfExpression()
(LOOKAHEAD(1)
(
( "==" {jjtThis.setOp(BinaryOp.EQ);}
| "!=" {jjtThis.setOp(BinaryOp.NE);}
)
InstanceOfExpression()
) #InfixExpression(2)
)*
}
void Pattern() #void:
{}
{
LOOKAHEAD((Annotation())* ReferenceType() "(") RecordPattern()
| TypePattern()
}
void TypePattern():
{}
{
LocalVarModifierList() LocalVariableType() VariableDeclaratorId()
}
void RecordPattern():
{}
{
(Annotation())* ReferenceType() RecordStructurePattern()
}
void RecordStructurePattern() #PatternList:
{}
{
"(" [ ComponentPatternList() ] ")"
}
void ComponentPatternList() #void :
{}
{
ComponentPattern() ( "," ComponentPattern() )*
}
void ComponentPattern() #void:
{}
{
LOOKAHEAD({isKeyword("_")}) UnnamedPattern()
| Pattern()
}
void UnnamedPattern():
{}
{
softKeyword("_")
}
void InstanceOfExpression() #void:
{}
{
RelationalExpression() [
("instanceof"
(
LOOKAHEAD(ReferenceType() "(") RecordPattern()
| AnnotatedType() [
VariableDeclaratorId() #TypePattern(2)
| RecordStructurePattern() #RecordPattern(2)
]
| Pattern()
)
{
jjtThis.setOp(BinaryOp.INSTANCEOF);
AbstractJavaNode top = jjtree.popNode();
if (top instanceof ASTPattern) {
if (top instanceof ASTTypePattern && !(top.getChild(0) instanceof ASTModifierList)) {
insertEmptyModifierListWithAnnotations(top, (AbstractJavaNode) top.getChild(0));
}
top = new ASTPatternExpression((ASTPattern) top);
} else {
top = new ASTTypeExpression((ASTType) top);
}
jjtree.pushNode(top);
}
{} // manipulate node before it is closed.
) #InfixExpression(2)
]
}
void RelationalExpression() #void:
{}
{
// There technically cannot be more than one, because it wouldn't compile
// But we give it some leeway to not make the parser too knowledgeable
// From the JLS:
// For example, a" {jjtThis.setOp(BinaryOp.GT);}
| "<=" {jjtThis.setOp(BinaryOp.LE);}
| ">=" {jjtThis.setOp(BinaryOp.GE);}
)
ShiftExpression()
) #InfixExpression(2)
)*
}
void ShiftExpression() #void:
{}
{
AdditiveExpression()
(LOOKAHEAD(1)
(
( "<<" {jjtThis.setOp(BinaryOp.LEFT_SHIFT);}
| RSIGNEDSHIFT() {jjtThis.setOp(BinaryOp.RIGHT_SHIFT);}
| RUNSIGNEDSHIFT() {jjtThis.setOp(BinaryOp.UNSIGNED_RIGHT_SHIFT);}
)
AdditiveExpression()
) #InfixExpression(2)
)*
}
void AdditiveExpression() #void:
{}
{
MultiplicativeExpression()
(LOOKAHEAD(1)
(
( "+" {jjtThis.setOp(BinaryOp.ADD);}
| "-" {jjtThis.setOp(BinaryOp.SUB);}
)
MultiplicativeExpression()
) #InfixExpression(2)
)*
}
void MultiplicativeExpression() #void:
{}
{
UnaryExpression()
(LOOKAHEAD(1)
(
( "*" {jjtThis.setOp(BinaryOp.MUL);}
| "/" {jjtThis.setOp(BinaryOp.DIV);}
| "%" {jjtThis.setOp(BinaryOp.MOD);}
)
UnaryExpression()
) #InfixExpression(2)
)*
}
// TODO update operator setting for those expressions
void UnaryExpression() #void:
{}
{
(("+" {jjtThis.setOp(UnaryOp.UNARY_PLUS);} | "-" {jjtThis.setOp(UnaryOp.UNARY_MINUS);}) UnaryExpression()) #UnaryExpression
| PrefixIncrementExpression()
| UnaryExpressionNotPlusMinus()
}
void PrefixIncrementExpression() #UnaryExpression:
{}
{
("++" {jjtThis.setOp(UnaryOp.PRE_INCREMENT);}
| "--" {jjtThis.setOp(UnaryOp.PRE_DECREMENT);}
)
PrimaryExpression()
}
void UnaryExpressionNotPlusMinus() #void:
{}
{
(( "~" {jjtThis.setOp(UnaryOp.COMPLEMENT);} | "!" {jjtThis.setOp(UnaryOp.NEGATION);}) UnaryExpression()) #UnaryExpression
// There's no separate production for CastExpression, because that would force
// us to repeat the lookahead
// Those lookaheads are quite expensive, they're run to disambiguate between
// ParenthesizedExpression and CastExpression.
| LOOKAHEAD("(" TypeAnnotationList() PrimitiveType() ")")
("(" AnnotatedType() ")" UnaryExpression()) #CastExpression
// here we avoid looking ahead for a whole unary expression, instead just testing the token after ")"
| LOOKAHEAD("(" IntersectionType() ")" UnaryExprNotPmStart() )
("(" IntersectionType() ")" UnaryExpressionNotPlusMinus()) #CastExpression
| PostfixExpression()
| SwitchExpression()
}
private void UnaryExprNotPmStart() #void:
{}
{
// Condensed FIRST set of UnaryExpressionNotPlusMinus
// Avoid looking ahead for a whole UnaryExpressionNotPlusMinus, but just for a token
"~" | "!" | "(" | "switch" | "new" | "this" | "super" | Literal() | "@"
|
| "void" | PrimitiveType()
}
void PostfixExpression() #void:
{}
{
PrimaryExpression()
[
LOOKAHEAD(1)
("++" {jjtThis.setOp(UnaryOp.POST_INCREMENT);}
| "--" {jjtThis.setOp(UnaryOp.POST_DECREMENT);}
) #UnaryExpression(1)
]
}
void SwitchExpression() :
{boolean prevInSwitchBlock = inSwitchExprBlock;}
{
"switch" "(" Expression() ")"
{inSwitchExprBlock = true;}
SwitchBlock()
{inSwitchExprBlock = prevInSwitchBlock;}
}
/**
* A primary expression. This includes call chains, etc.
*
* A PrimaryPrefix corresponds to an unqualified primary expression,
* e.g "new Foo()". Then, if any, suffixes of the form e.g. ".method()",
* ".field" or "::ref" are added, each time enclosing the previous node.
* Iteration stops after the first method reference, or we can't continue.
*
* The resulting subtree looks left-recursive, but the parsing is iterative.
*/
void PrimaryExpression() #void :
{}
{
// the lookahead here stops iteration after the first method reference,
// because nothing can be chained after a method reference.
PrimaryPrefix() ( LOOKAHEAD(SuffixLAhead(), {!(jjtree.peekNode() instanceof ASTMethodReference)}) PrimarySuffix() )* {forceExprContext();}
}
/*
Expressions that may be present at the start of a primary expression.
*/
void PrimaryPrefix() #void :
{JavaccToken savedStart;}
{
Literal()
| "this" #ThisExpression
| "super" #SuperExpression(true)
("." MemberSelector() | MethodReference())
| UnqualifiedAllocationExpr()
| ("void" #VoidType "." "class") #ClassLiteral
| LOOKAHEAD(1) // suppress the warning here.
(PrimitiveType() [ Dims() ] ) #ArrayType(>1)
(
MethodReference()
| "." "class" #ClassLiteral(1)
)
// If annotations start the expression, it's necessarily a method or ctor reference
// This is because types in class literals or in qualified super/this may not be annotated
| LOOKAHEAD("@") AnnotatedRefType() MethodReference()
| LOOKAHEAD(LambdaLahead()) LambdaExpression()
// Parenthesized expr, we need to adjust start/end tokens
| "(" {savedStart = getToken(0);} Expression() ")"
{
AstImplUtil.bumpParenDepth((ASTExpression) jjtree.peekNode());
AbstractJavaNode top = (AbstractJavaNode) jjtree.peekNode();
top.setFirstToken(savedStart);
top.setLastToken(getToken(0));
}
// If it is an ambiguous name, then we may go on
// into the next step, which is less restricted
// than PrimarySuffix
| AmbiguousName() [ LOOKAHEAD(Step2Lahead()) PrimaryStep2() ]
}
// This describes the cases where the PrimaryPrefix may fall
// into PrimaryStep2, after seeing an AmbiguousName. Notice
// that type arguments is still possible, as well as annotations
// ("@") before an annotated array type, or qualified "this".
// If we are in an explicit constructor invocation, then super is disallowed.
private void Step2Lahead() #void:
{}
{
"::" | "(" | "@" | "["
// the type arguments must be followed by what may complete a class type + method ref
// otherwise we choke on eg `i < w >> 1`, because `< w >` matches type arguments
| TypeArguments() ("[" | "." | "@" | "::")
| LOOKAHEAD({!inExplicitConstructorInvoc}) "."
| LOOKAHEAD({inExplicitConstructorInvoc}) "." ("class" | | TypeArguments() | "new" | "this") // not super in this case
}
private void SuffixLAhead() #void:
{}
{
// this is simpler than the step 2 lookahead
"::" | "["
| LOOKAHEAD({!inExplicitConstructorInvoc}) "."
| LOOKAHEAD({inExplicitConstructorInvoc}) "." ( | TypeArguments() | "new") // not super or this in this case
}
// Step right after the *first* ambiguous name if any.
// Then we have more options than a primary suffix,
// we can still expect to have some class type and a
// class literal, or some type arguments and a method reference
void PrimaryStep2() #void:
{}
{
// If we find type parameters, then we can only expect a method reference
// class literals or qualifiers to static member access/call may not be parameterised
{forceTypeContext();} TypeArguments() {injectTop();} ( "." ClassTypeSegment() )* [ Dims() #ArrayType(2) ] MethodReference()
| MethodReference()
| ArgumentList() #MethodCall(2)
| "." (
{forceTypeContext();} "class" #ClassLiteral(1)
// qualified this or super
| {forceTypeContext();} "this" #ThisExpression(1)
| {forceTypeContext();} "super" #SuperExpression(1)
// here we force the super to be followed by something,
// "super" alone is not a valid expression
("." MemberSelector() | MethodReference())
| MemberSelector()
| {forceExprContext();} Template() #TemplateExpression(2)
)
// catches the case where the ambig name is the start of an array type
| LOOKAHEAD("@" | "[" "]") {forceTypeContext();} Dims() #ArrayType(2) (MethodReference() | "." "class" #ClassLiteral(1))
// and here, the array expr in an array access
| {forceExprContext();} "[" Expression() "]" #ArrayAccess(2)
}
/**
* Productions that may be present after a PrimaryPrefix. Basically
* allows for call chains. We loop on this production in PrimaryExpression.
*/
void PrimarySuffix() #void :
{}
{
MethodReference()
| {forceExprContext();} "[" Expression() "]" #ArrayAccess(2)
| "." MemberSelector()
}
/**
* Part of a primary suffix that immediately follows a dot. Also
* part of step 2.
*/
void MemberSelector() #void :
{}
{
/* JLS §6.5.1:
* A name is syntactically classified as an ExpressionName [...] as the
* qualifying expression in a qualified class instance creation expression (§15.9)*
*/
{forceExprContext();} QualifiedAllocationExpr()
// if there are type arguments, this is a method call
| (TypeArguments() {setLastTokenImage(jjtThis);} ArgumentList()) #MethodCall(3)
| LOOKAHEAD(2) ( {setLastTokenImage(jjtThis);} ArgumentList()) #MethodCall(2)
| ( {setLastTokenImage(jjtThis);}) #FieldAccess(1)
}
void MethodReference() #MethodReference(jjtree.nodeArity() + 1): // LHS is injected
{}
{
"::"
[TypeArguments()]
( "new" | ) { jjtThis.setMethodName(getToken(0).getImage()); }
{/* empty, to set the image before jjtClose */}
}
// This factorises the lookahead for a lambda expression
// It's necessary because in all contexts a lambda may appear in,
// the arguments could be interpreted as a variable reference,
// or the start of a parenthesized expression
private void LambdaLahead() #void :
{}
{
LOOKAHEAD({!inSwitchLabel}) LambdaParameterList() "->"
}
// Lambda expressions are not a PrimaryExpression in the JLS, instead they're
// separated from the AssignmentExpression production. Their use is restricted
// to method and constructor call argument, cast operand, the RHS of assignments,
// and the tail of a ternary expression
// https://docs.oracle.com/javase/specs/jls/se9/html/jls-15.html#jls-15.27
//
// To prevent LambdaExpressions in switch labels, the field #inSwitchLabel is used
// as a workaround.
void LambdaExpression():
{ }
{
LambdaParameterList() "->" ( Expression() | Block() )
}
void LambdaParameterList():
{}
{
SimpleLambdaParam()
| LOOKAHEAD("(" ("," | ")"))
"(" [ SimpleLambdaParam() ( "," SimpleLambdaParam())* ] ")"
| "(" [ LambdaParameter() ( "," LambdaParameter() )* ] ")"
}
void SimpleLambdaParam() #LambdaParameter:
{pushEmptyModifierList();}
{
VariableDeclaratorId()
}
void LambdaParameter():
{}
{
LocalVarModifierList() // this weakens the grammar a bit
[
LambdaParameterType()
]
VariableIdWithDims()
}
/** Returns true if this is "var". */
boolean LambdaParameterType() #void :
{}
{
LOOKAHEAD( { jdkVersion >= 11 && isKeyword("var") } )
{ return true; }
| FormalParamType() { return false; }
}
void Template() :
{}
{
StringTemplate()
| TextBlockTemplate()
| #TemplateFragment
| #TemplateFragment
}
void StringTemplate() #void :
{}
{
#TemplateFragment
EmbeddedExpression()
(LOOKAHEAD(2) ( ) #TemplateFragment EmbeddedExpression() )*
( ) #TemplateFragment
}
void TextBlockTemplate() #void :
{}
{
#TemplateFragment
EmbeddedExpression()
(LOOKAHEAD(2) ( ) #TemplateFragment EmbeddedExpression() )*
( ) #TemplateFragment
}
void EmbeddedExpression() #void :
{}
{
[ Expression() ]
}
void Literal() #void :
{}
{
NumericLiteral()
| StringLiteral()
| CharLiteral()
| ("true" { jjtThis.setTrue(); } | "false") #BooleanLiteral
| "null" #NullLiteral
}
void NumericLiteral():
{}
{
( { jjtThis.setIntLiteral(); }
| { jjtThis.setFloatLiteral(); }
)
{ setLastTokenImage(jjtThis); }
}
void CharLiteral():
{}
{
{ setLastTokenImage(jjtThis); }
}
void StringLiteral():
{}
{
(
| { jjtThis.setTextBlock(); }
)
{ setLastTokenImage(jjtThis); }
}
void ArgumentList() :
{}
{
"(" [ Expression() ( "," Expression() )* ] ")"
}
// more straightforward because can't be an array creation expr
void QualifiedAllocationExpr() #ConstructorCall(jjtree.nodeArity() + 1):
{}
{
"new"
[ TypeArguments() ]
AnnotatedClassOrInterfaceType()
ArgumentList()
[ AnonymousClassDeclaration() ]
}
void AnonymousClassDeclaration():
{
pushEmptyModifierList();
}
{
ClassOrInterfaceBody()
}
// this is much weaker than the JLS but since we parse compilable code
// the actual terms we get respect the JLS.
// only used in PrimaryPrefix
void UnqualifiedAllocationExpr() #void :
{
boolean isArrayInit=false;
}
{
(
(
"new" [ TypeArguments() ] TypeAnnotationList()
(
PrimitiveType() ArrayDimsAndInits(){isArrayInit=true;}
|
ClassOrInterfaceType()
(
ArrayDimsAndInits() {isArrayInit=true;}
|
ArgumentList() [ AnonymousClassDeclaration() ]
)
)
{/*Empty unit, important*/}
)
#ArrayAllocation(isArrayInit)
)
#ConstructorCall(!isArrayInit)
}
/*
* The array dimensions are appended to the array type and they're both
* enclosed into an ArrayType node.
*/
void ArrayDimsAndInits() #void:
{}
{
LOOKAHEAD(TypeAnnotationList() "[" "]" ) (((ArrayTypeDim())+) #ArrayDimensions) #ArrayType(2) [ ArrayInitializer() ]
| ( (ArrayDimExpr())+ #ArrayDimensions ) #ArrayType(2)
}
// may push either an ArrayDimExpr or ArrayTypeDim
void ArrayDimExpr() #void:
{boolean hasExpr=false;}
{
((TypeAnnotListNoInject() "[" [ Expression() {hasExpr=true;} ] "]") #ArrayDimExpr(hasExpr) ) #ArrayTypeDim(!hasExpr)
}
/*
* Statement syntax follows.
*/
void Statement() #void:
{}
{
StatementNoIdent()
// testing the hard cases last optimises the code gen
// all the previous cases are trivial for the parser
// because they start with a different token
| LOOKAHEAD( { isYieldStart() } ) YieldStatement()
| LOOKAHEAD( { isAssertStart() } ) AssertStatement()
| LOOKAHEAD(2) LabeledStatement()
| ( StatementExpression() ";" ) #ExpressionStatement
}
void StatementNoIdent() #void:
{}
{
Block()
| EmptyStatement()
| SwitchStatement()
| IfStatement()
| WhileStatement()
| DoStatement()
| ForStatement()
| BreakStatement()
| ContinueStatement()
| ReturnStatement()
| ThrowStatement()
| SynchronizedStatement()
| TryStatement()
}
void LabeledStatement() :
{}
{
{ setLastTokenImage(jjtThis); } ":" Statement()
}
void Block() :
{}
{
"{"
( BlockStatement() )*
"}"
}
void BlockStatement() #void:
{} // Note: this has been written this way to minimize lookaheads
// This generates a table switch with very few lookaheads
{
LOOKAHEAD(1, "@" | "final" )
// this eagerly parses all modifiers and annotations. After that, either a local type declaration
// or a local variable declaration follows.
// This allows more modifiers for local variables than actually allowed
// The ModifierList is adopted by the next node to open
ModifierList() (
LOOKAHEAD({localTypeDeclAfterModifiers()}) LocalTypeDecl()
| LOOKAHEAD({true}) LocalVariableDeclarationPendingModifiers() ";" { fixLastToken(); }
)
| LOOKAHEAD(1, )
(
LOOKAHEAD({ localTypeDeclGivenNextIsIdent() }) ModifierList() LocalTypeDecl()
| LOOKAHEAD({ isAssertStart() }) AssertStatement()
| LOOKAHEAD({ isYieldStart() }) YieldStatement()
| LOOKAHEAD({ getToken(2).kind == COLON }) LabeledStatement()
| LOOKAHEAD(ReferenceType() ) LocalVariableDeclaration() ";" { fixLastToken(); }
| LOOKAHEAD({true}) ExpressionStatement()
)
| LOOKAHEAD(1, LocalTypeStartNoIdent()) ModifierList() LocalTypeDecl()
| LOOKAHEAD(1) StatementNoIdent()
| LOOKAHEAD(Type() ) LocalVariableDeclaration() ";" { fixLastToken(); }
| LOOKAHEAD({true}) ExpressionStatement()
}
private void LocalTypeStartNoIdent() #void: // A lookahead
{}
{ // notice: not default, not synchronized, not final
"public" | "static" | "protected" | "private"
| "abstract" | "native" | "transient"
| "volatile" | "strictfp"
| "class" | "interface"
}
void LocalTypeDecl() #void:
{} // At the point this is called, a ModifierList is on the top of the stack,
{ // waiting for the next node to open. We want that node to be the type declaration,
// not the wrapper statement node.
( ClassOrInterfaceDeclaration()
| LOOKAHEAD({isKeyword("record")}) RecordDeclaration()
| LOOKAHEAD({isKeyword("enum")}) EnumDeclaration()
) {
// Wrap the type decl into a statement
// This can't be done with regular jjtree constructs, as the ModifierList
// is adopted by the first node to be opened.
ASTTypeDeclaration type = (ASTTypeDeclaration) jjtree.popNode();
ASTLocalClassStatement stmt = new ASTLocalClassStatement(type);
jjtree.pushNode(stmt);
}
}
/*
* See https://docs.oracle.com/javase/specs/jls/se10/html/jls-14.html#jls-14.4
*/
void LocalVariableDeclaration() :
{}
{
LocalVarModifierList()
LocalVariableType()
VariableDeclarator()
( "," VariableDeclarator() )*
}
void LocalVariableDeclarationPendingModifiers() #LocalVariableDeclaration:
{}
{
// no ModifierList, it's pending at this time
LocalVariableType()
VariableDeclarator()
( "," VariableDeclarator() )*
}
private void LocalVarModifierList() #ModifierList:
{Set set = Collections.emptySet(); }
{
( "final" { set = ASTModifierList.JUST_FINAL; } | Annotation() )*
{jjtThis.setDeclaredModifiers(set);}
}
void LocalVariableType() #void:
{}
{
LOOKAHEAD( { jdkVersion >= 10 && isKeyword("var") } )
| Type()
}
void EmptyStatement() :
{}
{
";"
}
void EmptyDeclaration() :
{}
{
";"
}
void ExpressionStatement():
{}
{
StatementExpression() ";"
}
void StatementExpression() #void:
{AssignmentOp op = null;}
{
PrefixIncrementExpression()
|
// using PostfixExpression here allows us to skip the part of the production tree
// between Expression() and PostfixExpression()
(PostfixExpression() [ op=AssignmentOperator() {jjtThis.setOp(op);} Expression() ]) #AssignmentExpression(>1)
}
void SwitchStatement():
{}
{
"switch" "(" Expression() ")" SwitchBlock()
}
void SwitchBlock() #void:
{}
{
"{"
(
LOOKAHEAD(SwitchLabel() ":") (SwitchFallthroughBranch())+
| (SwitchArrowBranch())*
)
"}"
}
void SwitchArrowBranch():
{}
{
SwitchLabel() "->" (Expression() ";" | Block() | ThrowStatement())
}
void SwitchFallthroughBranch():
{}
{
SwitchLabel() ":"
// the lookahead is to prevent choosing BlockStatement when the token is "default",
// which could happen as local class declarations accept the "default" modifier.
(LOOKAHEAD({shouldStartStatementInSwitch()}) BlockStatement() )*
}
void SwitchLabel() :
{}
{
{ inSwitchLabel = true; }
(
"case" CaseLabelElement(jjtThis) ( "," CaseLabelElement(jjtThis) )*
|
"default" {jjtThis.setDefault();}
)
{ inSwitchLabel = false; }
}
void CaseLabelElement(ASTSwitchLabel label) #void:
{}
{
"null" #NullLiteral [ "," "default" {label.setDefault();} ]
|
LOOKAHEAD(Pattern()) CasePattern() [ LOOKAHEAD({isKeyword("when")}) Guard() ]
|
CaseConstant()
}
void CaseConstant() #void:
{}
{
ConditionalExpression()
}
void CasePattern() #void:
{}
{
Pattern()
}
void Guard() :
{}
{
softKeyword("when")
Expression()
}
void YieldStatement() :
{ }
{
Expression() ";"
}
void IfStatement() :
/*
* The disambiguating algorithm of JavaCC automatically binds dangling
* else's to the innermost if statement. The LOOKAHEAD specification
* is to tell JavaCC that we know what we are doing.
*/
{}
{
"if" "(" Expression() ")" Statement() [ LOOKAHEAD(1) "else" {jjtThis.setHasElse();} Statement() ]
}
void WhileStatement() :
{}
{
"while" "(" Expression() ")" Statement()
}
void DoStatement() :
{}
{
"do" Statement() "while" "(" Expression() ")" ";"
}
void ForStatement() #void:
{JavaccToken t;}
{
t="for" "("
(
LOOKAHEAD(EnhancedForDeclaration() ":")
(EnhancedForDeclaration() ":" Expression() ")" Statement() { jjtThis.setFirstToken(t); }) #ForeachStatement
| (
[ ForInit() ] ";"
[ Expression() ] ";"
[ ForUpdate() ]
")" Statement()
{ jjtThis.setFirstToken(t); }
) #ForStatement
)
}
void EnhancedForDeclaration() #void:
{}
{
LocalVariableDeclaration()
}
void ForInit() :
{}
{
LOOKAHEAD( LocalVariableDeclaration() )
LocalVariableDeclaration()
|
StatementExpressionList()
}
void StatementExpressionList() :
{}
{
StatementExpression() ( "," StatementExpression() )*
}
void ForUpdate() :
{}
{
StatementExpressionList()
}
void BreakStatement() :
{}
{
"break" [ { setLastTokenImage(jjtThis); } ] ";"
}
void ContinueStatement() :
{}
{
"continue" [ { setLastTokenImage(jjtThis); } ] ";"
}
void ReturnStatement() :
{}
{
"return" [ Expression() ] ";"
}
void ThrowStatement() :
{}
{
"throw" Expression() ";"
}
void SynchronizedStatement() :
{}
{
"synchronized" "(" Expression() ")" Block()
}
void TryStatement() :
/*
* Semantic check required here to make sure that at least one
* resource/finally/catch is present.
*/
{}
{
"try" (ResourceList())?
Block()
( CatchClause() )*
[ FinallyClause() ]
}
void ResourceList():
{}
{
"("
Resource() (LOOKAHEAD(2) ";" Resource())*
(";" {jjtThis.setTrailingSemi();})?
")"
}
void Resource() :
{}
{
LOOKAHEAD(("final" | Annotation())* LocalVariableType() VariableDeclaratorId() "=" )
(
LocalVarModifierList()
LocalVariableType() VariableDeclarator()
) #LocalVariableDeclaration
|
PrimaryExpression()
{
Node top = jjtree.peekNode();
if (!(top instanceof ASTVariableAccess || top instanceof ASTFieldAccess || top instanceof ASTThisExpression))
throwParseException("Expected a variable or field access, but was a " + top.getXPathNodeName());
}
{}
}
void CatchClause() :
{}
{
"catch"
"(" CatchParameter() ")"
Block()
}
void CatchParameter():
{boolean multi=false;}
{
LocalVarModifierList()
( AnnotatedClassOrInterfaceType() ( "|" AnnotatedClassOrInterfaceType() {multi=true;} )* ) #UnionType(multi)
VariableDeclaratorId()
}
void FinallyClause() :
{}
{
"finally" Block()
}
void AssertStatement() :
{}
{
Expression() [ ":" Expression() ] ";"
}
/* We use productions to match >>>, >> and > so that we can keep the
* type declaration syntax with generics clean
*/
void RUNSIGNEDSHIFT() #void:
{}
{
LOOKAHEAD({ JavaTokenDocumentBehavior.getRealKind(getToken(1)) == RUNSIGNEDSHIFT})
">" ">" ">"
}
void RSIGNEDSHIFT() #void:
{}
{
LOOKAHEAD({ JavaTokenDocumentBehavior.getRealKind(getToken(1)) == RSIGNEDSHIFT})
">" ">"
}
/* Annotation syntax follows. */
void Annotation():
{}
{
"@" ClassName() [ AnnotationMemberList() ]
}
void AnnotationMemberList():
{}
{
"("
( LOOKAHEAD( "=")
MemberValuePair() ( "," MemberValuePair() )*
| [ ShorthandAnnotationValue() ]
)
")"
}
void ShorthandAnnotationValue() #MemberValuePair:
{
jjtThis.setImage("value");
jjtThis.setShorthand();
}
{
MemberValue()
}
void MemberValuePair():
{}
{
{ setLastTokenImage(jjtThis); } "=" MemberValue()
}
void MemberValue() #void:
{}
{
Annotation()
| MemberValueArrayInitializer()
| ConditionalExpression() // Constant expression
}
void MemberValueArrayInitializer():
{}
{
"{"
(MemberValue() ( LOOKAHEAD(2) "," MemberValue() )*)? [ "," ]
"}"
}
/*
* We use that ghost production to factorise the check for JDK >= 1.8.
*/
void TypeAnnotation() #void:
{}
{
Annotation()
}
/* Annotation Types. */
void AnnotationTypeDeclaration():
{}
{
"@" "interface" { jjtThis.setSimpleName(getToken(0).getImage()); }
AnnotationTypeBody()
}
void AnnotationTypeBody():
{}
{
"{"
( AnnotationTypeMemberDeclaration() )*
"}"
}
void AnnotationTypeMemberDeclaration() #void:
{}
{
ModifierList()
(
LOOKAHEAD(Type() "(") AnnotationMethodDeclaration()
|
ClassOrInterfaceDeclaration()
|
LOOKAHEAD(3) EnumDeclaration()
|
AnnotationTypeDeclaration()
|
FieldDeclaration()
)
|
";" #EmptyDeclaration
}
void AnnotationMethodDeclaration() #MethodDeclaration:
{}
{
Type()
{ jjtThis.setName(getToken(0).getImage()); }
("(" ")") #FormalParameters
[ Dims() ]
[ DefaultValue() ] ";"
}
void DefaultValue():
{}
{
"default" MemberValue()
}
void ModuleDeclaration():
{}
{
AnnotationList()
[LOOKAHEAD({isKeyword("open")}) {jjtThis.setOpen(true);}]
LOOKAHEAD({isKeyword("module")})
ModuleName()
"{"
(ModuleDirective())*
"}"
}
void ModuleDirective() #void:
{String packageName;}
{
( LOOKAHEAD({isKeyword("requires")})
[
LOOKAHEAD({isKeyword("transitive")}) { jjtThis.setTransitive(); }
| "static" { jjtThis.setStatic(); }
]
ModuleName() ";" ) #ModuleRequiresDirective
| ( LOOKAHEAD({isKeyword("exports")}) packageName=VoidNameNoLookahead() {jjtThis.setPackageName(packageName);} [ LOOKAHEAD({isKeyword("to")}) ModuleName() ("," ModuleName())* ] ";" ) #ModuleExportsDirective
| ( LOOKAHEAD({isKeyword("opens")}) packageName=VoidNameNoLookahead() {jjtThis.setPackageName(packageName);} [ LOOKAHEAD({isKeyword("to")}) ModuleName() ("," ModuleName())* ] ";" ) #ModuleOpensDirective
| ( LOOKAHEAD({isKeyword("uses")}) ClassName() ";" ) #ModuleUsesDirective
| ( LOOKAHEAD({isKeyword("provides")}) ClassName() LOOKAHEAD({isKeyword("with")}) ClassName() ("," ClassName() )* ";" ) #ModuleProvidesDirective
}
void ModuleName():
{ String name; }
{
name=VoidNameNoLookahead() { jjtThis.setName(name); }
}
void AmbiguousName():
{ String name; }
{
name=VoidName() { jjtThis.setImage(name); }
}
String VoidName() #void:
/*
* A lookahead of 2 is required below since "Name" can be followed
* by a ".*" when used in the context of an "ImportDeclaration",
* or with "this" or "super" in PrimaryPrefix (AmbiguousName).
*/
{
StringBuilder s = new StringBuilder();
JavaccToken t;
}
{
t= { s.append(t.getImage()); }
( LOOKAHEAD(2) "." t= { s.append('.').append(t.getImage()); }
)*
{return s.toString();}
}
String VoidNameNoLookahead() #void:
{
StringBuilder s = new StringBuilder();
JavaccToken t;
}
{
t= { s.append(t.getImage()); }
( "." t= { s.append('.').append(t.getImage()); } )*
{return s.toString();}
}
// Produces a ClassOrInterfaceType, possibly with an ambiguous LHS
void ClassName() #void:
{}
{
AmbiguousName() { forceTypeContext(); }
}
// This is used to get JJTree to generate a node.
// Variable references are always ambiguous
// when they're parsed, so they're not created
// normally by jjtree, but rather by the disambiguation
// hooks spread across the parser
//noinspection UnusedProduction
void VariableAccess(): {} { }
// those are created manually
void TypeExpression(): {} { }
void PatternExpression(): {} { }
void LocalClassStatement(): {} { TypeDeclaration() }
void softKeyword(String name) #void: {} {
{
if (!getToken(0).getImageCs().contentEquals(name))
throwParseException("Expecting keyword '" + name + "'");
}
}