antlr入门指南

总体流程

下载antlr代码生成器

antlr java下载地址
https://github.com/antlr/antlr4/blob/master/doc/java-target.md

https://www.antlr.org/download/antlr-4.13.2-complete.jar

写g4文件

// 语法名称 grammar JSON; // 解析器规则 (小写开头) // 1. 入口规则：匹配任何合法的 JSON 值 json : value ; // 2. 定义 JSON 的值类型 value : STRING # StringLiteral // 字符串 | NUMBER # NumberLiteral // 数字 | obj # JsonObject // 对象 | arr # JsonArray // 数组 | 'true' # TrueLiteral // 布尔值 true | 'false' # FalseLiteral // 布尔值 false | 'null' # NullLiteral // null 值 ; // 3. 定义 JSON 对象结构 { key: value, ... } obj : '{' pair (',' pair)* '}' | '{' '}' // 空对象 ; // 4. 定义键值对结构 pair : STRING ':' value ; // 5. 定义数组结构 [ value, value, ... ] arr : '[' value (',' value)* ']' | '[' ']' // 空数组 ; // 6. 词法分析规则 (大写开头) // 字符串：双引号包围，支持转义字符 STRING : '"' (ESC | ~["\\])* '"' ; // 数字：支持负数、小数、科学计数法 NUMBER : '-'? INT ('.' [0-9]+)? EXP? ; // 跳过空白字符 (空格, 换行, 制表符) WS : [ \t\n\r]+ -> skip ; // 片段规则 (仅供其他词法规则使用，不会单独匹配) // 转义字符处理 fragment ESC : '\\' ["\\/bfnrt] | UNICODE_ESCAPE ; // Unicode 转义 fragment UNICODE_ESCAPE : '\\' 'u' HEX HEX HEX HEX ; // 十六进制字符 fragment HEX : [0-9a-fA-F] ; // 整数部分 fragment INT : '0' | [1-9] [0-9]* ; // 科学计数法 fragment EXP : [Ee] [+-]? [0-9]+ ;

执行命令

java -jar .\antlr-4.13.2-complete.jar -visitor json.g4

然后将获得的java文件拷贝到源代码相应的包中。

添加maven依赖

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

写编译代码

packagecn.edu.ncepu.antlr;importorg.antlr.v4.runtime.*;importorg.antlr.v4.runtime.tree.ParseTree;importjava.io.IOException;importjava.nio.file.Paths;importjava.util.List;/** * 测试 * 2026-03-02 * * @author 醒过来摸鱼 */publicclassMain{publicstaticvoidmain(String[]args)throwsIOException{CharStreaminput=CharStreams.fromPath(Paths.get("antlr-learn/test.json"));JSONLexerlexEngine=newJSONLexer(input);CommonTokenStreamtokens=newCommonTokenStream(lexEngine);JSONParserjsonParser=newJSONParser(tokens);JSONParser.JsonContextjson=jsonParser.json();System.out.println(print(json.value()));}privatestaticStringprint(ParserRuleContextjson){if(jsoninstanceofJSONParser.StringLiteralContextstring){returnstring.STRING().toString();}if(jsoninstanceofJSONParser.JsonArrayContextjsonArrayContext){returnprint(jsonArrayContext.arr());}if(jsoninstanceofJSONParser.JsonObjectContextjsonObjectContext){returnprint(jsonObjectContext.obj());}if(jsoninstanceofJSONParser.PairContextpairContext){returnpairContext.STRING()+"="+print(pairContext.value());}if(jsoninstanceofJSONParser.ArrContextarrContext){List<JSONParser.ValueContext>value=arrContext.value();StringBuilderbuilder=newStringBuilder("{");booleanfirst=true;for(JSONParser.ValueContextvalueContext:value){Stringprint=print(valueContext);if(print!=null&&!print.isBlank()){if(first){first=false;}else{builder.append(",");}builder.append(print);}}builder.append("}");returnbuilder.toString();}StringBuilderbuilder=newStringBuilder("(");booleanfirst=true;for(inti=0;i<json.getChildCount();i++){ParseTreechild=json.getChild(i);if(childinstanceofParserRuleContextcontext){Stringprint=print(context);if(print!=null&&!print.isBlank()){if(first){first=false;}else{builder.append(",");}builder.append(print);}}}builder.append(")");returnbuilder.toString();}}

测试

我使用的测试数据如下：

{"name":"John","friends":["Tom","Lily"]}

测试结果：

("name"="John","friends"={"Tom","Lily"})