JavaHelp 系統深度解析：跨平台線上幫助的最佳選擇

前言

JavaHelp 是 Sun Microsystems 推出的純 Java 線上幫助系統，支援所有 Java 平台與瀏覽器，可嵌入 Applet 或獨立應用程式，適合網路與企業內部網部署。本文全面介紹其架構優勢、核心功能、輕量級元件擴展與編寫工具。

一、 核心優勢

• 純 Java 實現：基於 JFC (Swing) 元件，跨平台零修改部署。
• 靈活嵌入：可內嵌應用程式視窗、獨立視窗、Applet 或瀏覽器。
• 動態更新：客戶端/伺服器端幫助內容均可動態更新，無需重新部署應用。
• 標準導航：內建目錄 (TOC)、索引、全文搜尋，符合 W3C 標準。
• 內容格式：HTML 3.2 格式，設計門檻低，工具鏈成熟。
• 單一 JAR 封裝：幫助內容與搜尋引擎打包為標準 JAR，便於分發與版本控制。
• 合併機制：多模組幫助可合併為單一完整文件，支援 TOC、索引、搜尋資料庫合併。
• 上下文敏感幫助：透過 Map 檔將元件 ID 映射至幫助主題 URL，分離程式碼與內容。
• 工具提示整合：工具提示文字可納入 JavaHelp 系統統一管理。

二、 系統架構與主視窗

標準 JavaHelp 主視窗包含三個窗格：

1. 工具列：導航按鈕、列印、字型大小等。
2. 導航窗格：TOC 樹狀結構、索引標籤、搜尋標籤。
3. 內容窗格：HTML 話題顯示區。

視窗屬性 (大小、位置、可見窗格) 可配置並持久化。

三、 核心元件：Map 檔 (映射檔)

將程式碼中的幫助 ID 與實際 HTML 檔案解耦：

<mapID target="FileChooser.html" url="FileChooser.html" />

程式碼僅請求 ID (如 fc_help)，內容作者可自由調整對應檔案而不修改程式碼。

四、 輕量級元件擴展

輕量級元件 (Lightweight Component) 類似 Applet 但載入更快，可為幫助主題添加互動功能：

• 內建：彈出視窗、次級視窗。
• HTML 中以 <object> 標籤嵌入：

<object classid="java:javax.help.Popup"
        codebase=".">
  <param name="content" value="../topicB/glossary_def.html" />
  <param name="viewerActivator" value="link" />
  <param name="windowType" value="popup" />
  <param name="windowSize" value="300x400" />
  <param name="text" value="Click here" />
</object>

開發者可自行實作 javax.help.impl.ViewAwareComponent 開發自訂輕量級元件 (如動畫、多媒體)，透過 setViewData() 取得抽象視圖資訊決定行為。

五、 版本與相容性

• 主要版本：1.1.3、2.0。
• 最早支援 JavaHelp 2.0 的 JDK 為 J2SE 1.2.2。
• 現代 JDK (8/11/17/21) 皆相容，需額外引入 javahelp 模組/依賴 (Maven: org.javahelp:javahelp:2.0.05)。

六、 編寫工具推薦

所有工具支援 Java 2 與 Java 1.1 標準。更多資訊請見 Sun 官方 JavaHelp Authoring Tools 頁面。

七、 總結

JavaHelp 以純 Java、標準 HTML、強大合併與擴展機制，成為跨平台桌面應用線上幫助的經典方案。雖然現代 Web 應用多轉向瀏覽器式文件中心，但在離線、嵌入式、高安全性桌面應用場景，JavaHelp 仍具不可替代價值。

1. 上一篇文章： J2EE配置：配置J2SE（1） - JDK 下載與安裝圖文教學
2. 下一篇文章： Java 序列化機制感性認識：Serializable 介面與 ObjectOutputStream 實戰

J2SE

Eclipse 3.1 深度體驗 J2SE 5.0 枚舉類型 (6)：EnumSet 高效集合操作與枚舉方法定義

EnumSet：專為枚舉設計的高效位向量集合 java.ut

Java 客戶端調用 Web 服務（一）：Web 服務互操作性與 Java 標準規範概述

Web 服務的核心價值：互操作性 得益於業界在 SOAP、W

Eclipse 3.1 深度體驗 J2SE 5.0 枚舉類型 (5)：Switch 語句規則、EnumMap 與 EnumSet 進階

Switch 語句中的枚舉：語法陷阱與編譯器實現 關鍵規則：

Eclipse 3.1 深度體驗 J2SE 5.0 枚舉類型 (4)：for-each 迭代與 Switch 語句應用

枚舉類型的核心應用場景 J2SE 5.0 枚舉配合新語法特性