有谁知道在 ANTLRWorks 中调试树语法的方法

Question

ANTLR 使用的推荐模式是让解析器构造一个抽象语法树，然后构建树遍历器（又称树语法）来处理它们。

我试图弄清楚为什么我的树语法不起作用，并且希望使用 ANTLRWorks 的调试器，就像我将其用于解析器本身一样。解析器的输入是“源代码”，但树解析器的输入是解析器的 AST 结果。我不知道如何将其作为输入来测试树语法。

目前尚不清楚 ANTLRWorks 中是否有一种方法可以测试树语法。如果可以做到，那么我们将不胜感激指向正确方向的指针。

Answer 1

有一种使用 AntlrWorks 的方法：

1. 在 AntlrWorks 中编写语法
2. 生成其代码（这与从命令行运行 Antlr 相同，无需调试）
3. 自己编写一个类似于 使用 AntlrWorks 进行调试常见问题解答
4. 编写树语法
5. 选择调试 Antlrworks（这与从运行 Antlr 相同）带有调试标志的命令
6. 行运行存根程序，直到连接到 antlrworks，因此您可以调试树语法
7. 返回打开树语法的 antlrworks，然后调试远程
8. 解决问题...:)

Answer 2

如果您确定正在构建的 AST 没问题（使用 ANTLRWORKS 调试器），则树遍历测试与测试任何其他应用程序没有什么不同。例如，如果您要发出 Java 代码，请使用 Eclipse 的调试器来测试它，或者使用纯日志消息...

Answer 3

ANTLRWorks 调试器应该可以很好地配合您的树语法。如果我没记错的话，您需要使用带有“-debug”标志的 ANTLR 代码生成工具（我使用的是 Java 目标），然后，在创建树解析器实例的位置，使用将端口作为一个论点。就我而言，默认端口不起作用，所以我任意选择了 35505。

启动 ANTLRWorks，打开树语法，单击“运行”->“调试远程...”，将端口设置为使用的相同值在树解析器的构造函数中，您应该能够将调试器连接到正在运行的应用程序。有关详细信息，请参阅 ANTLR 3 调试常见问题解答。

[更新] 假设您使用的是 Java 目标（如果情况并非如此，请告诉我们），以下是有关入门的更多详细信息：

当您在 ANTLRWorks 中测试非树解析器时，有一个后台进程可以从您的语法文件生成 Java 代码，然后使用该代码来解析您的输入。当您在自己的应用程序中使用解析器时，必须使用 ANTLR（具体来说，org.antlr.Tool 类）来生成 Java 代码，然后将其包含在您的应用程序中。 ANTLRWorks 有一个菜单选项，可以帮助您入门。就我而言，我的 ant 构建文件中有一个目标，该目标根据我的语法生成 Java 代码，并将这些 Java 源文件放在应用程序的其余部分可以找到它们的位置。我的 ant 目标看起来像这样：

<java classpath="${antlr.tool.classpath}" classname="org.antlr.Tool" failonerror="true">
    <arg value="-o" />
    <arg value="${antlr.out.dir}" />
    <arg value="${grammar.dir}/GrammarName.g" />
</java>

属性 antlr.tool.classpath 需要包含 stringtemplate.jar 和 antlr.jar，以及 antlr.out.dir 需要指向您希望生成的源代码所在的目录（例如，build/antlr/src/org/myorg/antlr/parser，如果您的解析器语法指定包org.myorg.antlr.parser）。

然后，当您编译应用程序的其余部分时，您可以使用类似的内容：

<javac destdir="${build.classes.dir}" debug="on" optimize="on" deprecation="${javac.deprecation}" source="${javac.source}" target="${javac.target}">
    <classpath refid="stdclasspath"/>
    <src path="${src.dir}" />
    <src path="${antlr.src.dir}" />
</javac>

在这里，我们编译应用程序源（在 src.dir 中）以及生成的 ANTLR 代码（在 antlr.dir 中）。 src.dir，在此示例中为 build/antlr/src）。

至于在应用程序中使用生成的代码（即在 ANTLRWorks 之外），您需要执行以下操作：

String sourceText = "a + b = foo";
ANTLRStringStream inStream = new ANTLRStringStream(sourceText);

// your generated lexer class
MyLexer lexer = new MyLexer(inStream);
CommonTokenStream tokens = new CommonTokenStream(lexer);

// your generated parser class
MyParser parser = new MyParser(tokens);

// run the toplevel rule (in this case, `program`)
MyParser.program_return prog = parser.program();

// get the resulting AST (a CommonTree instance, in this case)
CommonTree tree = (CommonTree) prog.getTree();

// run a tree parser rule on the AST
MyTreeParser treeParser = new MyTreeParser(new CommonTreeNodeStream(tree));
treeParser.program();

我强烈建议获取 权威 ANTLR 参考（如果您要使用 ANTLR）。所有这些内容都非常全面地涵盖，并提供了大量示例来帮助您入门。