CodeGym /課程 /JAVA 25 SELF /ProcessBuilder — 啟動外部行程

ProcessBuilder — 啟動外部行程

JAVA 25 SELF
等級 61, 課堂 0
開放

1. 作業系統中的行程是什麼,以及為什麼要從 Java 啟動它們

行程:從 JVM 到 bash,再回來

當你開啟電腦並打開瀏覽器、通訊軟體或遊戲——這些都是獨立的 行程。作業系統會為每個程式啟動自己的「小世界」:分配記憶體、CPU 時間,允許存取檔案與網路。這樣一來,程式彼此並存,卻不會互相干擾。

Java 程式也不例外。當你執行 java MyApp 時,系統會為它建立一個具有所有必要資源的獨立行程。在這個行程裡,才是你的程式實際運作的地方:計算、繪圖、讀寫檔案——該做的都在其中完成。

但有時光靠 Java 還不夠。你可能需要請另一個程式幫忙——啟動壓縮工具來打包檔案、呼叫 ffmpeg 處理影片,或只是想知道電腦上安裝的是哪個版本的 Java。這就是啟動外部行程:Java 對系統說「幫我呼叫這個工具」,然後取得其執行結果。

本質上,這能讓你的程式更具彈性:把不同工具組合起來、自動化日常作業,或把你的邏輯嵌入既有的系統流程中。有時候,請外部指令替你完成一部分,比在程式碼中重新造輪子更划算。

JVM 與外部行程

JVM 行程——在 Java 虛擬機器中執行的你的程式。

外部行程——任何其他程式:計算機、Python 腳本、命令列,甚至另一個 Java 執行個體。

2. 類別 ProcessBuilder

在「古早」的年代,Java 透過方法 Runtime.getRuntime().exec() 來啟動行程。這並不是最方便且安全的方式——就像拿顯微鏡來釘釘子。因此從 Java 5 開始出現了類別 ProcessBuilder,它能以更彈性、易懂的方式建立、設定並啟動外部行程。

ProcessBuilder 就像一個「組裝器」,可以事先設定未來行程的所有參數:指令、引數、工作資料夾、環境變數等等。

語法:建立行程

ProcessBuilder pb = new ProcessBuilder("命令", "引數1", "引數2", ...);
  • 第一個引數——指令名稱(例如 "ls"、"dir"、"ping"、"java")。
  • 其餘——該指令所需的參數。

範例:啟動指令 ls(Linux/Mac)或 dir(Windows)

ProcessBuilder pb;
if (System.getProperty("os.name").toLowerCase().contains("win")) {
    pb = new ProcessBuilder("cmd.exe", "/c", "dir");
} else {
    pb = new ProcessBuilder("ls", "-l");
}

順帶一提,在 Windows 中,像 dir、copy 這類指令並不是獨立的可執行檔,而是命令列(cmd.exe)內建的指令。因此需要透過 cmd.exe /c ... 來啟動它們。

範例:啟動一個簡單行程

ProcessBuilder pb = new ProcessBuilder("echo", "Hello, Java!");

3. 設定行程環境

傳遞引數。 指令的引數以獨立字串傳入:

ProcessBuilder pb = new ProcessBuilder("ping", "google.com");

指定工作目錄。 預設情況下,行程會在與你的程式相同的資料夾中啟動。不過也可以明確指定其他目錄:

pb.directory(new java.io.File("/tmp"));      // 適用於 Linux/Mac
pb.directory(new java.io.File("C:\\Temp"));  // 適用於 Windows

修改環境變數。 每個行程都有自己的環境變數集合。可以加入或修改它們:

pb.environment().put("MY_VAR", "HelloFromJava");

如果外部行程需要特定的環境變數,這會很有用。

4. 啟動行程

方法 start()。當你都設定好之後,就可以啟動行程了:

Process process = pb.start();

方法 start() 會回傳一個 Process 物件,你可以用它來管理已啟動的程式:讀取它的輸出、寫入它的輸入、終止它等等。

例外處理。 start() 可能拋出 IOException,例如找不到指令、沒有權限,或啟動時發生其他錯誤。

範例:

try {
    Process process = pb.start();
    // 與行程互動...
} catch (IOException e) {
    System.out.println("啟動行程時發生錯誤: " + e.getMessage());
}

5. 實作:啟動簡單指令

範例 1:列出資料夾中的檔案

import java.io.*;

