NetBeans IDE 6.0 中的源代码编辑
由
NetBeans 中文社区的
翻译(2008
年 2 月)
本教程演示了用新的经过改进的 NetBeans IDE 6.0 编辑器创建和编辑 Java 源代码的过程。
目录
注意: 点击每个视频中部的箭头按钮开始播放。每个视频包含了标识重要过程和概念的屏幕文本,当出现屏幕文本时视频将暂停播放。 要恢复播放,只要点击显示在视频屏幕上的文本或者使用视频下方的控制器。
本教程所必需的软件
在开始之前,您需要在您的电脑上安装以下软件:
- NetBeans IDE 6.0(下载)
- Java标准开发套件 (JDK) 5.0 版或 6.0 版(下载)。
使用代码补全和代码生成
在这一节,我们将来看看 Java 编辑器中能使您更高效地编写代码的新特性。这些特性包括代码补全和代码生成对话框,管理 import 语句,还有使用高级工具的行操纵和代码块选择。
使用代码补全生成代码
一般来说,代码补全对于自动填充缺失的代码是有帮助的,例如标识符和关键字。截至 NetBeans IDE 6.0,您现在甚至可以用代码补全来生成整个方法。例如,您想生成一个构造器,覆盖方法,或者实现方法,代码补全是很有用的。稍后,我们也将来看看 NetBeans 6.0 代码补全的其它一些有趣的特性,例如使用代码生成对话框生成任意的构造器。
首先我们来看看一个表示电子邮件的 JavaBean 的编写。包含了用来存储数据的私有字段的 bean 框架已经为我们准备好了,我们现在要为它创建一个合理的构造器,如以下过程和演示所示。
使用代码补全来生成一个构造器:
- 把光标放置在文件中您想要生成构造器的地方,然后按 Ctrl+Space 键。
- 在出现的代码补全窗口中,选择将初始化它的字段的构造器
(例如,
Mail(String subject, String body) - 生成)。注意,IDE 给你提供生成默认构造器或者将初始化所有字段的构造器的选项。
- 按回车键。
IDE 在指定的位置实现您选择的构造器。注意,IDE 同时也可能提供超类方法的覆盖选项或者父接口方法的实现选项。
用代码生成对话框生成代码
IDE 的 Java 编辑器对于生成构造器是很强大的,通常您会自然而然地使用它。在这一节,我们将来看看这个过程。
下一步我们要做的是为字段生成 Getter 和 Setter 方法,并确定我们能将该类用在需要有 equals() 和 hashCode() 方法的集合中。通常 IDE 的 Java 编辑器能够自动地生成这种结构。注意,与我们学习的范例过程一样,IDE 的代码生成对话框同样允许您做更多的事,包括创建委托方法,生成初始化任意字段集的构造器,等等。
生成 getter 和 setter 方法:
- 按下 Alt+Insert 键呼出代码生成菜单。
- 从显示的列表选项中选择您要生成的功能(例如,
Getter 和 Setter...)。
- 在弹出的对话框中,选择您想要生成 getter 和 setter 方法的字段,点击“确定”按钮。
IDE 自动生成 getter 和 setter 方法。
下一步我们要做的是通过 Alt-Insert 键生成一个 Equals 和 Hashcode 方法。
生成 equals 和 hashcode 方法:
- 按下 Alt+Insert 键呼出代码生成菜单:
- 在弹出的菜单中选择您要生成的项(例如,
equals() 和 hashCode()... )。
- 在弹出的对话框中,选择您要生成 equals 和 hashCode 方法的字段并点击“确定”按钮。
IDE 生成所需的 equals 和 hashcode 方法。
生成 Getters, Setters, Equals, 和 Hashcode 方法
管理 Import 语句
当您点击小灯泡错误标记或者按下适当的组合键时,IDE 的 Java 编辑器提供了几种方法来为一个或多个类添加 import 语句,每种方法都提供了一个可用于导入的类的列表。另外,编辑器也提供了错误提示来帮助您删除源程序中未使用导入语句。
在我们前一节的文件中做了必要的修改后,您会注意到 IDE 在编辑窗的左边显示了一个警告,提示您在我们的文件中存在一个未使用的导入。要修复它,我们可以使用 IDE 中新增的强大的删除未使用的导入命令,我们可以看到它是如何工作的。
删除未使用的导入:
- 把光标放在未导入的类所在的行并按下 Alt+Enter 键。您可以在批注条(沿着编辑器的左边缘)上点击警告标志。
- 在弹出菜单中选择“删除未使用的导入”。注意,您可以选择从导入段中删除一个或者所有未使用的导入。
IDE 从文件中删除未使用的导入语句。
IDE 的 Java 编辑器同时提供了管理导入语句的其它几种方法,例如按下 Ctrl+I 键一次性导入多个类型,当光标被放在一个类型上时按下 Alt+I 键可以导入那个具体的类型。
使用编辑器行工具
在此,我们将为用户名和密码创建两个字符型的私有静态字段。使用编辑器的行编辑工具特性,我们快速地复制光标所在的行,并立即复制/粘贴或移动到第一行之下。当要快速地复制或移动拥有大部分相同代码并只有一小部分需要调整的代码行时,例如在初始化一个数组的情况下,这个特性特别有用。这样操作之后,您可以根据需要编辑字段的值。
复制当前行或者多个选定的行:
- 将光标放在您要复制的行上或者选择您要复制的多个行。
- 按住 Ctrl-Shift 键,然后按“向上”或“向下”键将指定的代码行复制并粘贴到原始行的上方或下方。
IDE 将当前行或者多个选定的行复制到了目标位置。
移动当前行或者多个选定的行:
- 将光标放在您要移动的行上或者选择您要移动的多个行。
- 按住 Alt-Shift 键,然后按“向上”或“向下”键将指定的代码行移动到原始行的上方或下方。
IDE 将当前行或者多个选定的行移动到了目标位置。
智能代码补全和动态模板
本节我们将转到项目的 Main.java 文件通过编写范例代码,再看一些教程的第一部分没有提及的常用特性,这段代码将从服务器上检查新电子邮件。
为了进一步说明使用新的编辑器的代码补全的简单过程,我们首先要初始化 UI。使用代码补全我们能够快速地实现。我们同样需要将首选值替换成一个字符串。
运行中的 NetBeans IDE 6.0 编辑器
下一步,我们将在 Main.java 文件中添加一个能够让我们访问数据库的类。在此过程中,我们将关注 IDE 编辑器中更多的一些有帮助的特性。
智能代码补全
在这一节,我们将使用智能代码补全来快速地在我们的文件中添加一个方法。
您也许注意到标准的代码完成框被一条黑线分成了两个部分。第一部分包含了智能补全的选项。为了列出这些选项,代码补全利用了代码补全被调用时的上下文环境(例如插入符号的位置)。了解更多关于智能代码补全特性的信息和范例,请看以下小节。
使用智能代码补全添加一个方法:
- 将光标放在文件中您想要生成构造器的地方并按下 Ctrl+Space 键。
- 如果您找不到适当的符号,再次按下 Ctrl+Space 键显示项目类路径中所有的符号,无论是已导入的还是未导入的。
- 在显示出来的代码补全窗口中,选择合适的选项(例如,
Mail(String subject, String body) - 生成)并按下 Enter 键。
IDE 在指定的地方实现所选择的构造器。
动态代码模板
IDE 的动态模板特性允许您通过简单地输入模板标识符的头几个字母来输入整个代码片段。在本节中,我们将使用动态模板添加一个 For 循环来遍历存储在服务器上的邮件列表。
使用动态模板添加一个迭代器:
- 输入代码模板的头几个字母并按下 Ctrl+Space 键来启用代码补全。
- 选择适当的模板。如果存在合适的集合,模板会自动为您填充蓝色的编辑区域。
- 按 Tab 键在蓝色的编辑区域循环并根据需要更新模板代码。
- 按 Enter 键或者 Esc 键结束编辑模板。
IDE 在文件中光标所在的位置添加模板代码。
注意: 编辑模板模式将一直持续到您在蓝色框之外做了编辑(甚至您将光标移动到蓝色编辑框之外)。如果这种情况出现,使用 Tab 键回到模板。
代码高亮
Java 编辑器的高亮是一个容易使用的特性,您可以认为是编辑器查找功能的一个加强。基于光标当前所在的位置,代码高亮特性将文件中所有相似的元素用一个背景色突出显示出来,这样您可以一瞥它们的所在位置。另外,高亮的行同时被显示在错误条,以显示整个文件的概览。
请注意 IDE 在批注条显示了一个错误,它告诉我们 connect 方法有可能会抛出一个输入/输出异常(IOException)但没有被捕获。我们必须捕获它或者根据按下 Alt-Enter 键后的提示将它添加到方法的 throws 子句中。只要您将光标放在一个异常上,编辑器就会高亮显示所有可能抛出这个异常的语句。如果您将光标放在一个方法的返回类型上,方法的所有退出点将被高亮显示。如果您将光标放在一个元素上,例如一个字段,文件中所有用到这个字段的地方将被高亮显示以轻松地识别和高效地导航。同时请注意 编辑器会在错误条显示一个标记,以显示它在源文件中使用到的地方。
高亮显示抛出异常的所有语句:
- 将光标放在方法声明的 throws 子句的一个异常上。
IDE 高亮显示了该异常可能抛出的所有地方。
如果您把光标放在方法声明的返回类型上,编辑器将高亮显示所有从该方法返回的返回点(所有抛出异常的语句的地方也会返回)。
高亮显示方法的退出点:
- 把光标放在方法声明的返回类型上。
编辑器高亮显示了所有抛出异常的表达式和每个显式声明返回的地方。注意,在返回类型为空的情况下方法的关闭括号也会被高亮显示,因为执行过程会在方法结束的地方返回。
即时重命名
如果您想重命名一个私有成员(字段,方法,变量,等等),您通常可以有几种选择。首先,您可以使用查找和替换,但是如果稍不注意,您可能会把您不想替换的地方也替换了。其次,您可以使用重构来重命名,然而这却未免有点大材小用了。第三种方法,正是我们将在本节关注的,可以采用编辑器中即时重命名的新特性,您只要简单地将光标放在您想重命名的标识符上,并按下 Ctrl+R 键。
即时重命名:
- 把光标放在您想重命名的标识符上并按下 Ctrl+R 键。IDE 用蓝色高亮的方式把该标识符所有出现的地方突出标识出来,这样即时重命名模式就被激活了。
- 编辑该标识符,该成员所有出现的地方都随之改变。
- 按下 Enter 键或者 Esc 键结束编辑该标识符并退出即时重命名模式。
IDE 更新文件中所有该成员出现的地方。
页首
后续步骤
页首