看懂Gradle脚本（3）- Groovy AST转换

## 延续上一篇文章

[上篇文章](http://blog.csdn.net/zxhoo/article/details/29601675)末尾有一段脚本，定义了一个 Task：

```java
task 'myTask' {  
    doLast {  
        println 'hello world!'  
    }  
}
```

我们已经知道，这段脚本其实是调用 [Project](http://www.gradle.org/docs/current/groovydoc/org/gradle/api/Project.html) 的 [task](http://www.gradle.org/docs/current/groovydoc/org/gradle/api/Project.html#task%28java.lang.String,%20groovy.lang.Closure%29) 方法，并且传入两个参数：一个是 Task 的名字，另外一个是闭包，用来配置 Task（在这段脚本中，给 Task 添加了一个 Action）。

## Task 名的引号去哪儿了？

但是 [Gradle 官方](http://www.gradle.org/docs/current/dsl/org.gradle.api.Task.html)推荐的写法，是像下面这样定义 Task：

```java
task myTask { // <--
    doLast {  
        println 'hello world!'  
    }  
}
```

那么这个语法怎么解释呢？

## 用 GroovyConsole 观察 AST

所谓 **AST** ，就是[抽象语法树](http://en.wikipedia.org/wiki/Abstract_syntax_tree)，简单的说，就是编译器分析完代码之后，生成的一个树形数据结构。我们用 [Groovy](https://so.csdn.net/so/search?q=Groovy&spm=1001.2101.3001.7020) 自带的 [GroovyConsole](http://groovy.codehaus.org/Groovy+Console) 就可以观察 AST。打开 GroovyConsole，把脚本复制到编辑器中，然后按 **ctrl+t** 就可以看到 AST，如下图所示：

![](/media/202206/2022-06-13_2252420.6741715634523952.png)

可以看出来，上面的脚本会被编译器解释成下面这样：

```java
task(myTask({ 
    doLast({ 
        println('hello world!')
    })
}))
```

也就是说，先调用 myTask 方法，然后再把返回结果当成参数，调用 task 方法。那么到底是不是这样呢？

## AST 转换

没有定义过myTask方法？这个好说，因为Groovy提供了强大的元编程机制，比如methodMissing方法，可以做到这一点。那么到底是不是这样呢？一番搜索之后，我认为我找到了正确答案：Gradle是利用AST转换来实现这种特殊语法的。为了给出确凿的证据，我找出了相关的Gradle源代码。最主要的两个类是org.gradle.groovy.scripts.internal.TaskDefinitionScriptTransformer 和org.gradle.groovy.scripts.internal.AstUtils。下面列出TaskDefinitionScriptTransformer的transformVariableExpression方法以供参考：

```
private void transformVariableExpression(MethodCallExpression call, int index) {
            ArgumentListExpression args = (ArgumentListExpression) call.getArguments();
            VariableExpression arg = (VariableExpression) args.getExpression(index);
            if (!isDynamicVar(arg)) {
                return;
            }
 
            // Matches: task args?, <identifier>, args? or task(args?, <identifier>, args?)
            // Map to: task(args?, '<identifier>', args?)
            String taskName = arg.getText();
            call.setMethod(new ConstantExpression("task"));
            args.getExpressions().set(index, new ConstantExpression(taskName));
        }
```

## 结论

Gradle 是通过 **AST 转换**来实现 task 定义特殊语法的，下面这三行代码完全等价：

```java
task myTask {...}
task 'myTask' {...}
task('myTask', {...})
```