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

Text Formatting

Text Formatting(文本格式化)可以快速的将源代码按照预定的规则排版,JTF 只是定义了这个框架,将其发挥到极致的是 JDT。打开 Eclipse 的设置页,找到 General->Java->Code Style->Formatter,你会发现在这里可以编辑名目繁多的格式化选项。JDT 提供的代码格式化功能强大的令人眩目,但本文的目的是介绍这个强大功能下的基础设施。

IFormattingStrategy

IFormattingStrategy(格式化策略)是格式化真正完成的地方,它代表一种格式化的方式。格式化策略是和文本类型相关联的,所以可以为每一种文本类型创建一个格式化策略,这是 JTF 的一个基本做法,你还能回忆起还有哪些功能是和文本类型绑定在一起的吗?这个接口有一个扩展接口 IFormattingStrategyExtension,它引入了 Formatting Context(格式化上下文)的概念,下面会有介绍。

IContentFormatter

IContentFormatter 是最基本的接口,它代表了一个格式化器。既然实际的格式化工作应该放到 IFormattingStrategy 中,那 IContentFormatter 做什么呢?可以说,它基本上相当于一个调度器,它会决定要格式化的内容具有什么样的文本类型,然后调用不同的 IFormattingStrategy 实现。不过,这只是推荐行为,你可以在 IContentFormatter 的实现里做任何事,但是不推荐刻意超越这个架构的约束。JTF有这个接口的缺省实现:ContentFormatter,一般我们直接使用它就可以了。

IFormattingContext

IFormattingContext 为格式化提供附加信息,它采用键值对的方式保存信息,所以你可以存任何格式化需要知道的东西。不过这是一个相对较新的接口,从 Eclipse 3.0 开始才出现,你实现了 IFormattingStrategyExtension 才需要用到它。记住,不要忘了查查是否每个接口都有扩展接口,也许你会有很多新的发现,因为 JTF 中到处都是,或者说 Eclipse 中到处都是扩展接口。

实现文本格式化

实现 IFormattingStrategy

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

配置

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

快捷键处理

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

时间: 2024-08-31 16:23:12

基于JFace Text Framework构建全功能代码编辑器: 第10部分的相关文章

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

引言 JFace Text Framework(JFace 文本框架,后面直接简称为 JTF)是 Eclipse 中重要的框架,是其它开发工具的基石之一,比如 JDT (Java Development Tool) 中的 Java 源代码编辑器就是基于它开发的.相信用过 JDT 的人都会对它的源代码编辑器有深刻印象,因为它的很多功能可以让我们很方便的编辑 Java 源代码,比如语法高亮和内容提示等等.所有这些功能都是在 JTF 架的基础上实现的,所以学会使用这个框架对于开发某种语言的编辑工具是至

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

Text Hover和Annotation Hover Text Hover Text Hover(文本悬浮)可以让用户快速的得到某种信息,而不用打开相对缓慢的 Eclipse 帮助系统.Eclipse 的 Java 编辑器使用了文本悬浮来显示 Javadoc 帮助,极大的方便了程序员.从功能上看,文本悬浮可以认为是一种增强型的 Tooltip,因为它支持显示更多的内容,并且可以显示成各种样子. 文本悬浮看起来很酷,但是原理却很简单.基本上就是三个步骤: 根据鼠标位置得到字符偏移 根据字符偏移得

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

Text Decoration Text Decoration 对于代码编辑器来说,Text Decoration(文本装饰)是一个必需的功能.我们先来看看 Java 编辑器中对文本装饰的应用: 图1. Java 编辑器中的文本装饰 可以看到 Java 编辑器会把错误的部分用一个红色的波浪线标记出来,还可以看到对于模版来说,模版参数周围有一个小矩形,而且在左边还有相应的错误图标显示.这些都叫做文本装饰. 提示:模版会在以后的文章中进行介绍 我们在编辑代码的时候,出错是不可避免的,因此有了文本装饰

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

Content Assistant Content Assistant Content Assistant(内容提示)可以帮助程序员快速的完成代码,并且还有代码自动补全的附加功能.这对于一个代码编辑器来说是至关重要的,也是不少人喜欢用 IDE 编写代码的原因之一.但是这个功能背后却不是那么简单的,我们先来了解一下 JTF 中和 Content Assistant 相关的概念,下面是 Eclipse 中 Java 编辑器的内容提示的样子: 图1. Java 编辑器的内容提示 先来介绍一下图 1 中

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

Hyperlink Hyperlink(超链接)在 Java 编辑器中用来进行快速的代码定位,当你按住 Ctrl 键并把鼠标指向一个函数名的时候,函数名会显示为超链接,点击之后代码会跳转到函数的声明处.这个功能使得 Eclipse 浏览代码很方便,这次我就来介绍如何在自己的编辑器中添加超链接功能. 超链接的定位 编辑器不会知道哪块区域应该显示为超链接,这是通过 IHyperlinkDetector 接口实现的.这里牵涉到语义方面的内容,因为你必须要能知道鼠标下面到底是个什么.在解析器那一层需要实

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

Quick Assistant Quick Assistant(快速帮助)的基本用途是为源代码中的错误提供一些快速的解决方案.快速的意思是指这个方案足够简单或者足够模式化,可以由程序帮你自动完成.当然快速帮助是无法解决深层次的问题的,不过一般我们在编写代码的时候,犯的最多的都是一些小错误,所以快速帮助是个非常有用的功能. 在 Java 编辑器中,快速帮助看上去就是下图的样子: 图1. Java 编辑器中的快速帮助 可见,不管是从名字上,还是界面上,快速帮助都非常类似我提过的 Content As

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

Template Template(模版)可以用来快速添加某种固定形式的代码,中间还可以插入参数.对于 Java 编辑器来说,你可以在 Eclipse 的设置中找到相应的属性页,路径是 General->Java->Editor->Templates.这个属性页是Eclipse标准的模版属性页,因为它做的比较完善,所以一般不需要自己写一个. 仔细探索一下这个属性页,尝试编辑一下模版,你可能会发现很多不了解的概念,下面我会一一解释 模版属性 模版包含一些基本属性: Name(名称):这个模

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

Text Folding Text Folding(文本折叠)其实在 Eclipse 2.1 的时候就已经出现了苗头,在 Eclipse 3.0 之后,文本折叠的架构被重新设计了,开始逐渐变的实用.我们先来了解一下JTF为了文本折叠做了哪些工作. ProjectionViewer SourceViewer 本身不支持文本折叠,所以 JTF 添加了一个 ProjectionViewer 专门支持文本折叠,它是 SourceViewer 的子类. 主从文档结构 JTF 是不可能神奇的知道哪些文本是可

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

Syntax Highlight Syntax Highlight(语法高亮)是指把文本的不同内容用不同的颜色,字体等渲染,通过这种方式,用户可以快速发现某种内容,可以在短时间内对全文的结构有一个大概的了解.本文探讨如何在 JTF 中实现语法高亮. 前提 语法高亮是把一段文本中的不同内容使用不同的样式来渲染的功能,如下图所示: 图1. Java编辑器的语法高亮 图 1 中的 Java 源代码的不同部分被 Java 编辑器渲染成了不同颜色.比如关键字是偏红的,并且是粗体:变量是蓝色,注释是绿色等等