Class GroovyRecognizer

  • All Implemented Interfaces:
    GroovyTokenTypes

    public class GroovyRecognizer
    extends antlr.LLkParser
    implements GroovyTokenTypes
    JSR-241 Groovy Recognizer. Run 'java Main [-showtree] directory-full-of-groovy-files' [The -showtree option pops up a Swing frame that shows the AST constructed from the parser.] Contributing authors: John Mitchell johnm@non.net Terence Parr parrt@magelang.com John Lilley jlilley@empathy.com Scott Stanchfield thetick@magelang.com Markus Mohnen mohnen@informatik.rwth-aachen.de Peter Williams pete.williams@sun.com Allan Jacobs Allan.Jacobs@eng.sun.com Steve Messick messick@redhills.com James Strachan jstrachan@protique.com John Pybus john@pybus.org John Rose rose00@mac.com Jeremy Rayner groovy@ross-rayner.com Alex Popescu the.mindstorm@gmail.com Martin Kempf mkempf@hsr.ch Reto Kleeb rkleeb@hsr.ch Version 1.00 December 9, 1997 -- initial release Version 1.01 December 10, 1997 fixed bug in octal def (0..7 not 0..8) Version 1.10 August 1998 (parrt) added tree construction fixed definition of WS,comments for mac,pc,unix newlines added unary plus Version 1.11 (Nov 20, 1998) Added "shutup" option to turn off last ambig warning. Fixed inner class def to allow named class defs as statements synchronized requires compound not simple statement add [] after builtInType DOT class in primaryExpression "const" is reserved but not valid..removed from modifiers Version 1.12 (Feb 2, 1999) Changed LITERAL_xxx to xxx in tree grammar. Updated java.g to use tokens {...} now for 2.6.0 (new feature). Version 1.13 (Apr 23, 1999) Didn't have (stat)? for else clause in tree parser. Didn't gen ASTs for interface extends. Updated tree parser too. Updated to 2.6.0. Version 1.14 (Jun 20, 1999) Allowed final/abstract on local classes. Removed local interfaces from methods Put instanceof precedence where it belongs...in relationalExpr It also had expr not type as arg; fixed it. Missing ! on SEMI in classBlock fixed: (expr) + "string" was parsed incorrectly (+ as unary plus). fixed: didn't like Object[].class in parser or tree parser Version 1.15 (Jun 26, 1999) Screwed up rule with instanceof in it. :( Fixed. Tree parser didn't like (expr).something; fixed. Allowed multiple inheritance in tree grammar. oops. Version 1.16 (August 22, 1999) Extending an interface built a wacky tree: had extra EXTENDS. Tree grammar didn't allow multiple superinterfaces. Tree grammar didn't allow empty var initializer: {} Version 1.17 (October 12, 1999) ESC lexer rule allowed 399 max not 377 max. java.tree.g didn't handle the expression of synchronized statements. Version 1.18 (August 12, 2001) Terence updated to Java 2 Version 1.3 by observing/combining work of Allan Jacobs and Steve Messick. Handles 1.3 src. Summary: o primary didn't include boolean.class kind of thing o constructor calls parsed explicitly now: see explicitConstructorInvocation o add strictfp modifier o missing objBlock after new expression in tree grammar o merged local class definition alternatives, moved after declaration o fixed problem with ClassName.super.field o reordered some alternatives to make things more efficient o long and double constants were not differentiated from int/float o whitespace rule was inefficient: matched only one char o add an examples directory with some nasty 1.3 cases o made Main.java use buffered IO and a Reader for Unicode support o supports UNICODE? Using Unicode charVocabulary makes code file big, but only in the bitsets at the end. I need to make ANTLR generate unicode bitsets more efficiently. Version 1.19 (April 25, 2002) Terence added in nice fixes by John Pybus concerning floating constants and problems with super() calls. John did a nice reorg of the primary/postfix expression stuff to read better and makes f.g.super() parse properly (it was METHOD_CALL not a SUPER_CTOR_CALL). Also: o "finally" clause was a root...made it a child of "try" o Added stuff for asserts too for Java 1.4, but *commented out* as it is not backward compatible. Version 1.20 (October 27, 2002) Terence ended up reorging John Pybus' stuff to remove some nondeterminisms and some syntactic predicates. Note that the grammar is stricter now; e.g., this(...) must be the first statement. Trinary ?: operator wasn't working as array name: (isBig ? bigDigits : digits)[i]; Checked parser/tree parser on source for Resin-2.0.5, jive-2.1.1, jdk 1.3.1, Lucene, antlr 2.7.2a4, and the 110k-line jGuru server source. Version 1.21 (October 17, 2003) Fixed lots of problems including: Ray Waldin: add typeDefinition to interfaceBlock in java.tree.g He found a problem/fix with floating point that start with 0 Ray also fixed problem that (int.class) was not recognized. Thorsten van Ellen noticed that \n are allowed incorrectly in strings. TJP fixed CHAR_LITERAL analogously. Version 1.21.2 (March, 2003) Changes by Matt Quail to support generics (as per JDK1.5/JSR14) Notes: o We only allow the "extends" keyword and not the "implements" keyword, since that's what JSR14 seems to imply. o Thanks to Monty Zukowski for his help on the antlr-interest mail list. o Thanks to Alan Eliasen for testing the grammar over his Fink source base Version 1.22 (July, 2004) Changes by Michael Studman to support Java 1.5 language extensions Notes: o Added support for annotations types o Finished off Matt Quail's generics enhancements to support bound type arguments o Added support for new for statement syntax o Added support for static import syntax o Added support for enum types o Tested against JDK 1.5 source base and source base of jdigraph project o Thanks to Matt Quail for doing the hard part by doing most of the generics work Version 1.22.1 (July 28, 2004) Bug/omission fixes for Java 1.5 language support o Fixed tree structure bug with classOrInterface - thanks to Pieter Vangorpto for spotting this o Fixed bug where incorrect handling of SR and BSR tokens would cause type parameters to be recognised as type arguments. o Enabled type parameters on constructors, annotations on enum constants and package definitions o Fixed problems when parsing if ((char.class.equals(c))) {} - solution by Matt Quail at Cenqua Version 1.22.2 (July 28, 2004) Slight refactoring of Java 1.5 language support o Refactored for/"foreach" productions so that original literal "for" literal is still used but the for sub-clauses vary by token type o Fixed bug where type parameter was not included in generic constructor's branch of AST Version 1.22.3 (August 26, 2004) Bug fixes as identified by Michael Stahl; clean up of tabs/spaces and other refactorings o Fixed typeParameters omission in identPrimary and newStatement o Replaced GT reconcilliation code with simple semantic predicate o Adapted enum/assert keyword checking support from Michael Stahl's java15 grammar o Refactored typeDefinition production and field productions to reduce duplication Version 1.22.4 (October 21, 2004) Small bux fixes o Added typeArguments to explicitConstructorInvocation, e.g. new MyParameterised() o Added typeArguments to postfixExpression productions for anonymous inner class super constructor invocation, e.g. new Outer().super() o Fixed bug in array declarations identified by Geoff Roy Version 1.22.4.g.1 o I have taken java.g for Java1.5 from Michael Studman (1.22.4) and have applied the groovy.diff from java.g (1.22) by John Rose back onto the new root (1.22.4) - Jeremy Rayner (Jan 2005) Version 1.22.4.g.2 o mkempf, rkleeb, Dec 2007 o fixed various rules so that they call the correct Create Method to make sure that the line information are correct Based on an original grammar released in the PUBLIC DOMAIN
    • Field Detail

      • tracing

        public static boolean tracing
      • _tokenNames

        public static final java.lang.String[] _tokenNames
      • _tokenSet_0

        public static final antlr.collections.impl.BitSet _tokenSet_0
      • _tokenSet_1

        public static final antlr.collections.impl.BitSet _tokenSet_1
      • _tokenSet_2

        public static final antlr.collections.impl.BitSet _tokenSet_2
      • _tokenSet_3

        public static final antlr.collections.impl.BitSet _tokenSet_3
      • _tokenSet_4

        public static final antlr.collections.impl.BitSet _tokenSet_4
      • _tokenSet_5

        public static final antlr.collections.impl.BitSet _tokenSet_5
      • _tokenSet_6

        public static final antlr.collections.impl.BitSet _tokenSet_6
      • _tokenSet_7

        public static final antlr.collections.impl.BitSet _tokenSet_7
      • _tokenSet_8

        public static final antlr.collections.impl.BitSet _tokenSet_8
      • _tokenSet_9

        public static final antlr.collections.impl.BitSet _tokenSet_9
      • _tokenSet_10

        public static final antlr.collections.impl.BitSet _tokenSet_10
      • _tokenSet_11

        public static final antlr.collections.impl.BitSet _tokenSet_11
      • _tokenSet_12

        public static final antlr.collections.impl.BitSet _tokenSet_12
      • _tokenSet_13

        public static final antlr.collections.impl.BitSet _tokenSet_13
      • _tokenSet_14

        public static final antlr.collections.impl.BitSet _tokenSet_14
      • _tokenSet_15

        public static final antlr.collections.impl.BitSet _tokenSet_15
      • _tokenSet_16

        public static final antlr.collections.impl.BitSet _tokenSet_16
      • _tokenSet_17

        public static final antlr.collections.impl.BitSet _tokenSet_17
      • _tokenSet_18

        public static final antlr.collections.impl.BitSet _tokenSet_18
      • _tokenSet_19

        public static final antlr.collections.impl.BitSet _tokenSet_19
      • _tokenSet_20

        public static final antlr.collections.impl.BitSet _tokenSet_20
      • _tokenSet_21

        public static final antlr.collections.impl.BitSet _tokenSet_21
      • _tokenSet_22

        public static final antlr.collections.impl.BitSet _tokenSet_22
      • _tokenSet_23

        public static final antlr.collections.impl.BitSet _tokenSet_23
      • _tokenSet_24

        public static final antlr.collections.impl.BitSet _tokenSet_24
      • _tokenSet_25

        public static final antlr.collections.impl.BitSet _tokenSet_25
      • _tokenSet_26

        public static final antlr.collections.impl.BitSet _tokenSet_26
      • _tokenSet_27

        public static final antlr.collections.impl.BitSet _tokenSet_27
      • _tokenSet_28

        public static final antlr.collections.impl.BitSet _tokenSet_28
      • _tokenSet_29

        public static final antlr.collections.impl.BitSet _tokenSet_29
      • _tokenSet_30

        public static final antlr.collections.impl.BitSet _tokenSet_30
      • _tokenSet_31

        public static final antlr.collections.impl.BitSet _tokenSet_31
      • _tokenSet_32

        public static final antlr.collections.impl.BitSet _tokenSet_32
      • _tokenSet_33

        public static final antlr.collections.impl.BitSet _tokenSet_33
      • _tokenSet_34

        public static final antlr.collections.impl.BitSet _tokenSet_34
      • _tokenSet_35

        public static final antlr.collections.impl.BitSet _tokenSet_35
      • _tokenSet_36

        public static final antlr.collections.impl.BitSet _tokenSet_36
      • _tokenSet_37

        public static final antlr.collections.impl.BitSet _tokenSet_37
      • _tokenSet_38

        public static final antlr.collections.impl.BitSet _tokenSet_38
      • _tokenSet_39

        public static final antlr.collections.impl.BitSet _tokenSet_39
      • _tokenSet_40

        public static final antlr.collections.impl.BitSet _tokenSet_40
      • _tokenSet_41

        public static final antlr.collections.impl.BitSet _tokenSet_41
      • _tokenSet_42

        public static final antlr.collections.impl.BitSet _tokenSet_42
      • _tokenSet_43

        public static final antlr.collections.impl.BitSet _tokenSet_43
      • _tokenSet_44

        public static final antlr.collections.impl.BitSet _tokenSet_44
      • _tokenSet_45

        public static final antlr.collections.impl.BitSet _tokenSet_45
      • _tokenSet_46

        public static final antlr.collections.impl.BitSet _tokenSet_46
      • _tokenSet_47

        public static final antlr.collections.impl.BitSet _tokenSet_47
      • _tokenSet_48

        public static final antlr.collections.impl.BitSet _tokenSet_48
      • _tokenSet_49

        public static final antlr.collections.impl.BitSet _tokenSet_49
      • _tokenSet_50

        public static final antlr.collections.impl.BitSet _tokenSet_50
      • _tokenSet_51

        public static final antlr.collections.impl.BitSet _tokenSet_51
      • _tokenSet_52

        public static final antlr.collections.impl.BitSet _tokenSet_52
      • _tokenSet_53

        public static final antlr.collections.impl.BitSet _tokenSet_53
      • _tokenSet_54

        public static final antlr.collections.impl.BitSet _tokenSet_54
      • _tokenSet_55

        public static final antlr.collections.impl.BitSet _tokenSet_55
      • _tokenSet_56

        public static final antlr.collections.impl.BitSet _tokenSet_56
      • _tokenSet_57

        public static final antlr.collections.impl.BitSet _tokenSet_57
      • _tokenSet_58

        public static final antlr.collections.impl.BitSet _tokenSet_58
      • _tokenSet_59

        public static final antlr.collections.impl.BitSet _tokenSet_59
      • _tokenSet_60

        public static final antlr.collections.impl.BitSet _tokenSet_60
      • _tokenSet_61

        public static final antlr.collections.impl.BitSet _tokenSet_61
      • _tokenSet_62

        public static final antlr.collections.impl.BitSet _tokenSet_62
      • _tokenSet_63

        public static final antlr.collections.impl.BitSet _tokenSet_63
      • _tokenSet_64

        public static final antlr.collections.impl.BitSet _tokenSet_64
      • _tokenSet_65

        public static final antlr.collections.impl.BitSet _tokenSet_65
      • _tokenSet_66

        public static final antlr.collections.impl.BitSet _tokenSet_66
      • _tokenSet_67

        public static final antlr.collections.impl.BitSet _tokenSet_67
      • _tokenSet_68

        public static final antlr.collections.impl.BitSet _tokenSet_68
      • _tokenSet_69

        public static final antlr.collections.impl.BitSet _tokenSet_69
      • _tokenSet_70

        public static final antlr.collections.impl.BitSet _tokenSet_70
      • _tokenSet_71

        public static final antlr.collections.impl.BitSet _tokenSet_71
      • _tokenSet_72

        public static final antlr.collections.impl.BitSet _tokenSet_72
      • _tokenSet_73

        public static final antlr.collections.impl.BitSet _tokenSet_73
      • _tokenSet_74

        public static final antlr.collections.impl.BitSet _tokenSet_74
      • _tokenSet_75

        public static final antlr.collections.impl.BitSet _tokenSet_75
      • _tokenSet_76

        public static final antlr.collections.impl.BitSet _tokenSet_76
      • _tokenSet_77

        public static final antlr.collections.impl.BitSet _tokenSet_77
      • _tokenSet_78

        public static final antlr.collections.impl.BitSet _tokenSet_78
      • _tokenSet_79

        public static final antlr.collections.impl.BitSet _tokenSet_79
      • _tokenSet_80

        public static final antlr.collections.impl.BitSet _tokenSet_80
      • _tokenSet_81

        public static final antlr.collections.impl.BitSet _tokenSet_81
      • _tokenSet_82

        public static final antlr.collections.impl.BitSet _tokenSet_82
      • _tokenSet_83

        public static final antlr.collections.impl.BitSet _tokenSet_83
      • _tokenSet_84

        public static final antlr.collections.impl.BitSet _tokenSet_84
      • _tokenSet_85

        public static final antlr.collections.impl.BitSet _tokenSet_85
      • _tokenSet_86

        public static final antlr.collections.impl.BitSet _tokenSet_86
      • _tokenSet_87

        public static final antlr.collections.impl.BitSet _tokenSet_87
      • _tokenSet_88

        public static final antlr.collections.impl.BitSet _tokenSet_88
      • _tokenSet_89

        public static final antlr.collections.impl.BitSet _tokenSet_89
      • _tokenSet_90

        public static final antlr.collections.impl.BitSet _tokenSet_90
      • _tokenSet_91

        public static final antlr.collections.impl.BitSet _tokenSet_91
      • _tokenSet_92

        public static final antlr.collections.impl.BitSet _tokenSet_92
      • _tokenSet_93

        public static final antlr.collections.impl.BitSet _tokenSet_93
      • _tokenSet_94

        public static final antlr.collections.impl.BitSet _tokenSet_94
      • _tokenSet_95

        public static final antlr.collections.impl.BitSet _tokenSet_95
      • _tokenSet_96

        public static final antlr.collections.impl.BitSet _tokenSet_96
      • _tokenSet_97

        public static final antlr.collections.impl.BitSet _tokenSet_97
      • _tokenSet_98

        public static final antlr.collections.impl.BitSet _tokenSet_98
      • _tokenSet_99

        public static final antlr.collections.impl.BitSet _tokenSet_99
      • _tokenSet_100

        public static final antlr.collections.impl.BitSet _tokenSet_100
      • _tokenSet_101

        public static final antlr.collections.impl.BitSet _tokenSet_101
      • _tokenSet_102

        public static final antlr.collections.impl.BitSet _tokenSet_102
      • _tokenSet_103

        public static final antlr.collections.impl.BitSet _tokenSet_103
      • _tokenSet_104

        public static final antlr.collections.impl.BitSet _tokenSet_104
      • _tokenSet_105

        public static final antlr.collections.impl.BitSet _tokenSet_105
      • _tokenSet_106

        public static final antlr.collections.impl.BitSet _tokenSet_106
      • _tokenSet_107

        public static final antlr.collections.impl.BitSet _tokenSet_107
      • _tokenSet_108

        public static final antlr.collections.impl.BitSet _tokenSet_108
      • _tokenSet_109

        public static final antlr.collections.impl.BitSet _tokenSet_109
      • _tokenSet_110

        public static final antlr.collections.impl.BitSet _tokenSet_110
      • _tokenSet_111

        public static final antlr.collections.impl.BitSet _tokenSet_111
    • Constructor Detail

      • GroovyRecognizer

        protected GroovyRecognizer​(antlr.TokenBuffer tokenBuf,
                                   int k)
      • GroovyRecognizer

        public GroovyRecognizer​(antlr.TokenBuffer tokenBuf)
      • GroovyRecognizer

        protected GroovyRecognizer​(antlr.TokenStream lexer,
                                   int k)
      • GroovyRecognizer

        public GroovyRecognizer​(antlr.TokenStream lexer)
      • GroovyRecognizer

        public GroovyRecognizer​(antlr.ParserSharedInputState state)
    • Method Detail

      • make

        public static GroovyRecognizer make​(GroovyLexer lexer)
        This factory is the correct way to wire together a Groovy parser and lexer.
      • make

        public static GroovyRecognizer make​(antlr.LexerSharedInputState in)
      • getWarningList

        public java.util.List getWarningList()
      • setFilename

        public void setFilename​(java.lang.String f)
        Overrides:
        setFilename in class antlr.Parser
      • setSourceBuffer

        public void setSourceBuffer​(SourceBuffer sourceBuffer)
      • create

        public antlr.collections.AST create​(int type,
                                            java.lang.String txt,
                                            antlr.collections.AST first)
        Create an AST node with the token type and text passed in, but with the same background information as another supplied Token (e.g. line numbers). To be used in place of antlr tree construction syntax, i.e. #[TOKEN,"text"] becomes create(TOKEN,"text",anotherToken) todo - change antlr.ASTFactory to do this instead...
      • create

        public antlr.collections.AST create​(int type,
                                            java.lang.String txt,
                                            antlr.Token first,
                                            antlr.Token last)
      • create

        public antlr.collections.AST create​(int type,
                                            java.lang.String txt,
                                            antlr.collections.AST first,
                                            antlr.Token last)
      • create

        public antlr.collections.AST create​(int type,
                                            java.lang.String txt,
                                            antlr.collections.AST first,
                                            antlr.collections.AST last)
      • cloneToken

        public antlr.Token cloneToken​(antlr.Token t)
        Clones the token
      • traceIn

        public void traceIn​(java.lang.String rname)
                     throws antlr.TokenStreamException
        Overrides:
        traceIn in class antlr.LLkParser
        Throws:
        antlr.TokenStreamException
      • traceOut

        public void traceOut​(java.lang.String rname)
                      throws antlr.TokenStreamException
        Overrides:
        traceOut in class antlr.LLkParser
        Throws:
        antlr.TokenStreamException
      • requireFailed

        public void requireFailed​(java.lang.String problem,
                                  java.lang.String solution)
                           throws antlr.SemanticException
        Throws:
        antlr.SemanticException
      • addWarning

        public void addWarning​(java.lang.String warning,
                               java.lang.String solution)
      • matchGenericTypeBracketsFailed

        public void matchGenericTypeBracketsFailed​(java.lang.String problem,
                                                   java.lang.String solution)
                                            throws antlr.SemanticException
        Throws:
        antlr.SemanticException
      • compilationUnit

        public final void compilationUnit()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • nls

        public final void nls()
                       throws antlr.RecognitionException,
                              antlr.TokenStreamException
        Zero or more insignificant newlines, all gobbled up and thrown away.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationsOpt

        public final void annotationsOpt()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • packageDefinition

        public final void packageDefinition()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • statement

        public final void statement​(int prevToken)
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        A statement is an element of a block. Typical statements are declarations (which are scoped to the block) and expressions.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • sep

        public final void sep()
                       throws antlr.RecognitionException,
                              antlr.TokenStreamException
        A statement separator is either a semicolon or a significant newline. Any number of additional (insignificant) newlines may accompany it.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • snippetUnit

        public final void snippetUnit()
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        A Groovy script or simple expression. Can be anything legal inside {...}.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • blockBody

        public final void blockBody​(int prevToken)
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        A block body is a parade of zero or more statements or expressions.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • identifier

        public final void identifier()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • importStatement

        public final void importStatement()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • identifierStar

        public final void identifierStar()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeDefinitionInternal

        protected final void typeDefinitionInternal​(antlr.collections.AST mods)
                                             throws antlr.RecognitionException,
                                                    antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • classDefinition

        public final void classDefinition​(antlr.collections.AST modifiers)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • traitDefinition

        public final void traitDefinition​(antlr.collections.AST modifiers)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • interfaceDefinition

        public final void interfaceDefinition​(antlr.collections.AST modifiers)
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumDefinition

        public final void enumDefinition​(antlr.collections.AST modifiers)
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationDefinition

        public final void annotationDefinition​(antlr.collections.AST modifiers)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • declaration

        public final void declaration()
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        A declaration is the creation of a reference or primitive-type variable, or (if arguments are present) of a method. Generically, this is called a 'variable' definition, even in the case of a class field or method. It may start with the modifiers and/or a declaration keyword "def". It may also start with the modifiers and a capitalized type name.

        AST effect: Create a separate Type/Var tree for each var in the var list. Must be guarded, as in (declarationStart) => declaration.

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • modifiers

        public final void modifiers()
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        A list of one or more modifier, annotation, or "def".
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeSpec

        public final void typeSpec​(boolean addImagNode)
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • variableDefinitions

        public final void variableDefinitions​(antlr.collections.AST mods,
                                              antlr.collections.AST t)
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        The tail of a declaration. Either v1, v2, ... (with possible initializers) or else m(args){body}. The two arguments are the modifier list (if any) and the declaration head (if any). The declaration head is the variable type, or (for a method) the return type. If it is missing, then the variable type is taken from its initializer (if there is one). Otherwise, the variable type defaults to 'any'. DECIDE: Method return types default to the type of the method body, as an expression.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • genericMethod

        public final void genericMethod()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeParameters

        public final void typeParameters()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • singleDeclarationNoInit

        public final void singleDeclarationNoInit()
                                           throws antlr.RecognitionException,
                                                  antlr.TokenStreamException
        A declaration with one declarator and no initialization, like a parameterDeclaration. Used to parse loops like for (int x in y) (up to the in keyword).
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • singleVariable

        public final void singleVariable​(antlr.collections.AST mods,
                                         antlr.collections.AST t)
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Used in cases where a declaration cannot have commas, or ends with the "in" operator instead of '='.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • singleDeclaration

        public final void singleDeclaration()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        A declaration with one declarator and optional initialization, like a parameterDeclaration. Used to parse declarations used for both binding and effect, in places like argument lists and while statements.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • varInitializer

        public final void varInitializer()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        An assignment operator '=' followed by an expression. (Never empty.)
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • declarationStart

        public final void declarationStart()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Used only as a lookahead predicate, before diving in and parsing a declaration. A declaration can be unambiguously introduced with "def", an annotation or a modifier token like "final". It may also be introduced by a simple identifier whose first character is an uppercase letter, as in {String x}. A declaration can also be introduced with a built in type like 'int' or 'void'. Brackets (array and generic) are allowed, as in {List[] x} or {int[][] y}. Anything else is parsed as a statement of some sort (expression or command).

        (In the absence of explicit method-call parens, we assume a capitalized name is a type name. Yes, this is a little hacky. Alternatives are to complicate the declaration or command syntaxes, or to have the parser query the symbol table. Parse-time queries are evil. And we want both {String x} and {println x}. So we need a syntactic razor-edge to slip between 'println' and 'String'.)

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • modifier

        public final void modifier()
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotation

        public final void annotation()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • upperCaseIdent

        public final void upperCaseIdent()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        An IDENT token whose spelling is required to start with an uppercase letter. In the case of a simple statement {UpperID name} the identifier is taken to be a type name, not a command name.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • builtInType

        public final void builtInType()
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • qualifiedTypeName

        public final void qualifiedTypeName()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArguments

        public final void typeArguments()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • balancedTokens

        public final void balancedTokens()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • genericMethodStart

        public final void genericMethodStart()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        lookahead predicate for usage of generics in methods as parameter for the method. Example: static T foo(){} must be first after the modifier. This rule allows more and does no exact match, but it is only a lookahead, not the real rule.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • constructorStart

        public final void constructorStart()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Used to look ahead for a constructor
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • modifiersOpt

        public final void modifiersOpt()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        A list of zero or more modifiers, annotations, or "def".
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeDefinitionStart

        public final void typeDefinitionStart()
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Used only as a lookahead predicate for nested type definitions.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • classTypeSpec

        public final void classTypeSpec​(boolean addImagNode)
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • builtInTypeSpec

        public final void builtInTypeSpec​(boolean addImagNode)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • classOrInterfaceType

        public final void classOrInterfaceType​(boolean addImagNode)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • declaratorBrackets

        public final void declaratorBrackets​(antlr.collections.AST typ)
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        After some type names, where zero or more empty bracket pairs are allowed. We use ARRAY_DECLARATOR to represent this.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArgumentsDiamond

        public final void typeArgumentsDiamond()
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArgumentSpec

        public final void typeArgumentSpec()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • builtInTypeArraySpec

        public final void builtInTypeArraySpec​(boolean addImagNode)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArgument

        public final void typeArgument()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • wildcardType

        public final void wildcardType()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArgumentBounds

        public final void typeArgumentBounds()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeArgumentsOrParametersEnd

        protected final void typeArgumentsOrParametersEnd()
                                                   throws antlr.RecognitionException,
                                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • type

        public final void type()
                        throws antlr.RecognitionException,
                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • modifiersInternal

        public final void modifiersInternal()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationArguments

        public final void annotationArguments()
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationsInternal

        public final void annotationsInternal()
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationMemberValueInitializer

        public final void annotationMemberValueInitializer()
                                                    throws antlr.RecognitionException,
                                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationMemberValuePairs

        public final void annotationMemberValuePairs()
                                              throws antlr.RecognitionException,
                                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationMemberValuePair

        public final void annotationMemberValuePair()
                                             throws antlr.RecognitionException,
                                                    antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationIdent

        public final void annotationIdent()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • keywordPropertyNames

        public final void keywordPropertyNames()
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • conditionalExpression

        public final void conditionalExpression​(int lc_stmt)
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • superClassClause

        public final void superClassClause()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • implementsClause

        public final void implementsClause()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • classBlock

        public final void classBlock()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • interfaceExtends

        public final void interfaceExtends()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • interfaceBlock

        public final void interfaceBlock()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumBlock

        public final void enumBlock()
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationBlock

        public final void annotationBlock()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeParameter

        public final void typeParameter()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeParameterBounds

        public final void typeParameterBounds()
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • classField

        public final void classField()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • interfaceField

        public final void interfaceField()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • annotationField

        public final void annotationField()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstantsStart

        public final void enumConstantsStart()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Guard for enumConstants.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstants

        public final void enumConstants()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Comma-separated list of one or more enum constant definitions.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstant

        public final void enumConstant()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • argList

        public final void argList()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstantBlock

        public final void enumConstantBlock()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstantField

        public final void enumConstantField()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • enumConstantFieldInternal

        protected final void enumConstantFieldInternal​(antlr.collections.AST mods,
                                                       antlr.collections.AST tp,
                                                       antlr.collections.AST t,
                                                       antlr.Token first)
                                                throws antlr.RecognitionException,
                                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • compoundStatement

        public final void compoundStatement()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • parameterDeclarationList

        public final void parameterDeclarationList()
                                            throws antlr.RecognitionException,
                                                   antlr.TokenStreamException
        A list of zero or more formal parameters. If a parameter is variable length (e.g. String... myArg) it should be to the right of any other parameters of the same kind. General form: (req, ..., opt, ..., [rest], key, ..., [restKeys], [block] This must be sorted out after parsing, since the various declaration forms are impossible to tell apart without backtracking.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • throwsClause

        public final void throwsClause()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • constructorDefinition

        public final void constructorDefinition​(antlr.collections.AST mods)
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        I've split out constructors separately; we could maybe integrate back into variableDefinitions later on if we maybe simplified 'def' to be a type declaration?
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multipleAssignmentDeclarationStart

        public final void multipleAssignmentDeclarationStart()
                                                      throws antlr.RecognitionException,
                                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multipleAssignmentDeclaration

        public final void multipleAssignmentDeclaration()
                                                 throws antlr.RecognitionException,
                                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • constructorBody

        public final void constructorBody()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • explicitConstructorInvocation

        public final void explicitConstructorInvocation()
                                                 throws antlr.RecognitionException,
                                                        antlr.TokenStreamException
        Catch obvious constructor calls, but not the expr.super(...) calls
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • listOfVariables

        public final void listOfVariables​(antlr.collections.AST mods,
                                          antlr.collections.AST t,
                                          antlr.Token first)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • variableDeclarator

        public final void variableDeclarator​(antlr.collections.AST mods,
                                             antlr.collections.AST t,
                                             antlr.Token first)
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Declaration of a variable. This can be a class/instance variable, or a local variable in a method It can also include possible initialization.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • typeNamePairs

        public final void typeNamePairs​(antlr.collections.AST mods,
                                        antlr.Token first)
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multipleAssignment

        public final void multipleAssignment​(int lc_stmt)
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • assignmentExpression

        public final void assignmentExpression​(int lc_stmt)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • nlsWarn

        public final void nlsWarn()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Zero or more insignificant newlines, all gobbled up and thrown away, but a warning message is left for the user, if there was a newline.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • openBlock

        public final void openBlock()
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        An open block is not allowed to have closure arguments.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • variableName

        public final void variableName()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • expressionStatementNoCheck

        public final void expressionStatementNoCheck()
                                              throws antlr.RecognitionException,
                                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • parameterDeclaration

        public final void parameterDeclaration()
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        A formal parameter for a method or closure.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • parameterModifiersOpt

        public final void parameterModifiersOpt()
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multicatch_types

        public final void multicatch_types()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multicatch

        public final void multicatch()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closableBlockParamsOpt

        public final void closableBlockParamsOpt​(boolean addImplicit)
                                          throws antlr.RecognitionException,
                                                 antlr.TokenStreamException
        Closure parameters are exactly like method parameters, except that they are not enclosed in parentheses, but rather are prepended to the front of a block, just after the brace. They are separated from the closure body by a CLOSABLE_BLOCK_OP token '->'.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • implicitParameters

        public final void implicitParameters()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        A block known to be a closure, but which omits its arguments, is given this placeholder. A subsequent pass is responsible for deciding if there is an implicit 'it' parameter, or if the parameter list should be empty.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closableBlockParamsStart

        public final void closableBlockParamsStart()
                                            throws antlr.RecognitionException,
                                                   antlr.TokenStreamException
        Lookahead to check whether a block begins with explicit closure arguments.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closableBlockParam

        public final void closableBlockParam()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Simple names, as in {x|...}, are completely equivalent to {(def x)|...}. Build the right AST.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closableBlock

        public final void closableBlock()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        A block which is known to be a closure, even if it has no apparent arguments. A block inside an expression or after a method call is always assumed to be a closure. Only labeled, unparameterized blocks which occur directly as substatements are kept open.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • openOrClosableBlock

        public final void openOrClosableBlock()
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        A sub-block of a block can be either open or closable. It is closable if and only if there are explicit closure arguments. Compare this to a block which is appended to a method call, which is given closure arguments, even if they are not explicit in the code.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • statementLabelPrefix

        public final void statementLabelPrefix()
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        A labeled statement, consisting of a vanilla identifier followed by a colon.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • expressionStatement

        public final void expressionStatement​(int prevToken)
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        An expression statement can be any general expression.

        An expression statement can also be a command, which is a simple method call in which the outermost parentheses are omitted.

        Certain "suspicious" looking forms are flagged for the user to disambiguate.

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • assignmentLessExpression

        public final void assignmentLessExpression()
                                            throws antlr.RecognitionException,
                                                   antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • compatibleBodyStatement

        public final void compatibleBodyStatement()
                                           throws antlr.RecognitionException,
                                                  antlr.TokenStreamException
        In Java, "if", "while", and "for" statements can take random, non-braced statements as their bodies. Support this practice, even though it isn't very Groovy.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • forStatement

        public final void forStatement()
                                throws antlr.RecognitionException,
                                       antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • strictContextExpression

        public final boolean strictContextExpression​(boolean allowDeclaration)
                                              throws antlr.RecognitionException,
                                                     antlr.TokenStreamException
        Things that can show up as expressions, but only in strict contexts like inside parentheses, argument lists, and list constructors.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • casesGroup

        public final void casesGroup()
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • tryBlock

        public final void tryBlock()
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • branchStatement

        public final void branchStatement()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        In Groovy, return, break, continue, throw, and assert can be used in a parenthesized expression context. Example: println (x || (return)); println assert x, "won't print a false value!" If an optional expression is missing, its value is void (this coerces to null when a value is required).
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closureList

        public final void closureList()
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • forInClause

        public final void forInClause()
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • shiftExpression

        public final void shiftExpression​(int lc_stmt)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • expression

        public final void expression​(int lc_stmt)
                              throws antlr.RecognitionException,
                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • suspiciousExpressionStatementStart

        public final void suspiciousExpressionStatementStart()
                                                      throws antlr.RecognitionException,
                                                             antlr.TokenStreamException
        Lookahead for suspicious statement warnings and errors.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • checkSuspiciousExpressionStatement

        public final void checkSuspiciousExpressionStatement​(int prevToken)
                                                      throws antlr.RecognitionException,
                                                             antlr.TokenStreamException
        If two statements are separated by newline (not SEMI), the second had better not look like the latter half of an expression. If it does, issue a warning.

        Also, if the expression starts with a closure, it needs to have an explicit parameter list, in order to avoid the appearance of a compound statement. This is a hard error.

        These rules are different from Java's "dumb expression" restriction. Unlike Java, Groovy blocks can end with arbitrary (even dumb) expressions, as a consequence of optional 'return' and 'continue' tokens.

        To make the programmer's intention clear, a leading closure must have an explicit parameter list, and must not follow a previous statement separated only by newlines.

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • commandArgumentsGreedy

        public final void commandArgumentsGreedy​(antlr.collections.AST head)
                                          throws antlr.RecognitionException,
                                                 antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • aCase

        public final void aCase()
                         throws antlr.RecognitionException,
                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • caseSList

        public final void caseSList()
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • forInit

        public final void forInit()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • controlExpressionList

        public final void controlExpressionList()
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • forCond

        public final void forCond()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • forIter

        public final void forIter()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • handler

        public final void handler()
                           throws antlr.RecognitionException,
                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • finallyClause

        public final void finallyClause()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • commandArguments

        public final void commandArguments​(antlr.collections.AST head)
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        A member name (x.y) or element name (x[y]) can serve as a command name, which may be followed by a list of arguments. Unlike parenthesized arguments, these must be plain expressions, without labels or spread operators.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • commandArgument

        public final void commandArgument()
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • primaryExpression

        public final void primaryExpression()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • pathElementStart

        public final void pathElementStart()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • pathChain

        public final void pathChain​(int lc_stmt,
                                    antlr.collections.AST prefix)
                             throws antlr.RecognitionException,
                                    antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • argumentLabel

        public final void argumentLabel()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        A label for an argument is of the form a:b, 'a':b, "a":b, (a):b, etc.. The labels in (a:b), ('a':b), and ("a":b) are in all ways equivalent, except that the quotes allow more spellings. Equivalent dynamically computed labels are (('a'):b) and ("${'a'}":b) but not ((a):b) or "$a":b, since the latter cases evaluate (a) as a normal identifier. Bottom line: If you want a truly variable label, use parens and say ((a):b).
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • pathElement

        public final void pathElement​(antlr.collections.AST prefix)
                               throws antlr.RecognitionException,
                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • appendedBlock

        public final void appendedBlock​(antlr.collections.AST callee)
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        An appended block follows any expression. If the expression is not a method call, it is given an empty argument list.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • pathExpression

        public final void pathExpression​(int lc_stmt)
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        A "path expression" is a name or other primary, possibly qualified by various forms of dot, and/or followed by various kinds of brackets. It can be used for value or assigned to, or else further qualified, indexed, or called. It is called a "path" because it looks like a linear path through a data structure. Examples: x.y, x?.y, x*.y, x.@y; x[], x[y], x[y,z]; x(), x(y), x(y,z); x{s}; a.b[n].c(x).d{s} (Compare to a C lvalue, or LeftHandSide in the JLS section 15.26.) General expressions are built up from path expressions, using operators like '+' and '='.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • namePart

        public final void namePart()
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        This is the grammar for what can follow a dot: x.a, x.@a, x.&a, x.'a', etc. Note: typeArguments is handled by the caller of namePart.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • methodCallArgs

        public final void methodCallArgs​(antlr.collections.AST callee)
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        An expression may be followed by one or both of (...) and {...}. Note: If either is (...) or {...} present, it is a method call. The {...} is appended to the argument list, and matches a formal of type Closure. If there is no method member, a property (or field) is used instead, and must itself be callable.

        If the methodCallArgs are absent, it is a property reference. If there is no property, it is treated as a field reference, but never a method reference.

        Arguments in the (...) can be labeled, and the appended block can be labeled also. If there is a mix of unlabeled and labeled arguments, all the labeled arguments must follow the unlabeled arguments, except that the closure (labeled or not) is always a separate final argument. Labeled arguments are collected up and passed as a single argument to a formal of type Map.

        Therefore, f(x,y, a:p, b:q) {s} is equivalent in all ways to f(x,y, [a:p,b:q], {s}). Spread arguments of sequence type count as unlabeled arguments, while spread arguments of map type count as labeled arguments. (This distinction must sometimes be checked dynamically.) A plain unlabeled argument is allowed to match a trailing Map or Closure argument: f(x, a:p) {s} === f(*[ x, [a:p], {s} ])

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • indexPropertyArgs

        public final void indexPropertyArgs​(antlr.collections.AST indexee)
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        An expression may be followed by [...]. Unlike Java, these brackets may contain a general argument list, which is passed to the array element operator, which can make of it what it wants. The brackets may also be empty, as in T[]. This is how Groovy names array types.

        Returned AST is [INDEX_OP, indexee, ELIST].

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • dynamicMemberName

        public final void dynamicMemberName()
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        If a dot is followed by a parenthesized or quoted expression, the member is computed dynamically, and the member selection is done only at runtime. This forces a statically unchecked member access.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • parenthesizedExpression

        public final void parenthesizedExpression()
                                           throws antlr.RecognitionException,
                                                  antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • stringConstructorExpression

        public final void stringConstructorExpression()
                                               throws antlr.RecognitionException,
                                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • logicalOrExpression

        public final void logicalOrExpression​(int lc_stmt)
                                       throws antlr.RecognitionException,
                                              antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • logicalAndExpression

        public final void logicalAndExpression​(int lc_stmt)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • inclusiveOrExpression

        public final void inclusiveOrExpression​(int lc_stmt)
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • exclusiveOrExpression

        public final void exclusiveOrExpression​(int lc_stmt)
                                         throws antlr.RecognitionException,
                                                antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • andExpression

        public final void andExpression​(int lc_stmt)
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • regexExpression

        public final void regexExpression​(int lc_stmt)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • equalityExpression

        public final void equalityExpression​(int lc_stmt)
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • relationalExpression

        public final void relationalExpression​(int lc_stmt)
                                        throws antlr.RecognitionException,
                                               antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • additiveExpression

        public final void additiveExpression​(int lc_stmt)
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • multiplicativeExpression

        public final void multiplicativeExpression​(int lc_stmt)
                                            throws antlr.RecognitionException,
                                                   antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • powerExpressionNotPlusMinus

        public final void powerExpressionNotPlusMinus​(int lc_stmt)
                                               throws antlr.RecognitionException,
                                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • powerExpression

        public final void powerExpression​(int lc_stmt)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • unaryExpression

        public final void unaryExpression​(int lc_stmt)
                                   throws antlr.RecognitionException,
                                          antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • unaryExpressionNotPlusMinus

        public final void unaryExpressionNotPlusMinus​(int lc_stmt)
                                               throws antlr.RecognitionException,
                                                      antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • postfixExpression

        public final void postfixExpression​(int lc_stmt)
                                     throws antlr.RecognitionException,
                                            antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • constant

        public final void constant()
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        Numeric, string, regexp, boolean, or null constant.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • newExpression

        public final void newExpression()
                                 throws antlr.RecognitionException,
                                        antlr.TokenStreamException
        object instantiation. Trees are built as illustrated by the following input/tree pairs: new T() new | T -- ELIST | arg1 -- arg2 -- .. -- argn new int[] new | int -- ARRAY_DECLARATOR new int[] {1,2} new | int -- ARRAY_DECLARATOR -- ARRAY_INIT | EXPR -- EXPR | | 1 2 new int[3] new | int -- ARRAY_DECLARATOR | EXPR | 3 new int[1][2] new | int -- ARRAY_DECLARATOR | ARRAY_DECLARATOR -- EXPR | | EXPR 1 | 2
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • closableBlockConstructorExpression

        public final void closableBlockConstructorExpression()
                                                      throws antlr.RecognitionException,
                                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • listOrMapConstructorExpression

        public final void listOrMapConstructorExpression()
                                                  throws antlr.RecognitionException,
                                                         antlr.TokenStreamException
        A list constructor is a argument list enclosed in square brackets, without labels. Any argument can be decorated with a spread operator (*x), but not a label (a:x). Examples: [], [1], [1,2], [1,*l1,2], [*l1,*l2]. (The l1, l2 must be a sequence or null.)

        A map constructor is an argument list enclosed in square brackets, with labels everywhere, except on spread arguments, which stand for whole maps spliced in. A colon alone between the brackets also forces the expression to be an empty map constructor. Examples: [:], [a:1], [a:1,b:2], [a:1,*:m1,b:2], [*:m1,*:m2] (The m1, m2 must be a map or null.) Values associated with identical keys overwrite from left to right: [a:1,a:2] === [a:2]

        Some malformed constructor expressions are not detected in the parser, but in a post-pass. Bad examples: [1,b:2], [a:1,2], [:1]. (Note that method call arguments, by contrast, can be a mix of keyworded and non-keyworded arguments.)

        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • stringConstructorValuePart

        public final void stringConstructorValuePart()
                                              throws antlr.RecognitionException,
                                                     antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • newArrayDeclarator

        public final void newArrayDeclarator()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • argument

        public final byte argument()
                            throws antlr.RecognitionException,
                                   antlr.TokenStreamException
        A single argument in (...) or [...]. Corresponds to to a method or closure parameter. May be labeled. May be modified by the spread operator '*' ('*:' for keywords).
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • argumentLabelStart

        public final void argumentLabelStart()
                                      throws antlr.RecognitionException,
                                             antlr.TokenStreamException
        For lookahead only. Fast approximate parse of an argumentLabel followed by a colon.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • constantNumber

        public final void constantNumber()
                                  throws antlr.RecognitionException,
                                         antlr.TokenStreamException
        Numeric constant.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • balancedBrackets

        public final void balancedBrackets()
                                    throws antlr.RecognitionException,
                                           antlr.TokenStreamException
        Fast lookahead across balanced brackets of all sorts.
        Throws:
        antlr.RecognitionException
        antlr.TokenStreamException
      • buildTokenTypeASTClassMap

        protected void buildTokenTypeASTClassMap()