The AstBuilder provides several ways to build an abstract syntax tree (AST) of Groovy code. You can convert a String into AST using the buildFromString method. You can convert code into AST using the buildFromCode method. You can use the AST DSL with the buildFromSpec method. For more information, see the resources on the Groovy wiki pages.
| Type Params | Return Type | Name and description |
|---|---|---|
|
List<ASTNode> |
buildFromCode(CompilePhase ignoredPhase = CompilePhase.CLASS_GENERATION, boolean ignoredStatementsOnly = true, Closure ignoredBlock)Builds AST based on the code within the Closure parameter. |
|
List<ASTNode> |
buildFromSpec(Closure specification)Builds AST based on the DSL data within the Closure parameter. |
|
List<ASTNode> |
buildFromString(CompilePhase phase = CompilePhase.CLASS_GENERATION, boolean statementsOnly = true, String source)Builds AST based on the code within the String parameter. |
Builds AST based on the code within the Closure parameter.
This method must be invoked at compile time and never at runtime, because
an ASTTransformation must be run to support it. If you receive an IllegalStateException then
you most likely need to add stronger typing. For instance, this will not work:
def builder = new AstBuilder()
builder.buildFromCode {
// some code
}
While this code will:
new AstBuilder().buildFromCode {
// some code
}
The compiler rewrites buildFromCode invocations into AstBuilder.buildFromString
invocations. An exception raised during AST generation will show a stack trace from AstBuilder.buildFromString
and not from AstBuilder.buildFromCode .
The compiler saves the source code of the closure as a String within the Java class file. The String source
of the closure will be visible and un-obfuscated within the class file. If your Closure parameter contains
sensitive data such as a hard-coded password then that data is free to be seen by anyone with the class file.
Do not store sensitive data within the closure parameter.
phase
- the CompilePhase the AST will be targeted towards. Default is CompilePhase.CLASS_GENERATIONstatementsOnly
- when true, only the script statements are returned. WHen false, you will
receive back a Script class node also. Default is true.block
- the code that will be convertedBuilds AST based on the DSL data within the Closure parameter.
specification
- the contents to createBuilds AST based on the code within the String parameter.
phase
- the CompilePhase the AST will be targeted towards. Default is CompilePhase.CLASS_GENERATIONstatementsOnly
- when true, only the script statements are returned. WHen false, you will
receive back a Script class node also. Default is true.source
- The source code String that will be compiled.