基于JFace Text Framework构建全功能代码编辑器: 第7部分

Quick Assistant

Quick Assistant（快速帮助）的基本用途是为源代码中的错误提供一些快速的解决方案。快速的意思是指这个方案足够简单或者足够模式化，可以由程序帮你自动完成。当然快速帮助是无法解决深层次的问题的，不过一般我们在编写代码的时候，犯的最多的都是一些小错误，所以快速帮助是个非常有用的功能。

在 Java 编辑器中，快速帮助看上去就是下图的样子：

图1. Java 编辑器中的快速帮助

可见，不管是从名字上，还是界面上，快速帮助都非常类似我提过的 Content Assistant（内容提示）功能。实际上，它们的架构和实现方式也差不多。

快速帮助是基于 Annotation（标注）的，我们已经在本系列第五部分中介绍了如何创建一个标注并显示出来。标注包含一个类型信息，比如错误或者警告或者只是提示。快速帮助的基本想法就是判断光标所在位置有没有标注，如果有则检查标注的类型，如果是你感兴趣的类型，比如错误，则触发快速帮助。

由于其和内容提示的相似性，我就不废话了，让我们直接看看如何实现快速帮助吧。

实现快速帮助

在目前的例子里，我已经把语法错误显示出来了。因为快速帮助可以针对标注类型来触发，所以我打算增加一种错误类型：Undelcared Variable（未声明的变量），比如在下面的例子中：

清单1. 错误的语法，变量 b 未声明

a　=　3;
a　=　b;

a 被赋值了两次，第一次是用常量，第二次是把变量b的值赋给变量a。如果根据目前的解析器文法来说，这段代码的语法没有问题，但是语义有问题，因为 b 没有声明过。

对于这种新的错误类型，我会认为用户也许是敲错了变量名，所以会显示出声明过的变量名列表，如果用户选择了一个，则未声明的变量被替换成声明过的变量。对于原来的错误，我不提供快速帮助，这样大家就可以看出差别了。

实现底层支持

要增加错误类型，又需要修改解析器文法，我已经完成这部分，所有未声明的变量都被保存到了一个列表里面。同样，又增强了 SharedParser 以便得到这些未声明的变量。