Java 桌面應用內嵌 Mozilla 瀏覽器：SWT Browser + XULRunner + JavaXPCOM 實戰

背景與動機

Java 桌面應用（Swing/SWT）常需嵌入 Web 內容：OAuth 登錄、富文本編輯、報表預覽、舊系統 Web 界面集成。標準 JEditorPane 僅支援 HTML 3.2/CSS 1，現代 Web 技術（HTML5、CSS3、JS 框架）完全無法渲染。SWT Browser 組件通過封裝原生瀏覽器引擎解決此痛點。

SWT Browser 內核演進

環境準備：XULRunner 安裝與註冊

XULRunner 是 Firefox/Thunderbird 核心運行時，提供 libxul 供嵌入。

下載

Mozilla FTP 選擇版本（如 45.0.2，兼容 SWT 4.6+）。注意：macOS 需 1.8.1.2+ 版支援 JavaXPCOM。

註冊命令 (管理員權限)

先執行 --unregister-global/user 移除舊版。

基礎嵌入：三步創建 Mozilla 風格 Browser

Display display = new Display();
Shell shell = new Shell(display);
shell.setLayout(new FillLayout());

// 關鍵：SWT.MOZILLA 指定內核
Browser browser = new Browser(shell, SWT.MOZILLA);

// 可選：同步頁面標題到 Shell
browser.addTitleListener(event -> shell.setText(event.title));

browser.setUrl("https://www.eclipse.org");

shell.open();
while (!shell.isDisposed()) {
    if (!display.readAndDispatch()) display.sleep();
}
display.dispose();

進階定制：JavaXPCOM 橋接 XPCOM 世界

核心概念

• XPCOM：跨平台組件對象模型，Firefox 內部組件通信基石。接口 (Interface)、組件 (Component)、服務 (Service)。
• JavaXPCOM：Java 與 XPCOM 雙向橋梁。Java 調用 XPCOM 組件，XPCOM 回調 Java 實現的接口。
• XPIDL：接口定義語言，生成 Java 代理類 (MozillaInterfaces.jar)。

Eclipse 專案配置

1. 下載對應平台 XULRunner SDK (含 MozillaInterfaces.jar)。
2. 將 MozillaInterfaces.jar 加入 Java Build Path。
3. SWT Browser 創建時自動檢測 Classpath 中的 jar，反射初始化 JavaXPCOM。

實戰案例 1：動態修改 DOM 節點屬性

// 獲取 XPCOM 入口：nsIWebBrowser
nsIWebBrowser webBrowser = (nsIWebBrowser) browser.getWebBrowser();
if (webBrowser == null) return;

// 獲取 DOM Window -> Document -> Element
nsIDOMWindow domWindow = webBrowser.getContentDOMWindow();
nsIDOMDocument doc = domWindow.getDocument();
nsIDOMElement input = doc.getElementById("input1");

// 修改屬性
input.setAttribute("value", "value after change");

應用場景：表單自動填充、頁面數據注入、自動化測試驗證。

實戰案例 2：編程配置代理 (Proxy) 設置

Mozilla mozilla = Mozilla.getInstance();
nsIServiceManager sm = mozilla.getServiceManager();
String contractID = "@mozilla.org/preferences-service;1";
nsIPrefService prefService = (nsIPrefService) sm.getServiceByContractID(contractID, nsIPrefService.NS_IPREFSERVICE_IID);

// 獲取配置樹根分支
nsIPrefBranch branch = prefService.getBranch("");

// 設置 HTTP 代理
branch.setCharPref("network.proxy.http", "127.0.0.1");
branch.setIntPref("network.proxy.http_port", 8080);
branch.setIntPref("network.proxy.type", 1); // 1 = 手動代理

修改即時生效，可在 about:config 驗證。

XUL：聲明式 UI 的另類選擇

XUL (XML User Interface Language) 以 XML 定義界面，擁有豐富原生控件 (tree, tabbox, deck 等)，配合 CSS 樣式與 JS 邏輯。Browser 可直接加載 .xul 文件 (本地 file:// 或 chrome:// 協議)。

簡易計算器 XUL 示例

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
<window title="Calculator" width="180"
    xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
  <vbox>
    <textbox id="display" readonly="true" value="0"/>
    <grid>
      <rows>
        <row><button label="7"/><button label="8"/><button label="9"/><button label="/"/></row>
        <row><button label="4"/><button label="5"/><button label="6"/><button label="*"/></row>
        <row><button label="1"/><button label="2"/><button label="3"/><button label="-"/></row>
        <row><button label="0"/><button label="."/><button label="="/><button label="+"/></row>
      </rows>
    </grid>
  </vbox>
</window>

另存為 calc.xul，browser.setUrl("file:///path/calc.xul") 即可運行。JS 邏輯可內聯或外部引入。

優缺點總結與選型建議

替代方案對比

• JxBrowser (商業)：基於 Chromium，API 豐富，無需系統註冊，年費昂貴。
• JavaFX WebView：內建 WebKit，純 Java，無原生依賴，但 WebKit 版本舊，JS 性能弱。
• CEF (Chromium Embedded Framework) + JNI：自研綁定，控制力最強，維護成本極高。

結語

SWT Browser + XULRunner 是「零成本、高兼容、可深度定制」的最佳平衡點。掌握 JavaXPCOM 開啟了從「單純顯示網頁」到「雙向融合桌面與 Web 技術」的大門。遷移至 Eclipse RCP 或 SWT 獨立應用均適用。