&java ADT-程序环境修改为中文
秒后自动跳转到登录页
(奖励10下载豆)
快捷登录：
举报类型：
不规范：上传重复资源
不规范：标题与实际内容不符
不规范：资源无法下载或使用
其他不规范行为
违规：资源涉及侵权
违规：含有危害国家安全等内容
违规：含有反动/色情等内容
违规：广告内容
详细原因：
任何违反下载中心规定的资源，欢迎Down友监督举报，第一举报人可获5-10下载豆奖励。
Java 7并发编程实战
Java经典问题答案（
算法与数据结构-实用
百度面试题总结
北京中软笔试题
Java最著名的开源项
Java网络socket编程
java ADT-程序环境修改为中文
上传时间：
技术分类：
资源评价：
（0位用户参与评价）
已被下载&11&次
Eclipse中文版语言包下载和使用语言包使用方法下载后解压文件，将里边的文件对应复制到eclipse的安装文件同名文件夹下即可（文件夹名字相同的直接复制文件夹合并到一起就可以了），再次启动eclipse，你会发现界面已经变成中文了！！
本资料共包含以下附件：
BabelLanguagePack-eclipse-zh_4.3.0.v55.zip
（12位用户参与评价）
down友评价
51CTO下载中心常见问题：
1.如何获得下载豆？
1)上传资料
2)评论资料
3)每天在首页签到领取
4)购买VIP会员服务，无需下载豆下载资源
5)更多途径：点击此处
2.如何删除自己的资料？
下载资料意味着您已同意遵守以下协议：
1.资料的所有权益归上传用户所有
2.未经权益所有人同意，不得将资料中的内容挪作商业或盈利用途
3.51CTO下载中心仅提供资料交流平台，并不对任何资料负责
4.本站资料中如有侵权或不适当内容，请邮件与我们联系（）
5.本站不保证资源的准确性、安全性和完整性, 同时也不承担用户因使用这些资料对自己和他人造成任何形式的伤害或损失
下载1612次
相关专题推荐
本专题收录Java经典编程的实例源码，
在国内的开发语言中，java凭借这简单
本套视频教程是韩顺平老师，循序渐进
北京圣思园张龙（风中叶）老师的Java
讲述Arm嵌入式Linux系统下的C语言编程
这段视频是从尚学堂科技的教学课堂上
本套视频共78集，是由郝斌老师根据多
本视频专题共180集涵盖了C语言概述中
本视频专题共107集涵盖了Java概述、数
由传智播客毕向东老师讲解的Java基础
本专题为spring视频教程，共31集。教
本专题为C语言黑客编程系列视频教程，
本专题为韩顺平讲解的Java从入门到精
本专题为Java Web项目开发案例精粹视
SSH为struts+spring+hibernate的一个
本专题为疯狂Java李刚老师讲解的Stru
本周下载热点您所在的位置： &
10 招让你成为杰出的Java程序员
10 招让你成为杰出的Java程序员
在我们每天的工作中，我们或许会学到新的东西，新的做事方法、实践形式和架构理念。可以将这些想法记录到文档或者博客中，分享给大家。因为你现在解决问题的方法可能正是世界上另一个角落另一个开发人员“寻寻觅觅上下求索”的难题，你的分享将完全不亚于一场久旱的甘霖。
498)this.width=498;' onmousewheel = 'javascript:return big(this)' src="/wyfs02/M01/59/BB/wKiom1TdZ3CjwCMfAAEWMl6BJAw123.jpg" data-bd-imgshare-binded="1" alt="" />
如果你是一个热衷于技术的 Java 程序员， 那么下面的 10 个要点可以让你在众多 Java 开发人员中脱颖而出。
1. 拥有扎实的基础和深刻理解 OO 原则
对于 Java 程序员，深刻理解 Object Oriented Programming（面向对象编程）这一概念是必须的。没有 OOPS 的坚实基础，就领会不了像 Java 这些面向对象编程语言的美。光学习 OO 原则的定义用处不大，关键是要学会如何应用这些原则用一种 OO 的方式去设计解决方案。因此，我们应该对对象建模、继承、多态、设计模式有一个很好的认识。
2. 掌握核心 API
如果你不知道语言结构和核心 API，那么即使你在理论知识上再怎么彪悍也是独木难成林。在 Java 中，我们最好能对核心 API，如 java.lang.*、I/O、异常、集合、泛型、线程、JDBC 等有很强的实战经验。要是涉及到 Web 应用的开发，无论你使用的是对 Servlet 有多大关系的框架，JSP 都是必须的。
3. 不断编码
陆游曾说过，&纸上得来终觉浅，绝知此事要躬行&。从理论上想出一个解决方案很简单，但是真到了实施的时候，才会意识到问题有多难。此时，你才会明白编码过程中存在的语言限制，从而设计出最好的实践方案。因此，请勿中断编码。
4. 订阅社区论坛
我们并非踽踽独行者。很多人都和我们一样在研究着相同的技术。只是对某个框架概念做验证是不难的，但是当你将这些概念应用到实际的项目中时，那么各 种各样的问题，各种在官方文档上找不到解决方法的难题就会接踵而来。学习新技术首先要做的是订阅相关的技术社区论坛。无论你遇到的是什么问题，总会有人比 你先碰到过，而且搞不好已经找到了解决方法。Ps，还可以解答别人提出来的问题，而且这感觉不要太爽哦。你也可以通过邮件订阅《快乐码农》程序员期刊获取 更多的编程知识，点击订阅。
5. 追博客并附上自己的评论
正如我前一点所说的，我们并不孤单。成千上万来自世界各地的技术爱好者将他们的技术见解发表在博客上。在博客上我们可以找到很多相同技术的不同观 点。有人会觉得这是一个强大的技术功能，而有的人可能会觉得这是一个愚蠢的框架，仁者见仁智者见智。所以对于同一种技术你会在博客中听到两种不同的声音。 看到好的博客可以写点自己的看法回复在评论上。
6. 阅读开源框架的源代码
好的开发人员总是知道如何使用框架。但是如果你想成为一个优秀的开发人员，那么你需要研究各种成功和流行的框架源代码，去了解它的内部工作机制和最佳实践形式。这是一种高效的使用框架的方法。
7. 了解相关技术的发展趋势
在开源环境中，软件开发技术总是在不断发展变化。现在所谓的新框架，可能到时候会过时。当前框架上解决不了的问题，可能在新框架上就不再是问题。所以要时刻注意着新事物的诞生和旧事物的消亡。
8. 手头准备好常用的代码片段/实用程序
有时候我们可能需要一遍又一遍地复制粘贴/编写相同的代码片段/配置。所以，保存一些配置片段如 log4.properties、jdbc 配置，以及实用程序如 StringUtils、ReflectionUtils、DBUtils 大有好处。这些东西本身可能并不能让你与众不同，但是你想想看，要是你的合作开发人员希望你帮他从对象集合中获取属性值的列表，而你只需要用 ReflectionUtil 就可以在几分钟内解决，是不是一下子脱颖而出了呢。
9. 了解不同的开发方法
熟悉不同的开发方法，例如 Agile、SCRUM、XP、Waterfall 等等。现在，选择哪种开发方法是由客户说了算的。有的客户偏好 Agile，而有的则更喜欢 Waterfall 模型。所以对各种方法都能有所涉猎绝对让人刮目相看。
10. 将自己对技术的看法记录到文档/博客上
在我们每天的工作中，我们或许会学到新的东西，新的做事方法、实践形式和架构理念。可以将这些想法记录到文档或者博客中，分享给大家。因为你现在解决问题的方法可能正是世界上另一个角落另一个开发人员&寻寻觅觅上下求索&的难题，你的分享将完全不亚于一场久旱的甘霖。
英文原文：【编辑推荐】【责任编辑： TEL：（010）】
关于&&的更多文章
在这本精品书籍的指引下创建和发布同时适用于桌面和移动设备的企
HTML5领域，高空喊话的不在少数，很多人就感觉像是在上演狼来了...
讲师： 26人学习过讲师： 332人学习过讲师： 60人学习过
在此之前的几年时间里，已经有很多开发者陆续使用了HT
编程领域在这几年里迎来了翻天覆地的变化，如果说C、C
我们都知道在20世纪90年代是多元文化和多媒体时代，而
该书为C#经典名著！是Wrox红皮书中最畅销的品种之一。从第1版开始就名满天下；其第3版被评选为2005年最权威的十大IT图书之一；并
51CTO旗下网站IBM Bluemix
点击按钮，开始云上的开发！
developerWorks 社区
即使是帮助系统设计师有时也可能需要帮助，有了 JavaHelp 2.0，终于可以提供帮助了。在本文中，将介绍如何使用 Java 平台特有的帮助系统 API 构建一个标准的、全功能的、容易使用的系统，以向 Java 应用程序用户展 示在线信息。
(), 软件咨询师和开发者
Chen Junhua 是一位具有多年经验的自由软件顾问和开发人员。她也在新加坡南洋科技大学从事 agent learning 方面的研究。可以通过
从开发者的角度看，自动化的帮助组件，或者帮助系统，通常是在构建一个 Java 应用程序时最后考虑的事情。不过对于用户来说，帮助系统是学习新应用程序时非常有价值的资源。随着对功能更全和更可靠的应用程序帮助系统的需求增加，应用程序开发人员的时间和生产率负担也随之增加。幸运的是，Java 平台包括了一个专门构建应用程序帮助系统的 API。在本文中，将介绍如何使用 JavaHelp 2.0 API 为一个简单的 Java 应用程序构建一个标准的、全功能的帮助系统。首先将构建一个基本的应用程序帮助系统，它包括一组主题文件、一组导航文件和一组数据文件。然后将介绍如何使这个帮助系统可以被 Java 应用程序使用，并用基于文字或者图形的导航、预先设置的字体、分层的展示窗口和可搜索的数据库定制它。还将介绍如何实现上下文敏感的功能、将帮助系统直接加入到应用程序中、合并多个帮助系统以及为帮助系统创建自定义的轻量级组件。在本文最后，我将快速回顾 JavaHelp 2.0 的服务器端帮助系统框架。注意：本文假定读者熟悉构建帮助系统的设计考虑并熟悉在 Java 平台上开发企业应用程序。如果有一些 Swing GUI 开发的经验也会有帮助。
入门在本文中，将为一个 Tax Calculator 应用程序构建一个 JavaHelp 系统。图 1 显示了这个 Tax Calculator。可以在本文最后的
中找到这个例子的源代码。运行
FirstLook以显示 Tax Calculator。
图 1. Tax Calculator 的 About 页在图 2 中您会看到 Tax Calculator 帮助系统的导航设置。注意突出显示了后面将要讨论的一些导航图标。图 2. 导航帮助系统使用 HelpSet每一个 JavaHelp 帮助系统都包含一组称为 HelpSet 的文件。这些文件共同提供了应用程序帮助系统的工作基础。JavaHelp HelpSet 包括三种类型的文件：
HelpSet 数据文件导航文件主题文件可以在
中找到示例 Tax Calculator 的帮助系统的 HelpSet 文件。HelpSet 数据文件是 TaxCalculatorHelpSet.hs 和 TaxCalculatorMap.jhm。导航文件是 TaxCalculatorIndex.xml、TaxCalculatorTOC.xml 和 TaxCalculatorGlossary.xml。主题文件位于文件夹
TaxCalculator中。请使用这些文件以跟随下面几节中的讨论。
HelpSet 数据文件有两种 HelpSet 数据文件，分别是 helpset 文件和 map 文件。
helpset 文件是帮助系统的主控制文件。它必须有文件扩展名 .hs。
map 文件用于为每一个帮助主题关联一个 map ID 以进行导航。map 文件的文件扩展名是 .jhm。我将详细介绍每一种 HelpSet 文件类型。
helpset 文件helpset 文件提供了应用程序帮助系统的工作基础。一个典型的 helpset 文件的结构类似清单 1。
清单 1. helpset 文件 &helpset version="2.0"&
&!-- maps section --&
&maps&...&/maps&
&!-- views section --&
&view&...&/view&
&!-- presentation section --&
&presentation&...&/presentation&
&!-- implementation section --&
&impl&...&/impl&
&/helpset&可以注意到典型的 helpset 文件有四部分：maps（映射）部分、view（视图）部分、presentation（展示）部分和 implementation（实现）部分。当用户访问帮助系统时，系统首先读取 .hs 文件。它使用在 maps 部分指定的 map 文件寻找所需要的主题文件，在 view 部分的导航文件用于创建导航视图等。我将用 Tax Calculator 帮助系统作为例子展示这四部分 helpset 文件是如何实际共同工作的。maps 部分&maps&元素指定 map 文件，我在下面还将进一步讨论。清单 2 显示了 TaxCalculatorHelpSet.hs 的 maps 部分。注意 TaxCalculatorMap.jhm 是一个 map 文件。它位于 TaxCalculatorHelpSet.hs 所在的同一目录。
清单 2. maps 部分 &maps&
&homeID&overview&/homeID&
&mapref location="TaxCalculatorMap.jhm" /&
&/maps&view 部分helpset 文件可以指定一个或者多个
&view&元素，用于指定帮助系统的导航视图以及它们的导航文件。导航视图显示在导航窗格中（请参阅
）。在设置帮助系统时，可以选择以下的视图：
javax.help.GlossaryViewjavax.help.TOCViewjavax.help.IndexViewjavax.help.FavoritesViewjavax.help.SearchView清单 3 指定了一个 Glossary 视图和它的导航文件的位置。清单 3. 一个 Glossary 视图元素 &view&
&name&Glossary&/name&
&label&Glossary&/label&
&type&javax.help.GlossaryView&/type&
&data&TaxCalculatorGlossary.xml&/data&
&image&glossary_icon&/image&
&/view&可以使用任何内容作为视图的
&type&元素指定帮助系统的导航视图，而
&data&元素指定导航文件的路径。如果指定
&image&元素，图像将显示在导航窗格的顶部作为该视图的选项卡图标（如
第 3 部分所示）。元素值
glossary_icon是在 map 文件中定义的（请参阅
presentation 部分&presentation&元素定义了帮助窗口属性，如清单 4 所示。
清单 4. presentation 部分 &presentation default="true"&
&name&Main_Window&/name&
&size width="640" height="480" /&
&location x="0" y="0" /&
&title&Tax Calculator&/title&
&image&icon&/image&
&helpaction&javax.help.BackAction&/helpaction&
&helpaction
image="addfav_icon"&javax.help.FavoritesAction&/helpaction&
&/toolbar&
&/presentation&可以在 Java 代码中调用元素
&name&的值 --
Main_Window。将用
&title&元素指定帮助窗口的标题，用
&image&元素指定标题栏图标（见
的第一个面板）。注意这个
icon是在下面 map 文件中定义的。
&toolbar&元素也是可配置的。如果没有指定一个值，那么帮助系统将包括一些默认的标题栏按钮。每一个
&helpaction&对应于帮助窗口工具栏中的一个工具栏按钮。JavaHelp 提供了八种类型的
helpaction，如下所示：
BackActionForwardActionSeparatorActionHomeActionReloadActionPrintActionPrintSetupActionFavoritesAction请参见前面的
，您会看到工具栏按钮是（从左到右）：
BackAction、ForwardAction、SeparatorAction、HomeAction、ReloadAction、SeparatorAction、PrintAction、PrintSetupAction 和
FavoritesAction。可以通过指定
&helpaction&元素的
image属性改变工具栏按钮的图标。注意
addfav_icon是在下面的 map 文件中定义的。将
&presentation&标签的
default属性改为
true将使它成为帮助系统的默认展示。
implementation 部分在
&impl&元素中，可以指定可以在内容查看器中显示的文件类型。例如，清单 5 中的代码使用户可以观看 HTML 和 PDF 文件。
清单 5. implementation 部分&impl&
&helpsetregistry helpbrokerclass="javax.help.DefaultHelpBroker" /&
&viewerregistry viewertype="text/html"
viewerclass="com.sun.java.help.impl.CustomKit" /&
&viewerregistry viewertype="application/pdf"
viewerclass="Your PDF Editor Kit" /&
&/impl&map 文件map 文件是在 HelpSet 数据文件中可以找到的另一种文件类型。它通过将 ID 字符串映射到帮助主题文件的 URL 而为每一个帮助主题关联一个 map ID。helpset 文件和导航文件总是通过 map ID 引用帮助主题。map 文件可以将 map ID 分配给任何类型的文件。清单 6 显示了 Tax Calculator 帮助系统的 map 文件。
清单 6. TaxCalculatorMap.jhm &map version="2.0"&
&mapID target="overview" url="TaxCalculator/overview.htm" /&
&mapID target="icon" url="images/icon.gif" /&
&mapID target="glossary_icon" url="images/g.gif" /&
&mapID target="addfav_icon" url="images/addfav_icon.gif" /&
&/map&导航文件回到原来的 HelpSet，可以看到下一种文件类型是导航文件。四种导航文件是 TOC、Index、Glossary 和 Favorites。帮助系统读取这些文件中的信息以建立四种类型的导航视图，然后将它们显示在导航窗格中。我将详细介绍每一种导航文件。
&tocitem&元素都可以有属性
image，如清单 7 所示。
text属性的值是
tocItem的文字标签。
target属性的值是表示帮助主题文件的 map ID。
image属性指定一个显示在
tocItem左边的图片。如果没有指定一个图片，那么帮助系统将使用默认图片，如
的第四部分所示。清单 7 显示了 Tax Calculator 帮助系统的 TOC 文件的局部。
清单 7. TaxCalculatorTOC.xml &toc version="2.0"&
&tocitem text="Pages" image="topLevel"&
&tocitem text="About Page" target="about" image="secondLevel" /&
&tocitem text="Color Chooser" target="colorChooser" /&
&/tocitem&
&/toc&Index每一个
&indexitem&元素都可以有属性
text属性的值是
indexItem的文字标签。
target属性的值是表示帮助主题文件的 map ID。清单 8 显示了 Tax Calculator 帮助系统的 index 文件的部分内容。
清单 8. TaxCalculatorIndex.xml &index version="2.0"&
&indexitem text="Color"&
&indexitem text="Changing Color" target="changeColor"/&
&indexitem text="Color Chooser" target="colorChooser"/&
&/indexitem&
&/index&GlossaryGlossary 文件也使用
&indexitem&元素，如清单 9 所示。
清单 9. TaxCalculatorGlossary.xml &index version="2.0"&
&indexitem text="Button" target="button_def"/&
&/index&Favorites帮助系统自动生成 Favorites.xml 文件。它存储在
usrdir/javahelp中。如果在同一台计算机中安装了多个 JavaHelp 系统，那么将保留最后运行的帮助系统的 Favorites.xml。
主题文件主题文件为 HTML 格式。建议在 HTML 文件中指定
&title&标签，因为
&title&标签将用于在搜索数据库中进行全文搜索 -- 稍后将作介绍。
在编写了主题文件、导航文件、map 文件和 helpset 文件后，就可以通过运行 %JAVAHELP_HOME%\demos\bin 中的 hsviewer.jar 打开 helpset。图 3 显示了浏览到 TaxCalculatorHelpSet.hs 并单击 Display 时所出现的情况。图 3. hsviewer 中的 Tax Calculator HelpSet在 Java 应用程序中调用 JavaHelp在构建了一个基本的帮助系统后，会希望可以在 Java 应用程序中调用它。可以通过单击一个按钮或者菜单项调出 JavaHelp 系统。清单 10 显示了用按钮调出帮助系统的两种方式。不管采用哪种方式，第一步都是创建一个新的 helpset（如在前面的练习中所做的）并为它创建
help broker。然后可以利用 help broker 的
enableHelpOnButton()方法用按钮调出帮助系统，也可以加入一个名为
CSH.DisplayHelpFromSource()的操作监听器。单击按钮时，操作监听器将得到操作源的
helpID并在帮助查看程序中显示这个
helpID。清单 10 中显示了这两种方式。
清单 10. ButtonHelp.java ...
help_but=new JButton("Help");
Classloader loader = ButtonHelp.class.getClassLoader();
URL url = HelpSet.findHelpSet(loader, "TaxCalculatorHelpSet");
hs = new HelpSet(loader, url);
} catch (HelpSetException e) {
HelpBroker helpbroker = hs.createHelpBroker("Main_Window");
/**-----the first way of calling a help system------------
helpbroker.enableHelpOnButton(help_but, "overview", hs);
/**-----the second way of calling a help system-----------
ActionListener contentListener = new CSH.DisplayHelpFromSource(helpbroker);
CSH.setHelpIDString(help_but, "overview");
help_but.addActionListener(contentListener);
*/用菜单项调用帮助系统的过程与此类似。要了解有关用按钮调用的更多内容，请参阅本文源代码中的 ButtonHelp.java （在
中），使用菜单项调用的情况请参阅 MenuItemHelp.java。
自定义外观尽管一开始完全可以使用默认的 JavaHelp 帮助系统，但是一般会希望定制它的外观以更好地适合自己的应用程序。在这一节，将介绍如何为 GUI 　组件配置特别的图标，自定义导航标签和工具栏并设置帮助系统字体。
配置图标可在 helpset 文件中配置 JavaHelp 标题栏图标、工具栏按钮图标和导航标签图标。标题栏图标是用
&presentation&标签设置的，可以用
&presentation&标签的
&helpaction&元素的一个属性设置工具栏按钮图标，而导航标签图标可以在
&view&标签中设置。此外，可以在导航文件中设置导航文件项图标。
基于文字的标签还是基于图像的标签？可以在帮助系统中使用默认的图像标签，也可以使用文字标签。要使用文字标签，需要在 TaxCalculatorHelpSet.hs 中将
&presentation&标签的
displayviewimages属性设置为
false。例如，代码
&presentation default="true" displayviewimages="false"&将得到如图 4 的第二个面板所示的基于文字的标签。
图 4. 图像标签和文字标签注意如图 4 所示显示在文字标签上的字是 helpset 文件 TaxCalculatorHelpSet.hs 的
&view&标签的
&label&元素的值。
要工具栏还是不要工具栏？可以显示不带工具栏的帮助窗口。要选择所喜欢的那种方式，运行 ButtonHelp.java 文件的 ButtonHelp.class 并单击 Help 按钮。将会看到两个帮助窗口，一个带工具栏，另一个不带。如果选择不带工具栏，只要在 helpset 文件 TaxCalculatorHelpSet.hs 中创建一个没有
&toolbar&元素的
&presentation&标签。
设置字体设置帮助系统的字体非常容易。例如，代码
Font font = new Font("SansSerif", Font.ITALIC, 10); helpbroker.setFont(font);将产生如图 5b 所示的自定义字体，可以与图 5a 所示的默认字体进行比较。
图 5a. 默认字体显示图 5b. 自定义字体显示使用展示窗口在 JavaHelp 帮助系统中有三种类型 -- 或者层 -- 的帮助窗口：
主窗口可以有图标、改变大小、让用户移动和让用户关闭。在默认情况下，主窗口包含一个工具栏、一个导航窗格和一个内容查看器。
二级窗口可以有图标、改变大小、让用户移动、可以让用户关闭或者在关闭帮助查看器时关闭它。它可以包含工具栏和导航窗格，但是在默认情况下它只包含一个内容查看器。
弹出窗口专门用于内容敏感的帮助，然而也可以定制它在其他地方使用。这个窗口不能改变大小或者移动，并且失去焦点时关闭。它只包含内容查看器。
在不同的展示窗口之间移动信息很简单，可以通过配置主题文件或者调用 Java 代码中的函数实现。在给定主题文件中嵌入一个
&ahref=url&标签会在调用时在当前窗口中打开链接的文件，不过要在二级窗口或者弹出窗口中显示新的主题文件需要多做一点工作（在下面讨论）。如要对展示做精心调整，可以在 JavaHelp API 中使用带参数
presentation的方法。例如，
HelpBroker类的
enableHelpOnButton()将像下面这样：
enableHelpOnButton(java.lang.Object obj, java.lang.String id, HelpSet hs,
java.lang.String presentation, java.lang.String presentationName)如果采用这种方式，将需要为参数
presentation选择
main window、
secondary window或者
popup window。例如，下面一行代码将使用户可以单击按钮
help_but在二级窗口中打开帮助主题：
helpbroker.enableHelpOnButton(help_but, "overview", hs,
"javax.help.SecondaryWindow", "main");&object& 标签如果选择使用主题文件而不是调用 Java 代码中的函数，那么将需要在 HTML 文件中加入
&object&标签以在不同类型的窗口中移动文件。清单 11 显示了如何用
&object&标签打开一个二级窗口。
清单 11. 打开一个二级窗口 &object CLASSID="java:com.sun.java.help.impl.JHSecondaryViewer"&
&param name="id" value="about"&
&param name="viewerActivator" value="javax.help.LinkLabel"&
&param name="iconByName" value="../images/topLevel.gif"&
&param name="viewerSize" value="350,400"&
&param name="viewerName" value="TaxCal"&
&/object&&object&标签有多个参数。表 1 介绍了二级窗口（
CLASSID="java:com.sun.java.help.impl.JHSecondaryViewer）的
&object&标签的 15 个有效的参数。
表 1. object 标签的有效参数功能参数说明窗口viewStyle可以设置为
javax.help.SecondaryWindow（默认值）或者
java.help.Popup。
内容id用在 map 文件中定义的 map ID 指定内容。内容content用相对 URL 指定内容。ActivatorviewerActivator可以设置为
javax.help.LinkButton（默认值）或者
javax.help.LinkLabel。
大小viewerSize示例：value="300, 400" 表明窗口是 300 像素宽，400 像素高。位置viewerLocation示例：value="300, 400" 表明窗口位于离左边 300 像素，离上边 400 像素的位置。名字viewerName设置窗口的名字。只对
secondaryWindow起作用，
Popup window忽略这个参数。
图标iconByID用在 map 文件中定义的 map ID 指定图像。图标iconByName用相对 URL 指定图像。文字text用户将会看到的字符串。文字特性textFontFamily可以设置为
Serif、SansSerif、Monospaced、Dialog、DialogInput或者
特性textFontSize可以设置为
xx-small、
xx-large、
smaller（bigger 和 smaller 的单位是 1）、
nnpt（将字体大小设置为特定的磅数 nn）、
-n将当前基准字体大小增加或者减小 n）、
n（设置字体大小为与索引 n 相关联的磅数）。
文字特性textFontWeight可以设置为
文字特性textFontStyle可以设置为 plain 或者 italic。文字特性textColor可以设置为
black、blue、cyan、darkGray、gray、green、lightGray、magenta、orange、pink、red、white或者
四种 activatoractivator是一个用户单击以启动展示窗口（弹出或者二级）的对象。使用参数
viewerActivator和参数
icon将生成四种 activator：文字标签、图像标签、文字按钮或者图像按钮 , 如图 6 所示。（注意第二种 activator 是
中的代码的结果。）
图 6. activator 的四种类型单击如图 6 所示的 About 页上的第二个或者第四个 activator 后，将可发现调出的二级窗口与主窗口几乎一样。如果回到 helpset 文件的
&presentation&标签，将会看到
Main_Window展示设置为
default。因为二级窗口也使用这个默认展示，它也有一个导航窗格和工具栏。
调出展示窗口的完整代码和展示请见 about.htm。添加内容敏感的帮助内容敏感的帮助是向用户提供信息的特别具有用户友好特点的方式。当用户单击一个特定的图标或者字段时 -- 如下面例子中显示的 Calculation 字段 -- 就会有一个弹出窗口解释功能或者这个字段下一步要做的事情。内容敏感的帮助可以归为下列三类之一：
窗口级帮助：当 Java 应用程序的窗口拥有焦点时，用户按下 Help 键（
F1）以启动帮助系统的特定主题，它通常是一个介绍主题。
字段级帮助：当 Java 应用程序的 GUI 上的一个特定组件 -- 如文本字段或者按钮 -- 拥有焦点时，用户按下 Help 键（
F1）或者单击一个按钮以启动帮助系统的描述当前组件的特定主题。
屏幕级帮助：用户单击一个按钮以调出具有描述应用程序当前屏幕的特定主题的帮助系统。
我将在后面几节中介绍调用各种类型的内容敏感的帮助的基本内容。代码示例可见 ContextSensitiveHelp.java 文件中的完整源代码。窗口级帮助当用户处在一个给定应用程序窗口中并发现他或者她需要帮助时，就可调出窗口级帮助。用户可以按 Help 键（
F1）调出窗口级帮助。调出的帮助系统如图 7 所示。
图 7. 用 Help 键（F1）调出窗口级帮助为了启用如图 7 所示的 Tax Calculator 窗口的 Help 键（
F1），要调用
helpbroker.enableHelpKey(getRootPane(), "personal", hs);。注意我用帮助系统的 map ID
personal设置帮助主题。注意
helpbroker.enableHelpKey()只对在基于 Swing 的应用程序中 JFrame 的
rootPane或者基于 AWT 的应用程序的
java.awt.Window起作用。我将在稍后讨论如何启用字段级组件的 Help 键。
字段级帮助字段级帮助文件是根据焦点启动的，即光标的位置和按下 Help 键。清单 12 显示了如何用
CSH.DisplayHelpFromFocus()启用字段级帮助的 Help 键。
清单 12. 用 Help 键调出的字段级帮助 CSH.setHelpIDString(maid_tf, "maid");
CSH.setHelpIDString(course_tf, "course");
CSH.setHelpIDString(income_tf, "income");
CSH.setHelpIDString(result_tf, "result");
ActionListener listener = new CSH.DisplayHelpFromFocus(hs, "javax.help.MainWindow", null);
maid_tf.addActionListener(listener);
course_tf.addActionListener(listener);
income_tf.addActionListener(listener);
result_tf.addActionListener(listener);继续上面的例子，单击 Calculation 选项卡以转换到 calculation 页并将光标移到这一页上的第一个文字字段
maid_tf。当光标在
maid_tf中闪动时，按
F1在主窗口中显示 Maid Levy 帮助主题，如图 8 所示。
图 8. 用 Help 键调出的字段级帮助也可以用按钮调出字段级帮助，如图 9 中的一个带有箭头的按钮。为此，应使用
CSH.DisplayHelpAfterTracking()，如下所示：
help_but.addActionListener(new CSH.DisplayHelpAfterTracking(hs,
"javax.help.Popup", "popup"));注意还有一个弹出窗口展示帮助主题。在单击箭头按钮并将光标移到
maid_tf字段，然后单击鼠标，会显示一个带有帮助主题 Maid Levy 的弹出窗口，如图 9 所示。
图 9. 用按钮调出字段级帮助屏幕级帮助当位于给定应用程序屏幕中的用户通过单击一个按钮请求关于该屏幕的信息（或者帮助）时，就会调出屏幕级帮助。在这个例子中，有一个有四种不同屏幕的选项卡窗格。清单 13 显示了一种根据当前屏幕显示帮助的方法。
清单 13. 屏幕级帮助 menu.addChangeListener(new ChangeListener() {
public void stateChanged(ChangeEvent evt) {
int sel = menu.getSelectedIndex();
if(sel==0) CSH.setHelpIDString(help_but1, "about");
else if(sel==1) CSH.setHelpIDString(help_but1, "preference");
else if(sel==2) CSH.setHelpIDString(help_but1, "personal");
else if(sel==3) CSH.setHelpIDString(help_but1, "calculation");
help_but1.addActionListener(new CSH.DisplayHelpFromSource(hs,
"javax.help.SecondaryWindow", "secondary"));对象
help_but1表示图 10 中带有文字
Help的按钮。我为选项卡窗格
menu添加了一个
ChangeListener。当焦点变为新的屏幕时，用
CSH.setHelpIDString()为
help_but1设置新的
helpID。注意
help_but1还有一个名为
CSH.DisplayHelpFromSource()的操作监听器。当用户单击按钮时，操作监听器将得到操作源（即
help_but1）的当前
helpID，并在帮助查看器中显示这个
helpID。因此，不管用户用任何种方法转换屏幕（使用选项卡或者菜单项），帮助系统都会显示当前屏幕的正确信息。
图 10 显示当用户转换到 Preference 屏幕时，显示描述 preferences 的特定主题。图 10. 屏幕级帮助添加嵌入帮助在建立了默认在线帮助系统后，可以将它直接嵌入到应用程序的界面中。清单 14 显示了如何将一个 TOC 视图嵌入到示例 Tax Calculator 应用程序中。
toc是一个 JPanel，
tabbedpane将
tocJPanel 关联到选项卡
getNavigatorView()的参数必须与在帮助文件中定义的视图的名字相同。它是大小写敏感的。可以用类似的方式将其他导航视图嵌入到应用程序中。
清单 14. EmbeddedHelp.java viewer = new JHelpContentViewer(hs);
viewer.setPreferredSize(new Dimension(250,220));
navTOC = (JHelpTOCNavigator)hs.getNavigatorView("TOC").createNavigator(viewer.getModel());
navTOC.setPreferredSize(new Dimension(150,220));
toc.add(navTOC);
toc.add(viewer);图 11 显示了将 TOC 嵌入到 Tax Calculator 应用程序的结果。注意只有在选择了菜单项 Show 后才会显示帮助系统。图 11. 嵌入的帮助添加搜索功能搜索功能是帮助系统的基本部分。要想利用这种功能，需要创建一个搜索数据库。JavaHelp API 包括一个可以自动索引帮助主题目录并建立搜索数据库的功能。按以下步骤创建搜索数据库：
设置帮助主题所在的目录为当前目录。在这个例子中是 src\TaxCalculator。
%JAVAHELP_HOME%\javahelp\bin\jhindexerTaxCalculator命令。记住 src\TaxCalculator 是存储主题文件的目录。这会在当前目录创建一个名为
JavaHelpSearch的索引文件夹。
%JAVAHELP_HOME%\javahelp\bin\jhsearchJavaHelpSearch命令以验证搜索数据库的有效性。如果看到消息
enterquery，就是成功创建了搜索数据库。
停用词停用词（Stop words）是在搜索时不提供结果的常用单词。下面是创建搜索数据库时使用的默认停用词。
aallamanandanyareasatbebutbycancouldforfrometcdoesdodidgoesgothadhashaveheherhimhishowifinisitletmemoremuchmustmynornotnowofoffonorourownseesetshallsheshouldsosomethanthatthethemthentherethesethisthosethoughtotoouswaswaywewhatwhenwherewhichwhowhywillwouldyesyetyou图 12 显示在
EmbeddedHelp的搜索视图中搜索单词
how时所出现的情况。没有结果显示，因为在默认情况下
how是一个停用词。
图 12. 默认停用词的搜索结果自定义停用词列表可以创建一个自定义停用词列表。例如，假设希望将单词
how从默认停用词列表中删除。有两种方法可以做到这一点，它们都需要用一个配置文件。第一种方法要创建一个配置文件（config.txt），然后将停用词存到另一个名为 stopWords.txt 的文件中。然后文件 config.txt 用
StopWordsFile stopWords.txt这一行指定停用词文件的位置。
清单 15 显示了这个自定义停用词文件，其中去掉了单词
how。注意在 stopWords.txt 中，每个停用词都必须开始一个新行。
清单 15. stopWords.txt a
...也可以在配置文件中直接包含所有停用词。为此，只要创建一个名为 config1.txt 的配置文件并将停用词直接加入到配置文件中，如下所示： StopWords a, all,..., his, if...要索引自定义的停用词列表，需要让 src 成为当前目录并运行命令
%JAVAHELP_HOME%\javahelp\bin\jhindexer -c config.txt TaxCalculator。用自已的配置文件替换命令中的 config.txt。例如，如果用
-c config1.txt运行
jhindexer命令，然后在
EmbeddedHelp视图中重新搜索
how，它将会返回几个结果项，如图 13 所示。
图 13. 使用自定义停用词的搜索结果搜索窗口中的红圈表明结果项与查询的相关程度。圆圈填充得越满，结果项的相关程度就越高。有五种相关程度。在图 13 中，数字表示查询在结果文件中匹配的次数。数字右边的文字是从帮助系统的主题文件中的
&title&标签中提取的。
合并 helpset大型、模块化的应用程序可能需要创建很多 helpset，甚至可能是由开发应用程序不同方面的不同小组所创建的。让用户分别观看每一个 helpset 当然是有用的，但是他或者她可能还想将所有 helpset（或者主题列表）作为一个整体来看。要做到这一点，可以合并 helpset。
在 JavaHelp 2.0 中有四种合并类型：
SortMerge、UniteAppendMerge、
AppendMerge和
NoMerge。表 2 列出了这四种合并类型及它们的特点。
表 2. JavaHelp 2.0 合并类型SortMergeUniteAppendMergeAppendMergeNoMerge这种合并类型完全按字母排序。如果在一个新视图中的项与在现有视图中的一项有同样的文字和目标，那么在合并的视图中这两项将成为一项。如果只有文字是相同的，那么在项的结尾处将加上 helpset 标题。这种合并类型保留现有视图层次结构。它将两个视图中匹配的元素合并为一个元素，然后合并且排序匹配元素的所有子元素。它将所有剩下的元素附加到现有视图的最后。这种合并类型只是将新视图数据附加到现有视图数据之后。不进行合并。Search 视图的默认合并类型 。没有视图默认使用这种类型的合并。TOC、Index 和 Glossary 视图的默认合并类型。Favorites 视图的默认合并类型。每种合并类型都是在 helpset 文件或者在导航文件中指定的。为了正确合并，现有 helpset 的视图名和新 helpset 的视图名必须相同。可以静态或者动态地合并 helpset。静态和动态合并可以通过在现有 helpset 文件中添加
&subhelpset&标签静态合并 helpset。如果使用绝对路径，那么位置应当有前缀
file:\，如 :
&subhelpset location="file:\...\helpset.hs"&。如果使用相对路径，那么位置看起来应当像这样：&subhelpset location="helpset.hs"&。
可以用方法
hs.add(hs1)、hs.remove(hs1)动态合并 helpset。
hs是现有 helpset，而
hs1是新的 helpset。要看到动态合并操作的结果，请参见本文源代码中的 MergeHelp.java 并运行
MergeHelp。
结果在图 14 中有两个 helpset TOC 以及合并它们的结果。
图 14. 合并在现有 helpset 的 TOC 视图标签中添加属性
mergetype="javax.help.UniteAppendMerge"将得到图 14 的第三个面板中的合并的 helpset，如清单 16 所示。
清单 16. Mergetype 属性 -- TaxCalculatorHelpSet.hs &view
mergetype="javax.help.UniteAppendMerge"&
&name&TOC&/name&
&label&TOC&/label&
&type&javax.help.TOCView&/type&
&data&TaxCalculatorTOC.xml&/data&
&/view&图 14 的第四个面板显示了在现有 helpset 的 TOC 导航文件中的
tocitemPages 中添加属性
mergetype="javax.help.SortMerge"的结果，如清单 17 所示。注意第三个和第四个面板中 Pages 主题的不同展示。在第三个面板中，新视图的元素附加到现有视图的最后。在第四个面板中，新视图和现有视图的元素按字母排列。
清单 17. Mergetype 属性 -- TaxCalculatorTOC.xml &tocitem text="Pages" image="topLevel"
mergetype="javax.help.SortMerge"&
&/tocitem&如果选择了菜单项 Add，那么就合并两个 helpset。如果没有选择这个菜单项，那么应用程序就从第一个 helpset 中删除第二个 helpset。添加轻量级组件Java 平台的轻量级组件类可以在定制帮助系统方面发挥很多作用。例如，您已经看到如何用轻量级组件类
JHSecondaryViewer和
&object&标签，创建及打开二级窗口和弹出窗口。在本节，将在这个练习的基础上创建自己的轻量级组件，然后用
&object&标签操纵它。将开发一个组件类
LightWeightCom，在用户单击一个图像时它会播放一段音频。
请参阅本文源代码 LightWeightCom.java 和 LightWeightComBeanInfo.java，以跟随本节的例子。要观看结果，使用 about.htm。清单 18 中显示的
BeanInfo类提供了关于轻量级组件的清晰信息。它必须扩展
SimpleBeanInfo。
getPropertyDescriptors()是
ContentViewer使用的这个类中的惟一方法。
清单 18. LightWeightComBeanInfo.java public PropertyDescriptor[] getPropertyDescriptors() {
PropertyDescriptor back[] = new PropertyDescriptor[4];
back[0] = new PropertyDescriptor("iconByName", LightWeightCom.class);
back[1] = new PropertyDescriptor("iconByID", LightWeightCom.class);
back[2] = new PropertyDescriptor("audioByName", LightWeightCom.class);
back[3] = new PropertyDescriptor("audioByID", LightWeightCom.class);
} catch (Exception ex) {
}轻量级组件类必须直接扩展
ponent或者
java.awt.Container，或者一个实现了轻量级组件的类。这个例子扩展
JLabel，它是一个实现了轻量级组件的类。如果您的组件将利用
View的信息，那么必须实现
com.sun.java.help.impl.ViewAwareComponent接口的
setViewData()方法。对于这个示例音频组件，我将利用
View的 helpset 和文档库（document base）信息，如清单 19 所示。
清单 19. LightWeightCom.java -- 实现 setViewData public class LightWeightCom extends JLabel implements ViewAwareComponent {
public void setViewData(View v) {
doc = (HTMLDocument) myView.getDocument();
base = doc.getBase();
// Loop through and find the JHelpContentViewer
Component c = container = (Component) myView.getContainer();
while (c != null) {
if (c instanceof JHelpContentViewer) {
c = c.getParent();
// Get the helpset if there was JHelpContentViewer
if (c !=null) {
TextHelpModel thm = ((JHelpContentViewer)c).getModel();
if (thm != null) {
hs = thm.getHelpSet();
}轻量级组件应当可以接受参数。例如，清单 20 设计为接收
param audioByID。
setAudioByID方法使用由
setViewData()获取的 helpset 信息。这个方法用
map ID得到主题文件的位置，如下所示。
清单 20. LightWeightCom.java -- setAudioByID public void setAudioByID(String name) {
Map map = hs.getCombinedMap();
url = map.getURLFromID(ID.create(name, hs));
} catch (java.net.MalformedURLException e2) {
sound = Applet.newAudioClip(url);
}编译 LightWeightCom.java 和 LightWeightComBeanInfo.java 后，将它们的类添加到类路径中并在帮助主题文件中添加清单 21 中的各行。在这个例子中，我将它们加到 about.htm 中。结果，单击图像标签时，将播放不同的音频片段。注意
&object&标签的属性
CLASSID必须以
java:开始，否则，帮助查看器将忽略它。
清单 21. about.htm 中的 Object 标签 &OBJECT CLASSID="java:LightWeightCom"&
&param name="iconByID" value="top"&
&param name="audioByID" value="music"&
&OBJECT CLASSID="java:LightWeightCom"&
&param name="iconByName" value="../images/leaf2.gif"&
&param name="audioByName" value="../audio/voice.au"&
&/OBJECT&基于服务器的帮助基于服务器的应用程序需要在线帮助。在这一节，将介绍如何向网络上的用户展示帮助系统。为了跟随本节中的练习，最好熟悉 Tomcat Web 服务器以及 JavaBean 和 JavaServer pages （JSP）技术的基础知识，以及 JavaScript 和 HTML 脚本。
设置我将使用 Tomcat Web server 4.1.18 运行本节中的例子。如果在开发计算机上没有安装 Tomcat version 4.0 或者更高版本，那么现在应当安装它。（更多信息请参阅
为了完成这些练习，在 Tomcat Web 服务器的 webapps 目录创建一个文件夹并将其命名为
TaxCalculatorHelp。作为最简单的基于服务器的帮助设置，我将利用 JavaHelp 2.0 的 serverhelp demo 中的代码。可以在 %JAVAHELP_HOME%/demos/serverhelp/web 目录中找到这些代码。将所有 .js、.html、.jsp、.tld 文件和子文件夹
images拷贝到新的
TaxCalculatorHelp文件夹中。将自己的 helpset 文件也拷贝到这个文件夹。最后，在
TaxCalculatorHelp中，创建一个名为
WEB-INF的文件夹和两个名字分别为
lib的子文件夹。将 jh.jar 拷贝到 WEB-INF/lib，就设置完成了。这种设置的例子请见本文源代码。
JavaHelp 服务器 beanServletHelpBroker是存储帮助状态信息的 JavaBeans 组件，如所使用的 helpset、当前 ID、当前导航视图和其他帮助信息。清单 22 的第 1 行定义了 help broker。第 2 和第 3 行通过提供
helpSetName设置特定 helpset 的 help broker。第 4 到第 6 行将新的 helpset 合并到现有的 HelpSet。如果
merge属性设置为
false，那么 help broker 将只对现有 HelpSet 起作用。
清单 22. JavaHelp 服务器 bean 1. &jsp:useBean id="helpBroker" class="javax.help.ServletHelpBroker" scope="session" /&
2. &jh:validate helpBroker="&%= helpBroker %&"
helpSetName="TaxCalculatorHelp/TaxCalculatorHelpSet.hs"/&
4. &jh:validate merge="&%= true %&"
helpSetName="TaxCalculatorHelp/ContextSensitive/HelpSet.hs"
helpBroker="&%= helpBroker %&" /&JavaScript 文件有几个重要的 JavaScript 文件。tree.js 用于构建树。可以用这个文件创建 TOC 和 Index 视图的导航树。可以用清单 23 中的代码构建树。文件 searchList.js 可以用于构建 Search 视图的树。util.js 检查内容中是否有任何改变。如果发生了改变，那么就会由这个改变触发更新。
清单 23. 构建树 indexTree = new Tree(name, lineHeight, selectColor, showIcon, expandAll)
indexTree.addTreeNode(parent, idnum, icon, content, helpID, URLData, expandType)
indexTree.drawTree();
indexTree.refreshTree();JSP 文件要介绍几个重要的 JSP 文件。navigator.jsp 用于从 helpset 文件中得到视图。javax.help.TOCView.jsp、javax.help.SearchView.jsp 和 javax.help.IndexView.jsp 分别构建它们相应的视图。help.jsp 文件控制帮助窗口的整体展示。
中帮助窗口的顶部帧显示标题（banner）。可以通过修改 banner.html 文件创建自己的标题。也可排除标题。图 15 中左下方的帧包含文件 navigator.jsp 和一个树导航器。右下方的帧包含文件 toolbar.html 和帮助主题内容查看器。可以将帧移到其他位置以及加入和 / 或排除帧而改变 GUI 显示。
让我们首先分析 navigator.jsp 文件。清单 24. navigator.jsp &jh:navigators helpBroker="&%= helpBroker %&" &
&td classtableDefStyle BGCOLOR="&%= isCurrentNav.booleanValue()
? "white" : "#E5E5E5" %&" ALIGN="center"&
&A class=tabbedAnchorStyle
HREF="navigator.jsp?nav=&%= name %&"&
&IMG src="&%= iconURL!=""? iconURL : "images/" +
className +".gif" %&" Alt="&%= tip %&" border=0&
&/jh:navigators&表 3 列出了所有 JSP 扩展。注意所有 JSP 扩展都必须以符号
表 3. JSP 扩展标签说明属性validate用新的 helpset 设置 help broker，它可以与其他 helpset 合并。它还可以指定当前 ID要求的属性：
helpbroker; 非要求的属性：
setInvalidURL,
helpSetName,
currentID,
mergenavigators返回给定 help broker 的
navigatorView信息
要求的属性：
helpbroker; 非要求的属性：
currentNavtocItem返回给定
tocItem信息
要求的属性：
helpbroker; 非要求的属性：
baseIDindexItem返回给定
IndexView的
IndexItem信息
要求的属性：
indexView、
helpbroker，非要求的属性：
baseIDsearchTOCItem返回给定
SearchView的
SearchTOCItem信息
要求的属性：
searchView、
helpbroker，非要求的属性：
baseID注意嵌套在 JSP 扩展的正文中的脚本变量
navigators、
indexItem和
searchTOCItem。
用嵌套的变量的
名字从 helpset 文件中得到所有视图。下表显示了在
&jh:navigators&开始和结束标签之间可以使用的变量。
表 4. 导航器变量变量数据类型说明classnameStringNavigatorView类的名字，例如，
javax.help.TOCViewnameString在 helpset 中定义的视图的名字，在这个例子中，对于
NavigatorView类
javax.help.TOCView它是“TOC”
tipString视图的工具提示iconURLString在 helpset 中的视图的 image 属性中定义的图标位置现在，让我们分析文件 javax.help.TOCView.jsp。清单 25. javax.help.TOCView.jsp tocTree = new Tree("tocTree", 16, "ccccff", true, false);
&% TOCView curNav = (TOCView)helpBroker.getCurrentNavigatorView(); %&
&jh:tocItem helpBroker="&%= helpBroker %&" tocView="&%= curNav %&" &
tocTree.addTreeNode("&%= parentID %&","&%= nodeID %&","&%= iconURL!=""?iconURL:"null" %&",
"&%= name %&","&%= helpID %&","&%= contentURL!=""?contentURL:"null" %&",
"&%= expansionType%&" );
&/jh:tocItem&
tocTree.drawTree();
tocTree.refreshTree();这段代码构建当前 helpset 的 TOC 导航树。可以用类似的方式创建 Search 和 Index 视图。您已经知道了 JSP 扩展
indexItem和
searchTOCItem及它们的属性。下面将介绍它们的嵌套变量，可在
&jh:tocItem&、
&jh:indexItem&和
&jh:searchTOCItem&的开始和结束标签之间调用下面表 5 和表 6 的变量。
表 5. tocItem 和 indexItem 变量的功能变量数据类型说明nameString用
tocItem或者
IndexItem的“name”属性设置的文字
targetString用
tocItem或者
IndexItem的“target”属性设置的目标
parentString标识父代码的十六进制值parentIDString标识父代码的字符串nodeString标识当前节点的十六进制值nodeIDString标识当前节点的字符串iconURLString定位在
tocItem或者
IndexItem中的“image”属性中定义的图标
contentURLString由这一项所表示的内容的 URLisCurrentNavBoolean如果是当前导航器则为 true，否则为 false。
注意：这个变量只对
tocItem可用
表 6. searchTOCItem 变量的功能变量数据类型说明nameStringsearchTOCItem的名字
helpIDString与
searchTOCItem相关联的 ID
confidenceString查询结果的相关程度hitsString在得到的文件中查询匹配的次数contentURLString内容的位置hitBoundriesString一组边界测试服务器端帮助所有开发过程的最后一步自然是测试工作的成果。要测试服务器端帮助系统，遵循以下步骤：
运行 Tomcat 服务器打开 Web 浏览器进入 URL http://127.0.0.1:8080/TaxCalculatorHelp跟随 Web 页面中的链接，可以找到服务器端帮助系统。当进入第一个链接时，将会看到与图 15a 同样的一个窗口。当进入第二个链接时，将会看到与图 15b 相同的窗口。图 15a. 服务器端帮助图 15b. 服务器端帮助结束语本文介绍了 Java 平台的帮助系统 API: JavaHelp 2.0。利用 JavaHelp，可以容易地在任何 Java 应用程序、组件或者设备中加入全功能的、标准的帮助系统。一个独立的 JavaHelp 帮助系统可以在任何平台上运行并可以嵌入到任何应用程序中。有了 JavaHelp 2.0，还可以为网络上的用户开发健壮的帮助系统，虽然功能没有那么全。
JavaHelp 2.0 有许多很好的功能，我们在这篇文章中对它们作了初步探讨。通过一步一步的解释和练习，介绍了如何创建和操纵位于 JavaHelp 2.0 帮助系统核心的主题文件、导航文件和 helpset 数据文件。还介绍了如何定制自己的 helpset、将它嵌入到现有的 Java 应用程序中、合并 helpset、为帮助系统创建轻量级组件插件、为用户提供上下文敏感的帮助等。在本文的最后介绍了 JavaHelp 2.0 API 的服务器端帮助功能。在这里，我鼓励读者练习所学的内容。研究本文的源代码并试着用 JavaHelp 2.0 API 构建不同功能和不同类型的帮助系统。更多参考请参阅
中的文章。
参考资料 您可以参阅本文在 developerWorks 全球站点上的
下载本文所用的
请在 Java 技术主页下载
如果还没有安装的话，需要先安装
才能完成本文中的练习。
要学习更多 JavaHelp 2.0 API 的内容，请参阅 Sun 的
更多参考，请见
”（，2003 年）提供了
JavaHelp 2.0 方方面面的更多内幕。
Marshall Lamb 的多少有点过时的“
developerWorks，2000
年 7 月）只展示了企业开发人员定制 JavaHelp API 方法中的一种。
JavaHelp 不是惟一可用的一帮助系统 API。请参阅“
developerWorks，2004
年 1 月）以了解 Eclipse 开发平台的帮助系统 API。
即使开发人员也偶尔需要访问帮助系统，有时需要远程访问帮助系统。在文章“
developerWorks，2004
年 2 月）中，Angel Vera 展示了如何从远方运行 WebSphere Studio Application Developer
帮助系统。
请参阅 Kevin Lewis 的
（O'Reilly，2000 年），这本书整个都是介绍 JavaHelp API。
developerWorks发现关于 Java 编程各个方面的文章。
，获得技术书籍的详细列表，其中包括数百本
还可以参阅
获得免费的 Java 相关教程的完整列表。
developerWorks: 登录
标有星（*）号的字段是必填字段。
保持登录。
单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件。
在您首次登录 developerWorks 时，会为您创建一份个人概要。您的个人概要中的信息（您的姓名、国家/地区，以及公司名称）是公开显示的，而且会随着您发布的任何内容一起显示，除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。
所有提交的信息确保安全。
选择您的昵称
当您初次登录到 developerWorks 时，将会为您创建一份概要信息，您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。昵称长度在 3 至 31 个字符之间。
您的昵称在 developerWorks 社区中必须是唯一的，并且出于隐私保护的原因，不能是您的电子邮件地址。
标有星（*）号的字段是必填字段。
(昵称长度在 3 至 31 个字符之间)
单击提交则表示您同意developerWorks 的条款和条件。 .
所有提交的信息确保安全。
文章、教程、演示，帮助您构建、部署和管理云应用。
立即加入来自 IBM 的专业 IT 社交网络。
为灾难恢复构建应用，赢取现金大奖。
static.content.url=/developerworks/js/artrating/SITE_ID=10Zone=Java technologyArticleID=53296ArticleTitle=向 Java 应用程序伸出援助之手publish-date=