JDK文档在线查询网站:
Eclipse是最流行的Java开发工具之一,它强大的代码辅助功能可以帮助开发完成复杂的API输入,并为每个API提供说明信息,但是这些说明信息都是英文的,这也是JDK默认的语言,因为在JDK自带的源代码中就是使用英文添加Javadoc信息的。对于语言,母语始终是大家沟通的主流语言。本实例将介绍如何对Eclipse进行设置,使其支持中文的API提示信息。
(1)在Eclipse中打开"首选项"对话框,展开"已安装的JRE"节点,选择当前默认的JRE环境,单击右侧的"编辑"按钮将弹出"编辑JRE"对话框,在该对话框的"JRE系统库"列表框中展开rt.jar类库的节点,如图1.47所示。可以看出rt.jar类库包含了"源代码连接"和"Javadoc位置"两个子节点,这两个子节点都是设置该类库对应的Javadoc提示信息的,也就是API提示信息。
图1.47 "编辑JRE"对话框
(2)源代码连接默认使用了JDK安装文件夹中自带的src.zip文件,其中源代码中包含英文的Javadoc信息。所以选择rt.jar类库的"源代码连接"节点,然后单击右侧的"移除"按钮,移除这个英文的API资源。
(3)"Javadoc位置"子节点指向了Java网站上的Javadoc连接,该连接地址是英文的API信息,选择该节点,单击右侧的"Javadoc位置"按钮来改变该节点的值。
(4)在弹出的对话框中选择Javadoc的URL路径或者压缩文件,如图1.48所示。单击"Javadoc位置路径"文本框右侧的"浏览"按钮来指定保存在本机上的中文Javadoc文件夹,或选中"归档中的Javadoc"单选按钮,并指定保存中文Javadoc信息的zip压缩文件(http://dlc.sun.com.edgesuite.net/jdk/jdk-api-localizations/jdk-api-zh-cn/builds/latest/html_zh_CN.zip)。然后单击"确定"按钮。
(5)在"编辑JRE"对话框中单击"完成"按钮。
(6)在Eclipse的Java编辑器中打开一个Java源文件,把鼠标放置在某个API语法上,可以看到这个API的辅助对话框显示了中文语言的提示信息,如图1.49所示。
图1.48 设置Javadoc路径或归档文件路径的对话框
图1.49 Java编辑器中显示的中文API信息
使用母语来学习和查询资料始终是最快捷的方法,编程中如果能查阅中文的API文档,可以大幅度地提高程序编码效率。