桌面應用程式常需引導使用者開啟官網、線上文件、OAuth 授權頁等。Java 6 引入的 java.awt.Desktop API 提供跨平台的原生整合,無需依賴第三方庫。
Desktop 類別封裝了與原生桌面環境的互動:
browse(URI uri):用預設瀏覽器開啟網址open(File file):用關聯應用程式開啟檔案edit(File file):用編輯器開啟檔案print(File file):列印檔案mail() / mail(URI mailto):開啟郵件客戶端package com.yifang.demo;
import java.awt.Desktop;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
public class OpenPageDemo {
public static void main(String[] args) {
String url = "https://www.example.com"; // 建議使用 HTTPS
try {
// 1. 建立 URI 物件(會驗證語法)
URI uri = new URI(url);
// 2. 取得 Desktop 實例
Desktop desktop = Desktop.getDesktop();
// 3. 檢查平台是否支援 BROWSE 動作
if (desktop.isSupported(Desktop.Action.BROWSE)) {
// 4. 開啟瀏覽器(非阻塞,立即返回)
desktop.browse(uri);
System.out.println("已請求開啟瀏覽器:" + url);
} else {
System.err.println("當前平台不支援開啟瀏覽器功能");
fallbackOpen(url);
}
} catch (URISyntaxException e) {
System.err.println("無效的 URL 格式:" + url);
e.printStackTrace();
} catch (IOException e) {
System.err.println("無法啟動瀏覽器(可能無桌面環境或權限不足)");
e.printStackTrace();
} catch (NullPointerException e) {
System.err.println("URI 為 null");
e.printStackTrace();
}
}
/**
* 降級方案:使用 Runtime.exec 呼叫系統指令
*/
private static void fallbackOpen(String url) {
String os = System.getProperty("os.name").toLowerCase();
try {
if (os.contains("win")) {
Runtime.getRuntime().exec(new String[]{"cmd", "/c", "start", "", url});
} else if (os.contains("mac")) {
Runtime.getRuntime().exec(new String[]{"open", url});
} else if (os.contains("nix") || os.contains("nux")) {
Runtime.getRuntime().exec(new String[]{"xdg-open", url});
}
} catch (IOException ex) {
System.err.println("降級方案也失敗:" + ex.getMessage());
}
}
}
| 情況 | 處理方式 |
|---|---|
| Headless 伺服器環境 | Desktop.isDesktopSupported() 回傳 false,需用降級方案或拋出業務例外 |
| 安全管理器限制 | 簽名 JAR 或配置 policy 檔授予 AWTPermission "accessDesktop" |
| URL 包含中文/特殊字元 | 必須先 URLEncoder.encode 再建立 URI,或使用 URI.create()(不編碼) |
| 多次快速呼叫 | 部分瀏覽器會合併分頁,屬正常行為 |
若業務強制要求特定瀏覽器(如 Chrome),需放棄 Desktop,改用 ProcessBuilder 呼叫執行檔:
public static void openWithChrome(String url) throws IOException {
String chromePath = "C:/Program Files/Google/Chrome/Application/chrome.exe"; // Windows 範例
ProcessBuilder pb = new ProcessBuilder(chromePath, "--new-window", url);
pb.start();
}
Desktop.browse() 是 Java 桌面應用開啟網頁的標準方式,程式碼簡潔、跨平台。實務上務必檢查 isSupported()、處理例外、提供降級方案,確保在無桌面環境(CI/CD、Docker、伺服器)下不會當機。