安装ANTLR

作者的电脑是MAC的操作系统macOS Catalina 10.15.2。

安装步骤后linux操作的系统的一样， Windows系统大致步骤一样，但是环境变量等配置有差别，作者很久没使用过win系统，只能基于MAC的系统介绍了。

环境准备

ANLTR是用JAVA编写的，需要先安装好JAVA，需要的JAVA版本是1.6以上。相信看这篇文章的各位同学电脑上应该都有安装JAVA。😊

下载ANTLR

使用ANTLR的功能其实很简单， 下载一个ANTLR的jar包即可。
官方下载地址

配置

最后一步配置环境变量，方便后面在命令行操作ANTLR
打开环境变量文件，作者安装的是zsh，所以编辑~/.zshrc文件，各位同学应该也清楚环境变量的配置，在文件加入几行：

export CLASSPATH=".:/usr/local/lib/antlr-4.7.1-complete.jar:$CLASSPATH"  #设置antlr的jar包到环境变量
alias antlr4='java -Xmx500M -cp "/usr/local/lib/antlr-4.7.1-complete.jar:$CLASSPATH" org.antlr.v4.Tool'  #快速运行ANTLR的解释器
alias grun='java -Xmx500M -cp "/usr/local/lib/antlr-4.7.1-complete.jar:$CLASSPATH" org.antlr.v4.gui.TestRig' #快速运行ANTLR测试工具

完成上面的准备工作就可以开始体验ANTLR的强大功能了

第一个语法解释器

下面用一个简单的例子展示ANTLR的使用，编译一个最简单的赋值语句的语法。

编写g4文件

新建一个Hello.g4的文件，这个文件是针对语法的描述，相当于告诉ANTLR我的语法规范

Hello.g4内容如下：

 grammar Hello;  //定义一个名为 Hello 的语法
 statement: ID '=' NUM; //匹配类似 a=1 age=100 这样的语句
 ID: [a-z]+;   // 定义了一个词法 ID，由小写字母组成
 NUM:[0-9]+; // 定义了一个词法 NUM，由数字组成
 WS: [ \t\r\n]+ -> skip;  //在进行解析的过程中，忽略掉空格，换行

这样其实就定义好了一个简单语法。
对于不同的程序语言来说，语法结构越是复杂，想对应的g4文件也会越复杂
这个项目里面有针对目前流行的语言的ANTLR语法定义文件
各位同学可以找找接触过哪些，看看你用的语言复杂不复杂。反正JAVA文件是很复杂💔

生成解释器

生成ANTLR的解释器很简单，一条命令搞定。

antlr4 Hello.g4

运行完这条命令会生成如下几个文件：

Hello.interp
Hello.tokens
HelloBaseListener.java
HelloLexer.interp
HelloLexer.java
HelloLexer.tokens
HelloListener.java
HelloParser.java

• HelloParser.java

  该文件包含一个语法解释器类的定义，负责识别我们定义的语法

public class HelloParser extends Parser { ... }

• HelloLexer.java

  该文件包含一个词法解释器类的定义，负责自动识别我们定义的语法中的文法规则和词法规则。

public class HelloLexer extends Lexer { ... }

• HelloListener.java和HelloBaseListener.java

  这两个类都是事件监听类，是留给开发者自己来定义相应的事件。因为ANTLR在进行遍历解析时，遍历器会触发一系列的事件。 比如进入某某标签，读到一个数字等。ANTLR开放了这些接口，开发者通过实现这些事件可以做到除了解释语法以外更复杂的功能。这里就不详细解释，后面会再介绍。先挖个坑😊

public interface HelloListener extends ParseTreeListener {
    /**
     * Enter a parse tree produced by {@link HelloParser#statement}.
     * @param ctx the parse tree
     */
    void enterStatement(HelloParser.StatementContext ctx);
    /**
     * Exit a parse tree produced by {@link HelloParser#statement}.
     * @param ctx the parse tree
     */
    void exitStatement(HelloParser.StatementContext ctx);
}

• 其他非java文件

  ANTLR会给每个定义的词法符号指定一个数字形式的类型，然后将对应关系存储在这些文件中。当不同的语法有相同的词时这个文件就有大作用了。

测试解释器

最后到了验收结果的时候，测试一下ANTLR的语法解释器做了什么。下面会展示两种测试方式。

JAVA代码

1. 将前面生成的4个JAVA文件添加到一个测试工程内，该工程需要引入ANTLR依赖。

<dependency>
    <groupId>org.antlr</groupId>
    <artifactId>antlr4</artifactId>
    <version>4.7.1</version>
</dependency>

2. 编写相关测试代码

public static void main(String[] args) {
        HelloLexer lexer = new HelloLexer(CharStreams.fromString("a = 1"));
        CommonTokenStream tokenStream = new CommonTokenStream(lexer);
        HelloParser parser = new HelloParser(tokenStream);
        System.out.println(parser.statement().toStringTree(parser));
    }

3. 运行后会有如下输入：
   (statement a = 1)
   这个代码ANTLR成功识别到了我们的赋值语句。

命令行

ANTLR也提供了自动的测试工具，可以直接在命令行测试。详细用法如下

1. 编译java代码，就跟一般的java代码一样我们需要同javac把java文件编译成class文件。

javac *.java

2. 使用ANTLR测试工具，输入如下命令

grun Hello statement -gui

Hello 对应我们定义的语法 grammar Hello
statement 对应我们定义的词法 statement: ID '=' NUM;
-gui 表示输出图形界面

3. 进入测试工具后，输入a = 1。 MAC电脑结束输入符号 control+D。

$ grun Hello statement -gui                                 
a = 1
^D

ANTLR会输出图形界面

截屏2020-04-0219.18.24.png

可以看到ANTLR最终解释出来的语法树。

总结

这篇文章带大家完成了第一个ANTLR的语法文件，并展示了测试过程。中间有一些细节没有在这里仔细讲解，在后面的笔记会陆续更新。最后附上一个稍微复杂一点的语法树的图。

antlr4_parse_tree.png