Antlr4 环境配置

本文使用IDE为 eclipse Mars 4.5.0 

1.新建Maven项目 

建立.g4文件存放位置，及配置g4编译后生成的输出目录位置。

在插件安装完毕后选择 Preference -> antlr-> tool -> option -> directory 来配置所生成的输出文件位置。

2.下载相关Jar包

打开项目的POM文件并添加Antlr的依赖，我使用的版本是4.5.3，保存后下载完依赖。

		<dependency>
			<groupId>org.antlr</groupId>
			<artifactId>antlr4-runtime</artifactId>
			<version>4.5.3</version>
		</dependency>

如果要选择其它的版本，可在 http://mvnrepository.com/artifact/org.antlr 这里查询。

3. 下载插件Antlr4ide

通过使用该插件可以使Antlr的使用更加便捷。这个插件的介绍在https://github.com/jknack/antlr4ide。

下载方法为 在eclipse 打开菜单help->eclipse marketplace ，输入antlr4,下载即可。

4.下载xtext 2.7.3

由于第三步中下载的插件要依赖xtext，否则打开.g4文件会报错。但在eclipse marketplace中下载的xtext 2.9.x 版本，仍会出现报错现象，是插件无法使用。

经查询，xtext 2.7.3 安装后能使插件正常使用。

• 下载xtext2.7.3 地址为http://download.csdn.net/detail/revivedsun/9511460 或  http://www.eclipse.org/modeling/download.php?file=/modeling/tmf/xtext/downloads/drops/2.7.3/R201411190455/tmf-xtext-Update-2.7.3.zip
• Eclipse -> Help -> Install new Software...
• Add... -> Archive -> 选择下载的xtext 2.7.3 压缩包
• continue installing 
• 重启ecplise -> 使用

https://github.com/jknack/antlr4ide 有关于插件的使用说明，以及常见问题说明

经过上述步骤，可以开始使用Antlr了。

建立gm.g4文件。

grammar gm;
str : WORD;
WORD : [0-9]+;

通过插件可以查看生成的状态图。

在.g4 文件点击右键，生成parser与lexer 的java文件。

随后可以使用生成的文件完成词法与语法分析的任务，如下为例。

public class Main {

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		ANTLRInputStream in = new ANTLRInputStream("12345");
		gmLexer lexer = new gmLexer(in);
		List<Token> list = (List<Token>) lexer.getAllTokens();
		for(Token token : list){
			System.out.println(token.getText());
		}
	}
}