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

核心提示： 实现文本格式化实现 IFormattingStrategy首先我使用 ExprFormattingStrategy 实现 IFormattingStrategy 接口，我没有实现 IFormattingStrategyExtension，基于 JFace Text Framework 构建全功能

实现文本格式化

实现 IFormattingStrategy

首先我使用 ExprFormattingStrategy 实现 IFormattingStrategy 接口，我没有实现 IFormattingStrategyExtension，因为例子中的语言太简单了，我不需要多少上下文信息就可以做格式化工作。另外一个原因是：文本格式化的算法因不同的情况而已，且和和 JTF 的架构关系不大，没有必要进行详细的演示。我的格式化方式很简单：每个符号之间会有空格分隔（除了分号），且每行只允许写一条语句。

配置

修改 ExprConfiguration，覆盖 getContentFormatter 方法。我使用缺省实现，并用 setFormattingStrategy 方法注册 ExprFormattingStrategy。出于简单至上的原则，我没有实现 IContentFormatter，如果你的软件需求必须要实现 IContentFormatter，请不要犹豫。

快捷键处理

和内容提示，快速帮助一样，需要一个快捷键来触发文本格式化。普通的文本编辑器并没有格式化的功能，如果我需要使用格式化的命令ID，需要依赖 org.eclipse.jdt.ui 插件，我不太想这样做。当然对我这个例子来说，这无所谓，但如果是正在开发一个真正的产品，我想你也不希望为了使用一个常量就把整个 JDT 都包含进来，所以我通过扩展定义了一个格式化命令，并绑定到 Ctrl+Shift+F。然后，仿照快速帮助时的做法，在 ExprViewer 的 createHandlers 方法中添加一个 handler。

效果

尝试输入一些混乱的代码，全选后然后按下 Ctrl+Shift+F，你会得到如下的对比：

图1. 格式化之前

图2. 格式化之后

结束语

本文介绍的是JTF中文本格式化的基本概念和实现方式，下面是对这一章内容的进一步思考：

ExprFormattingStrategy 太简单了，format 方法的后面三个参数都没怎么用到。看看它们到底是什么意思，想想如何使用它们

我没有实现 IFormattingStrategyExtension，这样得不到很多信息。IFormattingStrategy 的 format 方法参数虽然不少，但是携带的信息还是太有限了。因此在实际的应用中，推荐实现 IFormattingStrategyExtension 以便能使用 IFormattingContext。

格式化会牵涉到很多的文本操作，不妨尝试使用 Eclipse 自带的一些工具。在 org.eclipse.text 插件中，封装了不少类型的文本操作，看看 TextEdit 和它的子类，相信你会有收获。不光是格式化，任何需要操作文档的功能都可以使用。

格式化的重头戏是格式化算法，但是它不在本系列的范畴之内。不过我要再提醒你，要把格式化做到 JDT 那样的水准，重要的是需要一个强大的解析器支持。

这些不足的地方留给有兴趣的读者。

本文示例源代码或素材下载