Class Parser
- java.lang.Object
-
- org.codehaus.janino.Parser
-
public class Parser extends java.lang.Object
A parser for the Java programming language.'JLS7' refers to the Java Language Specification, Java SE 7 Edition.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Parser.ClassDeclarationContext
The kinds of context where a class declaration can occur.static class
Parser.InterfaceDeclarationContext
The kinds of context where an interface declaration can occur.static class
Parser.MethodDeclarationContext
The kinds of context where a method declaration can occur.
-
Field Summary
Fields Modifier and Type Field Description private static java.lang.String[]
ACCESS_MODIFIER_KEYWORDS
private java.lang.String
docComment
The optional JAVADOC comment preceding the#nextToken
.private static java.util.List<java.util.Set<java.lang.String>>
MUTUALLY_EXCLUSIVE_ACCESS_MODIFIERS
private boolean
preferParametrizedTypes
private Scanner
scanner
private int
sourceVersion
private TokenStream
tokenStream
private WarningHandler
warningHandler
-
Constructor Summary
Constructors Constructor Description Parser(Scanner scanner)
Parser(Scanner scanner, TokenStream tokenStream)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description private Java.Modifier[]
annotationTypeElementModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
checkModifiers(Java.Modifier[] modifiers, java.lang.String... allowedKeywords)
Verifies that the modifiers are consistent.private Java.Modifier[]
classModifiers(Java.Modifier[] modifiers)
protected CompileException
compileException(java.lang.String message)
Convenience method for throwing aCompileException
.protected static CompileException
compileException(java.lang.String message, Location location)
Convenience method for throwing aCompileException
.private Java.Modifier[]
constantModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
constructorModifiers(Java.Modifier[] modifiers)
java.lang.String
doc()
Gets the text of the doc comment (a.k.a.private Java.Modifier[]
enumConstantModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
fieldModifiers(Java.Modifier[] modifiers)
Scanner
getScanner()
private int
getSourceVersion()
private static boolean
hasAccessModifier(Java.Modifier[] modifiers, java.lang.String... keywords)
private static boolean
hasAccessModifierOtherThan(Java.Modifier[] modifiers, java.lang.String... keywords)
private Java.Modifier[]
interfaceMethodModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
interfaceModifiers(Java.Modifier[] modifiers)
private static java.lang.String
join(java.lang.String[] sa, java.lang.String separator)
Location
location()
private Java.Modifier[]
methodModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
packageMemberClassModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
packageMemberInterfaceModifiers(Java.Modifier[] modifiers)
private Java.Modifier[]
packageModifiers(Java.Modifier[] modifiers)
Java.AbstractCompilationUnit
parseAbstractCompilationUnit()
CompilationUnit := [ PackageDeclaration ] { ImportDeclaration } { TypeDeclaration }Java.Atom
parseAdditiveExpression()
AdditiveExpression := MultiplicativeExpression { ( '+' | '-' ) MultiplicativeExpression }Java.Atom
parseAndExpression()
AndExpression := EqualityExpression { '&' EqualityExpression }private Java.Annotation
parseAnnotation()
Annotation := MarkerAnnotation // JLS7 9.7.2 | SingleElementAnnotation // JLS7 9.7.3 | NormalAnnotation // JLS7 9.7.1 MarkerAnnotation := '@' Identifier SingleElementAnnotation := '@' Identifier '(' ElementValue ')' NormalAnnotation := '@' TypeName '(' ElementValuePairsOpt ')' ElementValuePairsOpt := [ ElementValuePair { ',' ElementValuePair } ]Java.AnnotationTypeDeclaration
parseAnnotationTypeDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers, Parser.InterfaceDeclarationContext context)
AnnotationTypeDeclarationRest := Identifier AnnotationTypeBodyJava.Rvalue[]
parseArgumentList()
ArgumentList := Expression { ',' Expression }Java.Rvalue[]
parseArguments()
Arguments := '(' [ ArgumentList ] ')'Java.ArrayInitializer
parseArrayInitializer()
ArrayInitializer := '{' [ VariableInitializer { ',' VariableInitializer } [ ',' ] '}'Java.Statement
parseAssertStatement()
AssertStatement := 'assert' Expression [ ':' Expression ] ';'Java.Atom
parseAssignmentExpression()
AssignmentExpression := ConditionalExpression [ AssignmentOperator AssignmentExpression ] AssignmentOperator := '=' | '*=' | '/=' | '%=' | '+=' | '-=' | '<<=' | '>>=' | '>>>=' | '&=' | '^=' | '|='Java.Block
parseBlock()
Block := '{' BlockStatements '}'Java.BlockStatement
parseBlockStatement()
BlockStatement := Statement | (1) 'class' ...java.util.List<Java.BlockStatement>
parseBlockStatements()
BlockStatements := { BlockStatement }(package private) int
parseBracketsOpt()
BracketsOpt := { '[' ']' }Java.Statement
parseBreakStatement()
BreakStatement := 'break' [ Identifier ] ';'Java.CatchParameter
parseCatchParameter()
CatchFormalParameter := { VariableModifier } CatchType VariableDeclaratorId CatchType := UnannClassType { '|' ClassType } VariableModifier := Annotation | 'final' VariableDeclaratorId := Identifier [ Dims ] Dims := { Annotation } '[' ']' { { Annotation } '[' ']' } UnannClassType := Identifier [ TypeArguments ] | UnannClassOrInterfaceType '.' { Annotation } Identifier [ TypeArguments ] UnannInterfaceType := UnannClassType UnannClassOrInterfaceType := UnannClassType | UnannInterfaceType ClassType := { Annotation } Identifier [ TypeArguments ] | ClassOrInterfaceType '.' { Annotation } Identifier [ TypeArguments ]void
parseClassBody(Java.AbstractClassDeclaration classDeclaration)
ClassBody := '{' { ClassBodyDeclaration } '}'void
parseClassBodyDeclaration(Java.AbstractClassDeclaration classDeclaration)
ClassBodyDeclaration := ';' | ModifiersOpt ( Block | // Instance (JLS7 8.6) or static initializer (JLS7 8.7) 'void' Identifier MethodDeclarationRest | 'class' ClassDeclarationRest | 'interface' InterfaceDeclarationRest | ConstructorDeclarator | [ TypeArguments ] Type Identifier MethodDeclarationRest | Type Identifier FieldDeclarationRest ';' )Java.NamedClassDeclaration
parseClassDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers, Parser.ClassDeclarationContext context)
ClassDeclarationRest := Identifier [ typeParameters ] [ 'extends' ReferenceType ] [ 'implements' ReferenceTypeList ] ClassBodyJava.Atom
parseConditionalAndExpression()
ConditionalAndExpression := InclusiveOrExpression { '&&' InclusiveOrExpression }Java.Atom
parseConditionalExpression()
ConditionalExpression := ConditionalOrExpression [ '?' Expression ':' ConditionalExpression ]Java.Atom
parseConditionalOrExpression()
ConditionalOrExpression := ConditionalAndExpression { '||' ConditionalAndExpression ]Java.ConstructorDeclarator
parseConstructorDeclarator(java.lang.String docComment, Java.Modifier[] modifiers)
ConstructorDeclarator := Identifier FormalParameters [ 'throws' ReferenceTypeList ] '{' [ 'this' Arguments ';' | 'super' Arguments ';' | Primary '.' 'super' Arguments ';' ] BlockStatements '}'Java.Statement
parseContinueStatement()
ContinueStatement := 'continue' [ Identifier ] ';'Java.Rvalue
parseDimExpr()
DimExpr := '[' Expression ']'Java.Rvalue[]
parseDimExprs()
DimExprs := DimExpr { DimExpr }Java.Statement
parseDoStatement()
DoStatement := 'do' Statement 'while' '(' Expression ')' ';'private Java.ElementValue
parseElementValue()
ElementValue := ConditionalExpression | Annotation | ElementValueArrayInitializerprivate Java.ElementValue
parseElementValueArrayInitializer()
ElementValueArrayInitializer := '{' { ElementValue | ',' } '}'private Java.ElementValuePair
parseElementValuePair()
ElementValuePair := Identifier '=' ElementValueJava.Statement
parseEmptyStatement()
EmptyStatement := ';'void
parseEnumBody(Java.EnumDeclaration enumDeclaration)
EnumBody := '{' [ EnumConstant { ',' EnumConstant } [ ',' ] [ ';' ] { ClassBodyDeclaration } '}'Java.EnumConstant
parseEnumConstant()
EnumConstant := [ Annotations ] Identifier [ Arguments ] [ ClassBody ]Java.EnumDeclaration
parseEnumDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers, Parser.ClassDeclarationContext context)
EnumDeclarationRest := Identifier [ 'implements' ReferenceTypeList ] EnumBodyJava.Atom
parseEqualityExpression()
EqualityExpression := RelationalExpression { ( '==' | '!=' ) RelationalExpression }Java.Atom
parseExclusiveOrExpression()
ExclusiveOrExpression := AndExpression { '^' AndExpression }Java.Rvalue
parseExpression()
Expression := AssignmentExpression | LambdaExpressionJava.Rvalue[]
parseExpressionList()
ExpressionList := Expression { ',' Expression }Java.Atom
parseExpressionOrType()
Java.Statement
parseExpressionStatement()
ExpressionStatement := Expression ';'Java.VariableDeclarator[]
parseFieldDeclarationRest(java.lang.String name)
FieldDeclarationRest := VariableDeclaratorRest { ',' VariableDeclarator }Java.FunctionDeclarator.FormalParameter
parseFormalParameter(boolean[] hasEllipsis)
FormalParameter := [ 'final' ] Type FormalParameterRestJava.FunctionDeclarator.FormalParameters
parseFormalParameterList()
FormalParameterList := FormalParameter { ',' FormalParameter }Java.FunctionDeclarator.FormalParameters
parseFormalParameterListRest(Java.Type firstParameterType)
FormalParameterListRest := Identifier { ',' FormalParameter }Java.FunctionDeclarator.FormalParameter
parseFormalParameterRest(Java.Modifier[] modifiers, Java.Type type, boolean[] hasEllipsis)
FormalParameterRest := [ '.' '.' '.' ] Identifier BracketsOptJava.FunctionDeclarator.FormalParameters
parseFormalParameters()
FormalParameters := '(' [ FormalParameterList ] ')'Java.Statement
parseForStatement()
ForStatement := 'for' '(' [ ForInit ] ';' [ Expression ] ';' [ ExpressionList ] ')' Statement | 'for' '(' FormalParameter ':' Expression ')' Statement ForInit := Modifiers Type VariableDeclarators | ModifiersOpt PrimitiveType VariableDeclarators | Expression VariableDeclarators (1) | Expression { ',' Expression }Java.Statement
parseIfStatement()
IfStatement := 'if' '(' Expression ')' Statement [ 'else' Statement ]Java.AbstractCompilationUnit.ImportDeclaration
parseImportDeclaration()
ImportDeclaration := 'import' ImportDeclarationBody ';'Java.AbstractCompilationUnit.ImportDeclaration
parseImportDeclarationBody()
ImportDeclarationBody := [ 'static' ] Identifier { '.' Identifier } [ '.' '*' ]Java.Atom
parseInclusiveOrExpression()
InclusiveOrExpression := ExclusiveOrExpression { '|' ExclusiveOrExpression }void
parseInterfaceBody(Java.InterfaceDeclaration interfaceDeclaration)
InterfaceBody := '{' { ';' | ModifiersOpt ( 'void' Identifier MethodDeclarationRest | 'class' ClassDeclarationRest | 'interface' InterfaceDeclarationRest | Type Identifier ( MethodDeclarationRest | FieldDeclarationRest ) ) } '}'Java.InterfaceDeclaration
parseInterfaceDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers, Parser.InterfaceDeclarationContext context)
InterfaceDeclarationRest := Identifier [ typeParameters ] [ 'extends' ReferenceTypeList ] InterfaceBodyJava.Statement
parseLabeledStatement()
LabeledStatement := Identifier ':' Statementprivate Java.LambdaBody
parseLambdaBody()
LambdaBody :=private Java.LambdaExpression
parseLambdaExpression()
LambdaExpression := LambdaParameters '->' LambdaBodyprivate Java.LambdaParameters
parseLambdaParameters()
LambdaParameters := Identifier | '(' [ FormalParameterList ] ')' | '(' InferredFormalParameterList ')'Java.Rvalue
parseLiteral()
Literal := IntegerLiteral | FloatingPointLiteral | BooleanLiteral | CharacterLiteral | StringLiteral | NullLiteralJava.Block
parseMethodBody()
MethodBody := BlockJava.MethodDeclarator
parseMethodDeclaration()
Equivalent withparseMethodDeclaration(false, MethodDeclarationContext.CLASS_DECLARATION)
.Java.MethodDeclarator
parseMethodDeclaration(boolean allowDefaultClause, Parser.MethodDeclarationContext context)
MethodDeclaration := [ DocComment ] Modifiers [ TypeParameters ] VoidOrType Identifier MethodDeclarationRestJava.MethodDeclarator
parseMethodDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers, Java.TypeParameter[] typeParameters, Java.Type type, java.lang.String name, boolean allowDefaultClause, Parser.MethodDeclarationContext context)
MethodDeclarationRest := FormalParameters { '[' ']' } [ 'throws' ReferenceTypeList ] [ 'default' expression ] ( ';' | MethodBody )Java.Modifier[]
parseModifiers()
Modifiers := { Modifier }Java.ModuleDeclaration
parseModuleDeclarationRest(Java.Modifier[] modifiers)
ModuleDeclarationRest := [ 'open' ] 'module' identifier { '.' identifier} '{' { ModuleDirective } '}'Java.Atom
parseMultiplicativeExpression()
MultiplicativeExpression := UnaryExpression { ( '*' | '/' | '%' ) UnaryExpression }Java.Modifier
parseOptionalModifier()
Modifier := Annotation | 'public' | 'protected' | 'private' | 'static' | 'abstract' | 'final' | 'native' | 'synchronized' | 'transient' | 'volatile' | 'strictfp' | 'default'Java.PackageDeclaration
parsePackageDeclaration()
PackageDeclaration := 'package' QualifiedIdentifier ';'Java.PackageDeclaration
parsePackageDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers)
PackageDeclaration := { PackageModifier } 'package' identifier { '.' identifier} ';'Java.PackageMemberTypeDeclaration
parsePackageMemberTypeDeclaration()
PackageMemberTypeDeclaration := ModifiersOpt PackageMemberTypeDeclarationRestprivate Java.PackageMemberTypeDeclaration
parsePackageMemberTypeDeclarationRest(java.lang.String docComment, Java.Modifier[] modifiers)
PackageMemberTypeDeclarationRest := 'class' ClassDeclarationRest | 'enum' EnumDeclarationRest | 'interface' InterfaceDeclarationRest '@' 'interface' AnnotationTypeDeclarationRestJava.Atom
parsePrimary()
Primary := CastExpression | // CastExpression 15.16 '(' Expression ')' | // ParenthesizedExpression 15.8.5 Literal | // Literal 15.8.1 Name | // AmbiguousName Name Arguments | // MethodInvocation Name '[]' { '[]' } | // ArrayType 10.1 Name '[]' { '[]' } '.' 'class' | // ClassLiteral 15.8.2 'this' | // This 15.8.3 'this' Arguments | // Alternate constructor invocation 8.8.5.1 'super' Arguments | // Unqualified superclass constructor invocation 8.8.5.1 'super' '.' Identifier | // SuperclassFieldAccess 15.11.2 'super' '.' Identifier Arguments | // SuperclassMethodInvocation 15.12.4.9 NewClassInstance | NewAnonymousClassInstance | // ClassInstanceCreationExpression 15.9 NewArray | // ArrayCreationExpression 15.10 NewInitializedArray | // ArrayInitializer 10.6 PrimitiveType { '[]' } | // Type PrimitiveType { '[]' } '.' 'class' | // ClassLiteral 15.8.2 'void' '.' 'class' | // ClassLiteral 15.8.2 MethodReference // MethodReference JLS9 15.13 Name := Identifier { '.' Identifier } CastExpression := '(' PrimitiveType { '[]' } ')' UnaryExpression | '(' Expression ')' UnaryExpression NewClassInstance := 'new' ReferenceType Arguments NewAnonymousClassInstance := 'new' ReferenceType Arguments [ ClassBody ] NewArray := 'new' Type DimExprs { '[]' } NewInitializedArray := 'new' ArrayType ArrayInitializerjava.lang.String[]
parseQualifiedIdentifier()
QualifiedIdentifier := Identifier { '.' Identifier }Java.ReferenceType
parseReferenceType()
ReferenceType := { Annotation } QualifiedIdentifier [ TypeArguments ]Java.ReferenceType[]
parseReferenceTypeList()
ReferenceTypeList := ReferenceType { ',' ReferenceType }Java.Atom
parseRelationalExpression()
RelationalExpression := ShiftExpression { 'instanceof' ReferenceType | '<' ShiftExpression [ { ',' TypeArgument } '>' ] | '<' TypeArgument [ { ',' TypeArgument } '>' ] | ( '>' | '<=' | '>=' ) ShiftExpression }private Java.TryStatement.Resource
parseResource()
Resource := Modifiers Type VariableDeclarator | VariableAccessJava.Statement
parseReturnStatement()
ReturnStatement := 'return' [ Expression ] ';'Java.Atom
parseSelector(Java.Atom atom)
Selector := '.' Identifier | // FieldAccess 15.11.1 '.' Identifier Arguments | // MethodInvocation '.' '<' TypeList '>' 'super' Arguments // Superconstructor invocation (?) '.' '<' TypeList '>' 'super' '.' .Java.Atom
parseShiftExpression()
ShiftExpression := AdditiveExpression { ( '<<' | '>>' | '>>>' ) AdditiveExpression }Java.Statement
parseStatement()
Statement := LabeledStatement | Block | IfStatement | ForStatement | WhileStatement | DoStatement | TryStatement | 'switch' ...Java.Statement
parseSwitchStatement()
SwitchStatement := 'switch' '(' Expression ')' '{' { SwitchLabels BlockStatements } '}' SwitchLabels := SwitchLabels { SwitchLabels } SwitchLabel := 'case' Expression ':' | 'default' ':'Java.Statement
parseSynchronizedStatement()
SynchronizedStatement := 'synchronized' '(' expression ')' BlockJava.Statement
parseThrowStatement()
ThrowStatement := 'throw' Expression ';'Java.Statement
parseTryStatement()
TryStatement := 'try' Block Catches [ Finally ] | 'try' Block Finally Catches := CatchClause { CatchClause } CatchClause := 'catch' '(' FormalParameter ')' Block Finally := 'finally' BlockJava.Type
parseType()
Type := ( 'byte' | 'short' | 'char' | 'int' | 'long' | 'float' | 'double' | 'boolean' | ReferenceType ) { '[' ']' }private Java.TypeArgument
parseTypeArgument()
TypeArgument := ReferenceType { '[' ']' } <= The optional brackets are missing in JLS7, section 18!? | PrimitiveType '[' ']' { '[' ']' } | '?' extends ReferenceType | '?' super ReferenceTypeprivate Java.TypeArgument[]
parseTypeArgumentsOpt()
TypeArguments := '<' [ TypeArgument { ',' TypeArgument } ] '>'private Java.TypeParameter
parseTypeParameter()
TypeParameter := identifier [ 'extends' ( identifier | ReferenceType { '&' ReferenceType }private Java.TypeParameter[]
parseTypeParametersOpt()
TypeParameters := '<' TypeParameter { ',' TypeParameter } '>'Java.Atom
parseUnaryExpression()
UnaryExpression := { PrefixOperator } Primary { Selector } { PostfixOperator } PrefixOperator := '++' | '--' | '+' | '-' | '~' | '!' PostfixOperator := '++' | '--'Java.VariableDeclarator
parseVariableDeclarator()
VariableDeclarator := Identifier VariableDeclaratorRestJava.VariableDeclarator
parseVariableDeclaratorRest(java.lang.String name)
VariableDeclaratorRest := { '[' ']' } [ '=' VariableInitializer ]Java.VariableDeclarator[]
parseVariableDeclarators()
VariableDeclarators := VariableDeclarator { ',' VariableDeclarator }Java.ArrayInitializerOrRvalue
parseVariableInitializer()
VariableInitializer := ArrayInitializer | ExpressionJava.Type
parseVoidOrType()
VoidOrType := 'void' | TypeJava.Statement
parseWhileStatement()
WhileStatement := 'while' '(' Expression ')' StatementToken
peek()
boolean
peek(java.lang.String suspected)
int
peek(java.lang.String... suspected)
boolean
peek(TokenType suspected)
int
peek(TokenType... suspected)
private boolean
peekLiteral()
Token
peekNextButOne()
boolean
peekNextButOne(java.lang.String suspected)
boolean
peekNextButOne(TokenType suspected)
boolean
peekRead(java.lang.String suspected)
int
peekRead(java.lang.String... suspected)
java.lang.String
peekRead(TokenType suspected)
Token
read()
void
read(java.lang.String expected)
int
read(java.lang.String... expected)
java.lang.String
read(TokenType expected)
void
setSourceVersion(int version)
void
setWarningHandler(WarningHandler warningHandler)
By default, warnings are discarded, but an application my install aWarningHandler
.private Java.Modifier[]
variableModifiers(Java.Modifier[] modifiers)
private void
verifyIdentifierIsConventionalClassOrInterfaceName(java.lang.String id, Location loc)
Issues a warning if the given identifier does not comply with the class and interface type naming conventions (JLS7 6.8.2).private void
verifyIdentifierIsConventionalFieldName(java.lang.String id, Location loc)
Issues a warning if the given identifier does not comply with the field naming conventions (JLS7 6.8.4) and constant naming conventions (JLS7 6.8.5).private void
verifyIdentifierIsConventionalLocalVariableOrParameterName(java.lang.String id, Location loc)
Issues a warning if the given identifier does not comply with the local variable and parameter naming conventions (JLS7 6.8.6).private void
verifyIdentifierIsConventionalMethodName(java.lang.String id, Location loc)
Issues a warning if the given identifier does not comply with the method naming conventions (JLS7 6.8.3).private void
verifyStringIsConventionalPackageName(java.lang.String s, Location loc)
Issues a warning if the given string does not comply with the package naming conventions.private void
warning(java.lang.String handle, java.lang.String message)
private void
warning(java.lang.String handle, java.lang.String message, Location location)
Issues a warning with the given message and location and returns.
-
-
-
Field Detail
-
scanner
private final Scanner scanner
-
tokenStream
private final TokenStream tokenStream
-
docComment
@Nullable private java.lang.String docComment
The optional JAVADOC comment preceding the#nextToken
.
-
ACCESS_MODIFIER_KEYWORDS
private static final java.lang.String[] ACCESS_MODIFIER_KEYWORDS
-
preferParametrizedTypes
private boolean preferParametrizedTypes
-
sourceVersion
private int sourceVersion
-
warningHandler
@Nullable private WarningHandler warningHandler
-
MUTUALLY_EXCLUSIVE_ACCESS_MODIFIERS
private static final java.util.List<java.util.Set<java.lang.String>> MUTUALLY_EXCLUSIVE_ACCESS_MODIFIERS
-
-
Constructor Detail
-
Parser
public Parser(Scanner scanner)
-
Parser
public Parser(Scanner scanner, TokenStream tokenStream)
-
-
Method Detail
-
doc
@Nullable public java.lang.String doc()
Gets the text of the doc comment (a.k.a. "JAVADOC comment") preceding the next token.- Returns:
null
if the next token is not preceded by a doc comment
-
getScanner
public Scanner getScanner()
- Returns:
- The scanner that produces the tokens for this parser.
-
parseAbstractCompilationUnit
public Java.AbstractCompilationUnit parseAbstractCompilationUnit() throws CompileException, java.io.IOException
CompilationUnit := [ PackageDeclaration ] { ImportDeclaration } { TypeDeclaration }
- Throws:
CompileException
java.io.IOException
-
parseModuleDeclarationRest
public Java.ModuleDeclaration parseModuleDeclarationRest(Java.Modifier[] modifiers) throws CompileException, java.io.IOException
ModuleDeclarationRest := [ 'open' ] 'module' identifier { '.' identifier} '{' { ModuleDirective } '}'
- Throws:
CompileException
java.io.IOException
-
parsePackageDeclaration
public Java.PackageDeclaration parsePackageDeclaration() throws CompileException, java.io.IOException
PackageDeclaration := 'package' QualifiedIdentifier ';'
- Throws:
CompileException
java.io.IOException
-
parsePackageDeclarationRest
public Java.PackageDeclaration parsePackageDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers) throws CompileException, java.io.IOException
PackageDeclaration := { PackageModifier } 'package' identifier { '.' identifier} ';'
- Throws:
CompileException
java.io.IOException
-
parseImportDeclaration
public Java.AbstractCompilationUnit.ImportDeclaration parseImportDeclaration() throws CompileException, java.io.IOException
ImportDeclaration := 'import' ImportDeclarationBody ';'
- Throws:
CompileException
java.io.IOException
-
parseImportDeclarationBody
public Java.AbstractCompilationUnit.ImportDeclaration parseImportDeclarationBody() throws CompileException, java.io.IOException
ImportDeclarationBody := [ 'static' ] Identifier { '.' Identifier } [ '.' '*' ]
- Throws:
CompileException
java.io.IOException
-
parseQualifiedIdentifier
public java.lang.String[] parseQualifiedIdentifier() throws CompileException, java.io.IOException
QualifiedIdentifier := Identifier { '.' Identifier }
- Throws:
CompileException
java.io.IOException
-
parsePackageMemberTypeDeclaration
public Java.PackageMemberTypeDeclaration parsePackageMemberTypeDeclaration() throws CompileException, java.io.IOException
PackageMemberTypeDeclaration := ModifiersOpt PackageMemberTypeDeclarationRest
- Throws:
CompileException
java.io.IOException
-
parsePackageMemberTypeDeclarationRest
private Java.PackageMemberTypeDeclaration parsePackageMemberTypeDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers) throws CompileException, java.io.IOException
PackageMemberTypeDeclarationRest := 'class' ClassDeclarationRest | 'enum' EnumDeclarationRest | 'interface' InterfaceDeclarationRest '@' 'interface' AnnotationTypeDeclarationRest
- Throws:
CompileException
java.io.IOException
-
parseModifiers
public Java.Modifier[] parseModifiers() throws CompileException, java.io.IOException
Modifiers := { Modifier }
Includes the case "no modifiers".
- Throws:
CompileException
java.io.IOException
-
parseOptionalModifier
@Nullable public Java.Modifier parseOptionalModifier() throws CompileException, java.io.IOException
Modifier := Annotation | 'public' | 'protected' | 'private' | 'static' | 'abstract' | 'final' | 'native' | 'synchronized' | 'transient' | 'volatile' | 'strictfp' | 'default'
- Throws:
CompileException
java.io.IOException
-
parseAnnotation
private Java.Annotation parseAnnotation() throws CompileException, java.io.IOException
Annotation := MarkerAnnotation // JLS7 9.7.2 | SingleElementAnnotation // JLS7 9.7.3 | NormalAnnotation // JLS7 9.7.1 MarkerAnnotation := '@' Identifier SingleElementAnnotation := '@' Identifier '(' ElementValue ')' NormalAnnotation := '@' TypeName '(' ElementValuePairsOpt ')' ElementValuePairsOpt := [ ElementValuePair { ',' ElementValuePair } ]
- Throws:
CompileException
java.io.IOException
-
parseElementValuePair
private Java.ElementValuePair parseElementValuePair() throws CompileException, java.io.IOException
ElementValuePair := Identifier '=' ElementValue
- Throws:
CompileException
java.io.IOException
-
parseElementValue
private Java.ElementValue parseElementValue() throws CompileException, java.io.IOException
ElementValue := ConditionalExpression | Annotation | ElementValueArrayInitializer
- Throws:
CompileException
java.io.IOException
-
parseElementValueArrayInitializer
private Java.ElementValue parseElementValueArrayInitializer() throws CompileException, java.io.IOException
ElementValueArrayInitializer := '{' { ElementValue | ',' } '}'
- Throws:
CompileException
java.io.IOException
-
parseClassDeclarationRest
public Java.NamedClassDeclaration parseClassDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers, Parser.ClassDeclarationContext context) throws CompileException, java.io.IOException
ClassDeclarationRest := Identifier [ typeParameters ] [ 'extends' ReferenceType ] [ 'implements' ReferenceTypeList ] ClassBody
- Throws:
CompileException
java.io.IOException
-
parseEnumDeclarationRest
public Java.EnumDeclaration parseEnumDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers, Parser.ClassDeclarationContext context) throws CompileException, java.io.IOException
EnumDeclarationRest := Identifier [ 'implements' ReferenceTypeList ] EnumBody
- Throws:
CompileException
java.io.IOException
-
parseClassBody
public void parseClassBody(Java.AbstractClassDeclaration classDeclaration) throws CompileException, java.io.IOException
ClassBody := '{' { ClassBodyDeclaration } '}'
- Throws:
CompileException
java.io.IOException
-
parseEnumBody
public void parseEnumBody(Java.EnumDeclaration enumDeclaration) throws CompileException, java.io.IOException
EnumBody := '{' [ EnumConstant { ',' EnumConstant } [ ',' ] [ ';' ] { ClassBodyDeclaration } '}'
- Throws:
CompileException
java.io.IOException
-
parseEnumConstant
public Java.EnumConstant parseEnumConstant() throws CompileException, java.io.IOException
EnumConstant := [ Annotations ] Identifier [ Arguments ] [ ClassBody ]
- Throws:
CompileException
java.io.IOException
-
parseClassBodyDeclaration
public void parseClassBodyDeclaration(Java.AbstractClassDeclaration classDeclaration) throws CompileException, java.io.IOException
ClassBodyDeclaration := ';' | ModifiersOpt ( Block | // Instance (JLS7 8.6) or static initializer (JLS7 8.7) 'void' Identifier MethodDeclarationRest | 'class' ClassDeclarationRest | 'interface' InterfaceDeclarationRest | ConstructorDeclarator | [ TypeArguments ] Type Identifier MethodDeclarationRest | Type Identifier FieldDeclarationRest ';' )
- Throws:
CompileException
java.io.IOException
-
parseInterfaceDeclarationRest
public Java.InterfaceDeclaration parseInterfaceDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers, Parser.InterfaceDeclarationContext context) throws CompileException, java.io.IOException
InterfaceDeclarationRest := Identifier [ typeParameters ] [ 'extends' ReferenceTypeList ] InterfaceBody
- Throws:
CompileException
java.io.IOException
-
parseAnnotationTypeDeclarationRest
public Java.AnnotationTypeDeclaration parseAnnotationTypeDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers, Parser.InterfaceDeclarationContext context) throws CompileException, java.io.IOException
AnnotationTypeDeclarationRest := Identifier AnnotationTypeBody
- Throws:
CompileException
java.io.IOException
-
parseInterfaceBody
public void parseInterfaceBody(Java.InterfaceDeclaration interfaceDeclaration) throws CompileException, java.io.IOException
InterfaceBody := '{' { ';' | ModifiersOpt ( 'void' Identifier MethodDeclarationRest | 'class' ClassDeclarationRest | 'interface' InterfaceDeclarationRest | Type Identifier ( MethodDeclarationRest | FieldDeclarationRest ) ) } '}'
- Throws:
CompileException
java.io.IOException
-
parseConstructorDeclarator
public Java.ConstructorDeclarator parseConstructorDeclarator(@Nullable java.lang.String docComment, Java.Modifier[] modifiers) throws CompileException, java.io.IOException
ConstructorDeclarator := Identifier FormalParameters [ 'throws' ReferenceTypeList ] '{' [ 'this' Arguments ';' | 'super' Arguments ';' | Primary '.' 'super' Arguments ';' ] BlockStatements '}'
- Throws:
CompileException
java.io.IOException
-
parseMethodDeclaration
public Java.MethodDeclarator parseMethodDeclaration() throws CompileException, java.io.IOException
Equivalent withparseMethodDeclaration(false, MethodDeclarationContext.CLASS_DECLARATION)
.- Throws:
CompileException
java.io.IOException
- See Also:
parseMethodDeclaration(boolean, MethodDeclarationContext)
-
parseMethodDeclaration
public Java.MethodDeclarator parseMethodDeclaration(boolean allowDefaultClause, Parser.MethodDeclarationContext context) throws CompileException, java.io.IOException
MethodDeclaration := [ DocComment ] Modifiers [ TypeParameters ] VoidOrType Identifier MethodDeclarationRest
- Parameters:
allowDefaultClause
- Whether a "default clause" for an "annotation type element" (JLS8 9.6.2) should be parsed- Throws:
CompileException
java.io.IOException
-
parseVoidOrType
public Java.Type parseVoidOrType() throws CompileException, java.io.IOException
VoidOrType := 'void' | Type
- Throws:
CompileException
java.io.IOException
-
parseMethodDeclarationRest
public Java.MethodDeclarator parseMethodDeclarationRest(@Nullable java.lang.String docComment, Java.Modifier[] modifiers, @Nullable Java.TypeParameter[] typeParameters, Java.Type type, java.lang.String name, boolean allowDefaultClause, Parser.MethodDeclarationContext context) throws CompileException, java.io.IOException
MethodDeclarationRest := FormalParameters { '[' ']' } [ 'throws' ReferenceTypeList ] [ 'default' expression ] ( ';' | MethodBody )
- Parameters:
allowDefaultClause
- Whether a "default clause" for an "annotation type element" (JLS8 9.6.2) should be parsed- Throws:
CompileException
java.io.IOException
-
getSourceVersion
private int getSourceVersion()
-
parseVariableInitializer
public Java.ArrayInitializerOrRvalue parseVariableInitializer() throws CompileException, java.io.IOException
VariableInitializer := ArrayInitializer | Expression
- Throws:
CompileException
java.io.IOException
-
parseArrayInitializer
public Java.ArrayInitializer parseArrayInitializer() throws CompileException, java.io.IOException
ArrayInitializer := '{' [ VariableInitializer { ',' VariableInitializer } [ ',' ] '}'
- Throws:
CompileException
java.io.IOException
-
parseFormalParameters
public Java.FunctionDeclarator.FormalParameters parseFormalParameters() throws CompileException, java.io.IOException
FormalParameters := '(' [ FormalParameterList ] ')'
- Throws:
CompileException
java.io.IOException
-
parseFormalParameterList
public Java.FunctionDeclarator.FormalParameters parseFormalParameterList() throws CompileException, java.io.IOException
FormalParameterList := FormalParameter { ',' FormalParameter }
- Throws:
CompileException
java.io.IOException
-
parseFormalParameterListRest
public Java.FunctionDeclarator.FormalParameters parseFormalParameterListRest(Java.Type firstParameterType) throws CompileException, java.io.IOException
FormalParameterListRest := Identifier { ',' FormalParameter }
- Throws:
CompileException
java.io.IOException
-
parseFormalParameter
public Java.FunctionDeclarator.FormalParameter parseFormalParameter(boolean[] hasEllipsis) throws CompileException, java.io.IOException
FormalParameter := [ 'final' ] Type FormalParameterRest
- Throws:
CompileException
java.io.IOException
-
parseFormalParameterRest
public Java.FunctionDeclarator.FormalParameter parseFormalParameterRest(Java.Modifier[] modifiers, Java.Type type, boolean[] hasEllipsis) throws CompileException, java.io.IOException
FormalParameterRest := [ '.' '.' '.' ] Identifier BracketsOpt
- Parameters:
hasEllipsis
- After return, the zeroth element indicates whether the formal parameter was declared with an ellipsis- Throws:
CompileException
java.io.IOException
-
parseCatchParameter
public Java.CatchParameter parseCatchParameter() throws CompileException, java.io.IOException
CatchFormalParameter := { VariableModifier } CatchType VariableDeclaratorId CatchType := UnannClassType { '|' ClassType } VariableModifier := Annotation | 'final' VariableDeclaratorId := Identifier [ Dims ] Dims := { Annotation } '[' ']' { { Annotation } '[' ']' } UnannClassType := Identifier [ TypeArguments ] | UnannClassOrInterfaceType '.' { Annotation } Identifier [ TypeArguments ] UnannInterfaceType := UnannClassType UnannClassOrInterfaceType := UnannClassType | UnannInterfaceType ClassType := { Annotation } Identifier [ TypeArguments ] | ClassOrInterfaceType '.' { Annotation } Identifier [ TypeArguments ]
- Throws:
CompileException
java.io.IOException
-
parseBracketsOpt
int parseBracketsOpt() throws CompileException, java.io.IOException
BracketsOpt := { '[' ']' }
- Throws:
CompileException
java.io.IOException
-
parseMethodBody
public Java.Block parseMethodBody() throws CompileException, java.io.IOException
MethodBody := Block
- Throws:
CompileException
java.io.IOException
-
parseBlock
public Java.Block parseBlock() throws CompileException, java.io.IOException
Block := '{' BlockStatements '}'
- Throws:
CompileException
java.io.IOException
-
parseBlockStatements
public java.util.List<Java.BlockStatement> parseBlockStatements() throws CompileException, java.io.IOException
BlockStatements := { BlockStatement }
- Throws:
CompileException
java.io.IOException
-
parseBlockStatement
public Java.BlockStatement parseBlockStatement() throws CompileException, java.io.IOException
BlockStatement := Statement | (1) 'class' ... | (2) Modifiers Type VariableDeclarators ';' | Expression ';' | Expression BracketsOpt VariableDeclarators ';' (3)
(1) Includes the "labeled statement".
(2) Local class declaration.
(3) Local variable declaration statement; "Expression" must pose a type, and has optional trailing brackets.
- Throws:
CompileException
java.io.IOException
-
parseVariableDeclarators
public Java.VariableDeclarator[] parseVariableDeclarators() throws CompileException, java.io.IOException
VariableDeclarators := VariableDeclarator { ',' VariableDeclarator }
- Throws:
CompileException
java.io.IOException
-
parseFieldDeclarationRest
public Java.VariableDeclarator[] parseFieldDeclarationRest(java.lang.String name) throws CompileException, java.io.IOException
FieldDeclarationRest := VariableDeclaratorRest { ',' VariableDeclarator }
- Throws:
CompileException
java.io.IOException
-
parseVariableDeclarator
public Java.VariableDeclarator parseVariableDeclarator() throws CompileException, java.io.IOException
VariableDeclarator := Identifier VariableDeclaratorRest
- Throws:
CompileException
java.io.IOException
-
parseVariableDeclaratorRest
public Java.VariableDeclarator parseVariableDeclaratorRest(java.lang.String name) throws CompileException, java.io.IOException
VariableDeclaratorRest := { '[' ']' } [ '=' VariableInitializer ]
Used by field declarations and local variable declarations.
- Throws:
CompileException
java.io.IOException
-
parseStatement
public Java.Statement parseStatement() throws CompileException, java.io.IOException
Statement := LabeledStatement | Block | IfStatement | ForStatement | WhileStatement | DoStatement | TryStatement | 'switch' ... | 'synchronized' ... | ReturnStatement | ThrowStatement | BreakStatement | ContinueStatement | EmptyStatement | ExpressionStatement
- Throws:
CompileException
java.io.IOException
-
parseLabeledStatement
public Java.Statement parseLabeledStatement() throws CompileException, java.io.IOException
LabeledStatement := Identifier ':' Statement
- Throws:
CompileException
java.io.IOException
-
parseIfStatement
public Java.Statement parseIfStatement() throws CompileException, java.io.IOException
IfStatement := 'if' '(' Expression ')' Statement [ 'else' Statement ]
- Throws:
CompileException
java.io.IOException
-
parseForStatement
public Java.Statement parseForStatement() throws CompileException, java.io.IOException
ForStatement := 'for' '(' [ ForInit ] ';' [ Expression ] ';' [ ExpressionList ] ')' Statement | 'for' '(' FormalParameter ':' Expression ')' Statement ForInit := Modifiers Type VariableDeclarators | ModifiersOpt PrimitiveType VariableDeclarators | Expression VariableDeclarators (1) | Expression { ',' Expression }
(1) "Expression" must pose a type.
- Throws:
CompileException
java.io.IOException
-
parseWhileStatement
public Java.Statement parseWhileStatement() throws CompileException, java.io.IOException
WhileStatement := 'while' '(' Expression ')' Statement
- Throws:
CompileException
java.io.IOException
-
parseDoStatement
public Java.Statement parseDoStatement() throws CompileException, java.io.IOException
DoStatement := 'do' Statement 'while' '(' Expression ')' ';'
- Throws:
CompileException
java.io.IOException
-
parseTryStatement
public Java.Statement parseTryStatement() throws CompileException, java.io.IOException
TryStatement := 'try' Block Catches [ Finally ] | 'try' Block Finally Catches := CatchClause { CatchClause } CatchClause := 'catch' '(' FormalParameter ')' Block Finally := 'finally' Block
- Throws:
CompileException
java.io.IOException
-
parseResource
private Java.TryStatement.Resource parseResource() throws CompileException, java.io.IOException
Resource := Modifiers Type VariableDeclarator | VariableAccess
- Throws:
CompileException
java.io.IOException
-
parseSwitchStatement
public Java.Statement parseSwitchStatement() throws CompileException, java.io.IOException
SwitchStatement := 'switch' '(' Expression ')' '{' { SwitchLabels BlockStatements } '}' SwitchLabels := SwitchLabels { SwitchLabels } SwitchLabel := 'case' Expression ':' | 'default' ':'
- Throws:
CompileException
java.io.IOException
-
parseSynchronizedStatement
public Java.Statement parseSynchronizedStatement() throws CompileException, java.io.IOException
SynchronizedStatement := 'synchronized' '(' expression ')' Block
- Throws:
CompileException
java.io.IOException
-
parseReturnStatement
public Java.Statement parseReturnStatement() throws CompileException, java.io.IOException
ReturnStatement := 'return' [ Expression ] ';'
- Throws:
CompileException
java.io.IOException
-
parseThrowStatement
public Java.Statement parseThrowStatement() throws CompileException, java.io.IOException
ThrowStatement := 'throw' Expression ';'
- Throws:
CompileException
java.io.IOException
-
parseBreakStatement
public Java.Statement parseBreakStatement() throws CompileException, java.io.IOException
BreakStatement := 'break' [ Identifier ] ';'
- Throws:
CompileException
java.io.IOException
-
parseContinueStatement
public Java.Statement parseContinueStatement() throws CompileException, java.io.IOException
ContinueStatement := 'continue' [ Identifier ] ';'
- Throws:
CompileException
java.io.IOException
-
parseAssertStatement
public Java.Statement parseAssertStatement() throws CompileException, java.io.IOException
AssertStatement := 'assert' Expression [ ':' Expression ] ';'
- Throws:
CompileException
java.io.IOException
-
parseEmptyStatement
public Java.Statement parseEmptyStatement() throws CompileException, java.io.IOException
EmptyStatement := ';'
- Throws:
CompileException
java.io.IOException
-
parseExpressionList
public Java.Rvalue[] parseExpressionList() throws CompileException, java.io.IOException
ExpressionList := Expression { ',' Expression }
- Throws:
CompileException
java.io.IOException
-
parseType
public Java.Type parseType() throws CompileException, java.io.IOException
Type := ( 'byte' | 'short' | 'char' | 'int' | 'long' | 'float' | 'double' | 'boolean' | ReferenceType ) { '[' ']' }
- Throws:
CompileException
java.io.IOException
-
parseReferenceType
public Java.ReferenceType parseReferenceType() throws CompileException, java.io.IOException
ReferenceType := { Annotation } QualifiedIdentifier [ TypeArguments ]
- Throws:
CompileException
java.io.IOException
-
parseTypeParametersOpt
@Nullable private Java.TypeParameter[] parseTypeParametersOpt() throws CompileException, java.io.IOException
TypeParameters := '<' TypeParameter { ',' TypeParameter } '>'
- Throws:
CompileException
java.io.IOException
-
parseTypeParameter
private Java.TypeParameter parseTypeParameter() throws CompileException, java.io.IOException
TypeParameter := identifier [ 'extends' ( identifier | ReferenceType { '&' ReferenceType }
- Throws:
CompileException
java.io.IOException
-
parseTypeArgumentsOpt
@Nullable private Java.TypeArgument[] parseTypeArgumentsOpt() throws CompileException, java.io.IOException
TypeArguments := '<' [ TypeArgument { ',' TypeArgument } ] '>'
- Returns:
null
iff there are no type arguments- Throws:
CompileException
java.io.IOException
-
parseTypeArgument
private Java.TypeArgument parseTypeArgument() throws CompileException, java.io.IOException
TypeArgument := ReferenceType { '[' ']' } <= The optional brackets are missing in JLS7, section 18!? | PrimitiveType '[' ']' { '[' ']' } | '?' extends ReferenceType | '?' super ReferenceType
- Throws:
CompileException
java.io.IOException
-
parseReferenceTypeList
public Java.ReferenceType[] parseReferenceTypeList() throws CompileException, java.io.IOException
ReferenceTypeList := ReferenceType { ',' ReferenceType }
- Throws:
CompileException
java.io.IOException
-
parseExpression
public Java.Rvalue parseExpression() throws CompileException, java.io.IOException
Expression := AssignmentExpression | LambdaExpression
Notice that all other kinds of lambda expressions are parsed in
parsePrimary()
.- Throws:
CompileException
java.io.IOException
-
parseExpressionOrType
public Java.Atom parseExpressionOrType() throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
parseAssignmentExpression
public Java.Atom parseAssignmentExpression() throws CompileException, java.io.IOException
AssignmentExpression := ConditionalExpression [ AssignmentOperator AssignmentExpression ] AssignmentOperator := '=' | '*=' | '/=' | '%=' | '+=' | '-=' | '<<=' | '>>=' | '>>>=' | '&=' | '^=' | '|='
- Throws:
CompileException
java.io.IOException
-
parseConditionalExpression
public Java.Atom parseConditionalExpression() throws CompileException, java.io.IOException
ConditionalExpression := ConditionalOrExpression [ '?' Expression ':' ConditionalExpression ]
- Throws:
CompileException
java.io.IOException
-
parseConditionalOrExpression
public Java.Atom parseConditionalOrExpression() throws CompileException, java.io.IOException
ConditionalOrExpression := ConditionalAndExpression { '||' ConditionalAndExpression ]
- Throws:
CompileException
java.io.IOException
-
parseConditionalAndExpression
public Java.Atom parseConditionalAndExpression() throws CompileException, java.io.IOException
ConditionalAndExpression := InclusiveOrExpression { '&&' InclusiveOrExpression }
- Throws:
CompileException
java.io.IOException
-
parseInclusiveOrExpression
public Java.Atom parseInclusiveOrExpression() throws CompileException, java.io.IOException
InclusiveOrExpression := ExclusiveOrExpression { '|' ExclusiveOrExpression }
- Throws:
CompileException
java.io.IOException
-
parseExclusiveOrExpression
public Java.Atom parseExclusiveOrExpression() throws CompileException, java.io.IOException
ExclusiveOrExpression := AndExpression { '^' AndExpression }
- Throws:
CompileException
java.io.IOException
-
parseAndExpression
public Java.Atom parseAndExpression() throws CompileException, java.io.IOException
AndExpression := EqualityExpression { '&' EqualityExpression }
- Throws:
CompileException
java.io.IOException
-
parseEqualityExpression
public Java.Atom parseEqualityExpression() throws CompileException, java.io.IOException
EqualityExpression := RelationalExpression { ( '==' | '!=' ) RelationalExpression }
- Throws:
CompileException
java.io.IOException
-
parseRelationalExpression
public Java.Atom parseRelationalExpression() throws CompileException, java.io.IOException
RelationalExpression := ShiftExpression { 'instanceof' ReferenceType | '<' ShiftExpression [ { ',' TypeArgument } '>' ] | '<' TypeArgument [ { ',' TypeArgument } '>' ] | ( '>' | '<=' | '>=' ) ShiftExpression }
- Throws:
CompileException
java.io.IOException
-
parseShiftExpression
public Java.Atom parseShiftExpression() throws CompileException, java.io.IOException
ShiftExpression := AdditiveExpression { ( '<<' | '>>' | '>>>' ) AdditiveExpression }
- Throws:
CompileException
java.io.IOException
-
parseAdditiveExpression
public Java.Atom parseAdditiveExpression() throws CompileException, java.io.IOException
AdditiveExpression := MultiplicativeExpression { ( '+' | '-' ) MultiplicativeExpression }
- Throws:
CompileException
java.io.IOException
-
parseMultiplicativeExpression
public Java.Atom parseMultiplicativeExpression() throws CompileException, java.io.IOException
MultiplicativeExpression := UnaryExpression { ( '*' | '/' | '%' ) UnaryExpression }
- Throws:
CompileException
java.io.IOException
-
parseUnaryExpression
public Java.Atom parseUnaryExpression() throws CompileException, java.io.IOException
UnaryExpression := { PrefixOperator } Primary { Selector } { PostfixOperator } PrefixOperator := '++' | '--' | '+' | '-' | '~' | '!' PostfixOperator := '++' | '--'
- Throws:
CompileException
java.io.IOException
-
parsePrimary
public Java.Atom parsePrimary() throws CompileException, java.io.IOException
Primary := CastExpression | // CastExpression 15.16 '(' Expression ')' | // ParenthesizedExpression 15.8.5 Literal | // Literal 15.8.1 Name | // AmbiguousName Name Arguments | // MethodInvocation Name '[]' { '[]' } | // ArrayType 10.1 Name '[]' { '[]' } '.' 'class' | // ClassLiteral 15.8.2 'this' | // This 15.8.3 'this' Arguments | // Alternate constructor invocation 8.8.5.1 'super' Arguments | // Unqualified superclass constructor invocation 8.8.5.1 'super' '.' Identifier | // SuperclassFieldAccess 15.11.2 'super' '.' Identifier Arguments | // SuperclassMethodInvocation 15.12.4.9 NewClassInstance | NewAnonymousClassInstance | // ClassInstanceCreationExpression 15.9 NewArray | // ArrayCreationExpression 15.10 NewInitializedArray | // ArrayInitializer 10.6 PrimitiveType { '[]' } | // Type PrimitiveType { '[]' } '.' 'class' | // ClassLiteral 15.8.2 'void' '.' 'class' | // ClassLiteral 15.8.2 MethodReference // MethodReference JLS9 15.13 Name := Identifier { '.' Identifier } CastExpression := '(' PrimitiveType { '[]' } ')' UnaryExpression | '(' Expression ')' UnaryExpression NewClassInstance := 'new' ReferenceType Arguments NewAnonymousClassInstance := 'new' ReferenceType Arguments [ ClassBody ] NewArray := 'new' Type DimExprs { '[]' } NewInitializedArray := 'new' ArrayType ArrayInitializer
- Throws:
CompileException
java.io.IOException
-
parseSelector
public Java.Atom parseSelector(Java.Atom atom) throws CompileException, java.io.IOException
Selector := '.' Identifier | // FieldAccess 15.11.1 '.' Identifier Arguments | // MethodInvocation '.' '<' TypeList '>' 'super' Arguments // Superconstructor invocation (?) '.' '<' TypeList '>' 'super' '.' . Identifier // ??? '.' '<' TypeList '>' 'super' '.' . Identifier Arguments // Supermethod invocation '.' '<' TypeList '>' Identifier Arguments // ExplicitGenericInvocation '.' 'this' // QualifiedThis 15.8.4 '.' 'super' Arguments // Qualified superclass constructor invocation (JLS7 8.8.7.1) '.' 'super' '.' Identifier | // SuperclassFieldReference (JLS7 15.11.2) '.' 'super' '.' Identifier Arguments | // SuperclassMethodInvocation (JLS7 15.12.3) '.' 'new' Identifier Arguments [ ClassBody ] | // QualifiedClassInstanceCreationExpression 15.9 '.' 'class' '[' Expression ']' // ArrayAccessExpression 15.13 ExplicitGenericInvocationSuffix := 'super' SuperSuffix | Identifier Arguments
- Throws:
CompileException
java.io.IOException
-
parseDimExprs
public Java.Rvalue[] parseDimExprs() throws CompileException, java.io.IOException
DimExprs := DimExpr { DimExpr }
- Throws:
CompileException
java.io.IOException
-
parseDimExpr
public Java.Rvalue parseDimExpr() throws CompileException, java.io.IOException
DimExpr := '[' Expression ']'
- Throws:
CompileException
java.io.IOException
-
parseArguments
public Java.Rvalue[] parseArguments() throws CompileException, java.io.IOException
Arguments := '(' [ ArgumentList ] ')'
- Throws:
CompileException
java.io.IOException
-
parseArgumentList
public Java.Rvalue[] parseArgumentList() throws CompileException, java.io.IOException
ArgumentList := Expression { ',' Expression }
- Throws:
CompileException
java.io.IOException
-
parseLiteral
public Java.Rvalue parseLiteral() throws CompileException, java.io.IOException
Literal := IntegerLiteral | FloatingPointLiteral | BooleanLiteral | CharacterLiteral | StringLiteral | NullLiteral
- Throws:
CompileException
java.io.IOException
-
parseLambdaExpression
private Java.LambdaExpression parseLambdaExpression() throws CompileException, java.io.IOException
LambdaExpression := LambdaParameters '->' LambdaBody
- Throws:
CompileException
java.io.IOException
-
parseLambdaParameters
private Java.LambdaParameters parseLambdaParameters() throws CompileException, java.io.IOException
LambdaParameters := Identifier | '(' [ FormalParameterList ] ')' | '(' InferredFormalParameterList ')'
- Throws:
CompileException
java.io.IOException
-
parseLambdaBody
private Java.LambdaBody parseLambdaBody() throws CompileException, java.io.IOException
LambdaBody :=
- Throws:
CompileException
java.io.IOException
-
parseExpressionStatement
public Java.Statement parseExpressionStatement() throws CompileException, java.io.IOException
ExpressionStatement := Expression ';'
- Throws:
CompileException
java.io.IOException
-
location
public Location location()
- Returns:
- The location of the first character of the previously read (not peeked!) token
-
peek
public Token peek() throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
read
public Token read() throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peek
public boolean peek(java.lang.String suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peek
public int peek(java.lang.String... suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peek
public boolean peek(TokenType suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peek
public int peek(TokenType... suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekNextButOne
public Token peekNextButOne() throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekNextButOne
public boolean peekNextButOne(java.lang.String suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekNextButOne
public boolean peekNextButOne(TokenType suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
read
public void read(java.lang.String expected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
read
public int read(java.lang.String... expected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
read
public java.lang.String read(TokenType expected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekRead
public boolean peekRead(java.lang.String suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekRead
public int peekRead(java.lang.String... suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekRead
@Nullable public java.lang.String peekRead(TokenType suspected) throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
peekLiteral
private boolean peekLiteral() throws CompileException, java.io.IOException
- Throws:
CompileException
java.io.IOException
-
verifyStringIsConventionalPackageName
private void verifyStringIsConventionalPackageName(java.lang.String s, Location loc) throws CompileException
Issues a warning if the given string does not comply with the package naming conventions.- Throws:
CompileException
-
verifyIdentifierIsConventionalClassOrInterfaceName
private void verifyIdentifierIsConventionalClassOrInterfaceName(java.lang.String id, Location loc) throws CompileException
Issues a warning if the given identifier does not comply with the class and interface type naming conventions (JLS7 6.8.2).- Throws:
CompileException
-
verifyIdentifierIsConventionalMethodName
private void verifyIdentifierIsConventionalMethodName(java.lang.String id, Location loc) throws CompileException
Issues a warning if the given identifier does not comply with the method naming conventions (JLS7 6.8.3).- Throws:
CompileException
-
verifyIdentifierIsConventionalFieldName
private void verifyIdentifierIsConventionalFieldName(java.lang.String id, Location loc) throws CompileException
Issues a warning if the given identifier does not comply with the field naming conventions (JLS7 6.8.4) and constant naming conventions (JLS7 6.8.5).- Throws:
CompileException
-
verifyIdentifierIsConventionalLocalVariableOrParameterName
private void verifyIdentifierIsConventionalLocalVariableOrParameterName(java.lang.String id, Location loc) throws CompileException
Issues a warning if the given identifier does not comply with the local variable and parameter naming conventions (JLS7 6.8.6).- Throws:
CompileException
-
setSourceVersion
public void setSourceVersion(int version)
-
setWarningHandler
public void setWarningHandler(@Nullable WarningHandler warningHandler)
By default, warnings are discarded, but an application my install aWarningHandler
.Notice that there is no
Parser.setErrorHandler()
method, but parse errors always throw aCompileException
. The reason being is that there is no reasonable way to recover from parse errors and continue parsing, so there is no need to install a custom parse error handler.- Parameters:
warningHandler
-null
to indicate that no warnings be issued
-
warning
private void warning(java.lang.String handle, java.lang.String message) throws CompileException
- Throws:
CompileException
-
warning
private void warning(java.lang.String handle, java.lang.String message, @Nullable Location location) throws CompileException
Issues a warning with the given message and location and returns. This is done through aWarningHandler
that was installed throughsetWarningHandler(WarningHandler)
.The
handle
argument qualifies the warning and is typically used by theWarningHandler
to suppress individual warnings.- Throws:
CompileException
- The optionally installedWarningHandler
decided to throw aCompileException
-
compileException
protected final CompileException compileException(java.lang.String message)
Convenience method for throwing aCompileException
.
-
compileException
protected static CompileException compileException(java.lang.String message, Location location)
Convenience method for throwing aCompileException
.
-
join
private static java.lang.String join(@Nullable java.lang.String[] sa, java.lang.String separator)
-
hasAccessModifier
private static boolean hasAccessModifier(Java.Modifier[] modifiers, java.lang.String... keywords)
-
hasAccessModifierOtherThan
private static boolean hasAccessModifierOtherThan(Java.Modifier[] modifiers, java.lang.String... keywords)
-
packageModifiers
private Java.Modifier[] packageModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
classModifiers
private Java.Modifier[] classModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
packageMemberClassModifiers
private Java.Modifier[] packageMemberClassModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
fieldModifiers
private Java.Modifier[] fieldModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
methodModifiers
private Java.Modifier[] methodModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
variableModifiers
private Java.Modifier[] variableModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
constructorModifiers
private Java.Modifier[] constructorModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
enumConstantModifiers
private Java.Modifier[] enumConstantModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
interfaceModifiers
private Java.Modifier[] interfaceModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
packageMemberInterfaceModifiers
private Java.Modifier[] packageMemberInterfaceModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
constantModifiers
private Java.Modifier[] constantModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
interfaceMethodModifiers
private Java.Modifier[] interfaceMethodModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
annotationTypeElementModifiers
private Java.Modifier[] annotationTypeElementModifiers(Java.Modifier[] modifiers) throws CompileException
- Throws:
CompileException
-
checkModifiers
private Java.Modifier[] checkModifiers(Java.Modifier[] modifiers, java.lang.String... allowedKeywords) throws CompileException
Verifies that the modifiers are consistent.- No two annotations must have the same type.
- No access modifier must appear more than once
- Certain modifier combinations must not occur (e.g.
abstract final
).
- Returns:
- modifiers
- Throws:
CompileException
-
-