public class ProcessDemo {
    public static void main(String[] args) {
        // 根據作業系統選擇正確指令
        ProcessBuilder pb;
        if (System.getProperty("os.name").toLowerCase().contains("win")) {
            pb = new ProcessBuilder("cmd.exe", "/c", "dir");
        } else {
            pb = new ProcessBuilder("ls", "-l");
        }

        try {
            Process process = pb.start();

            // 讀取行程輸出 (stdout)
            BufferedReader reader = new BufferedReader(
                    new InputStreamReader(process.getInputStream())
            );
            String line;
            while ((line = reader.readLine()) != null) {
                System.out.println(line);
            }

            // 等待行程結束
            int exitCode = process.waitFor();
            System.out.println("行程已結束,代碼: " + exitCode);

        } catch (IOException | InterruptedException e) {
            System.out.println("錯誤: " + e.getMessage());
        }
    }
}

這裡發生了什麼事?

  • 判斷作業系統,以選擇正確的指令。
  • 建立含所需指令的 ProcessBuilder。
  • 透過 start() 啟動行程。
  • 從行程的 stdout 讀取每一行並印出。
  • 等待行程結束(waitFor())。
  • 輸出結束碼(0——成功,其他——錯誤)。

範例 2:啟動 java -version

ProcessBuilder pb = new ProcessBuilder("java", "-version");
try {
    Process process = pb.start();

    // java -version 輸出到 stderr,所以讀取 getErrorStream()
    BufferedReader reader = new BufferedReader(
        new InputStreamReader(process.getErrorStream())
    );
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println(line);
    }
    process.waitFor();
} catch (IOException | InterruptedException e) {
    e.printStackTrace();
}

重要細節: 某些指令(例如 java -version)不會將資訊寫到標準輸出(stdout),而是寫到錯誤輸出(stderr)。因此有時需要讀取 process.getErrorStream()。

6. 跨平台性:Windows 與 Linux/Mac 的差異

  • 指令及其參數可能不同。
  • 檔案路徑的寫法不同(C:\Temp vs /tmp)。
  • 某些指令(例如 ls、cat)只在類 Unix 系統上存在,在 Windows 則有對應替代(dir、type)。
  • 在 Windows,內建指令只能透過 cmd.exe /c 指令 啟動。

範例:檢查作業系統:

String os = System.getProperty("os.name").toLowerCase();
if (os.contains("win")) {
    // Windows
} else if (os.contains("mac")) {
    // macOS
} else if (os.contains("nix") || os.contains("nux")) {
    // Linux
}

建議: 如果你期望程式具備跨平台性,務必在目標作業系統上進行測試。

7. 表格:ProcessBuilder 的主要方法與功能

方法/欄位 用途 使用範例
new ProcessBuilder(String...)
以指令與引數建立行程
new ProcessBuilder("ls", "-l")
.directory(File)
設定工作目錄
.directory(new File("/tmp"))
.environment()
取得/修改環境變數
.environment().put("VAR", "value")
.start()
啟動行程
Process p = pb.start()
Process.getInputStream()
取得行程的 stdout
InputStream
Process.getErrorStream()
取得行程的 stderr
InputStream
Process.getOutputStream()
取得行程的 stdin
OutputStream
Process.waitFor()
等待行程結束
int code = p.waitFor()
Process.exitValue()
取得行程的結束碼
int code = p.exitValue()

8. 啟動外部行程時的常見錯誤

錯誤 №1:找不到指令。 如果你把指令名稱打錯,或系統中不存在該指令,就會得到 IOException:Cannot run program ...。例如在 Windows 上嘗試啟動 ls。

錯誤 №2:引數傳遞方式錯誤。 不要把整個指令串成一個字串!正確:new ProcessBuilder("ping", "google.com")。錯誤:new ProcessBuilder("ping google.com")。

錯誤 №3:忽略作業系統差異。 在 Linux 上運作完美的指令,可能在 Windows 上根本不存在,反之亦然。務必檢查 OS 並調整指令。

錯誤 №4:未處理行程輸出。 如果不讀取行程輸出,行程可能因緩衝區滿而「卡住」。即使不打算使用輸出——也要讀取,並在需要時忽略之。

錯誤 №5:未關閉串流。 使用完行程的串流後記得關閉,以避免資源外洩。

錯誤 №6:未處理例外。 啟動外部行程具有風險。請務必使用 try-catch 並將錯誤資訊告知使用者。

1
任務
JAVA 25 SELF, 等級 61, 課堂 0
上鎖
系統檢查員 🖥️
系統檢查員 🖥️
1
任務
JAVA 25 SELF, 等級 61, 課堂 0
上鎖
數位探路者 📁
數位探路者 📁
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION