一、概述
ProcessBuilder類是J2SE 1.5在java.lang中新新增的一個新類,此類用於建立作業系統程式,它提供一種啟動和管理程式(也就是應用程式)的方法。在J2SE 1.5之前,都是由Process類處來實現程式的控制管理。
每個 ProcessBuilder 例項管理一個程式屬性集。它的start() 方法利用這些屬性建立一個新的 Process 例項。start() 方法可以從同一例項重複呼叫,以利用相同的或相關的屬性建立新的子程式。 (我在《深入研究java.lang.Runtime類》中講過,程式也可以由Runtime.exec()啟動。)
ProcessBuilder類是J2SE 1.5在java.lang中新新增的一個新類,此類用於建立作業系統程式,它提供一種啟動和管理程式(也就是應用程式)的方法。在J2SE 1.5之前,都是由Process類處來實現程式的控制管理。
每個 ProcessBuilder 例項管理一個程式屬性集。它的start() 方法利用這些屬性建立一個新的 Process 例項。start() 方法可以從同一例項重複呼叫,以利用相同的或相關的屬性建立新的子程式。 (我在《深入研究java.lang.Runtime類》中講過,程式也可以由Runtime.exec()啟動。)
每個程式生成器(即ProcessBuilder物件)管理這些程式屬性:
命令 是一個字串列表,它表示要呼叫的外部程式檔案及其引數(如果有)。在此,表示有效的作業系統命令的字串列表是依賴於系統的。例如,每一個總體變數,通常都要成為此列表中的元素,但有一些作業系統,希望程式能自己標記命令列字串——在這種系統中,Java 實現可能需要命令確切地包含這兩個元素。
環境 是從變數 到值 的依賴於系統的對映。初始值是當前程式環境的一個副本(請參閱 System.getenv())。
工作目錄。預設值是當前程式的當前工作目錄,通常根據系統屬性 user.dir 來命名。
redirectErrorStream 屬性。最初,此屬性為 false,意思是子程式的標準輸出和錯誤輸出被髮送給兩個獨立的流,這些流可以通過 Process.getInputStream() 和 Process.getErrorStream() 方法來訪問。如果將值設定為 true,標準錯誤將與標準輸出合併。這使得關聯錯誤訊息和相應的輸出變得更容易。在此情況下,合併的資料可從 Process.getInputStream() 返回的流讀取,而從 Process.getErrorStream() 返回的流讀取將直接到達檔案尾。
環境 是從變數 到值 的依賴於系統的對映。初始值是當前程式環境的一個副本(請參閱 System.getenv())。
工作目錄。預設值是當前程式的當前工作目錄,通常根據系統屬性 user.dir 來命名。
redirectErrorStream 屬性。最初,此屬性為 false,意思是子程式的標準輸出和錯誤輸出被髮送給兩個獨立的流,這些流可以通過 Process.getInputStream() 和 Process.getErrorStream() 方法來訪問。如果將值設定為 true,標準錯誤將與標準輸出合併。這使得關聯錯誤訊息和相應的輸出變得更容易。在此情況下,合併的資料可從 Process.getInputStream() 返回的流讀取,而從 Process.getErrorStream() 返回的流讀取將直接到達檔案尾。
既然有Process類,那為什麼還要發明個ProcessBuilder類呢?ProcessBuilder和Process兩個類有什麼區別呢?
原來,ProcessBuilder為程式提供了更多的控制,例如,可以設定當前工作目錄,還可以改變環境引數。而Process的功能相對來說簡單的多。
ProcessBuilder是一個final類,有兩個帶引數的構造方法,你可以通過構造方法來直接建立ProcessBuilder的物件。而Process是一個抽象類,一般都通過Runtime.exec()和ProcessBuilder.start()來間接建立其例項。
原來,ProcessBuilder為程式提供了更多的控制,例如,可以設定當前工作目錄,還可以改變環境引數。而Process的功能相對來說簡單的多。
ProcessBuilder是一個final類,有兩個帶引數的構造方法,你可以通過構造方法來直接建立ProcessBuilder的物件。而Process是一個抽象類,一般都通過Runtime.exec()和ProcessBuilder.start()來間接建立其例項。
注意:
修改程式構建器的屬性將影響後續由該物件的 start() 方法啟動的程式,但從不會影響以前啟動的程式或 Java 自身的程式。
ProcessBuilder類不是同步的。如果多個執行緒同時訪問一個 ProcessBuilder,而其中至少一個執行緒從結構上修改了其中一個屬性,它必須 保持外部同步。
修改程式構建器的屬性將影響後續由該物件的 start() 方法啟動的程式,但從不會影響以前啟動的程式或 Java 自身的程式。
ProcessBuilder類不是同步的。如果多個執行緒同時訪問一個 ProcessBuilder,而其中至少一個執行緒從結構上修改了其中一個屬性,它必須 保持外部同步。
很容易啟動一個使用預設工作目錄和環境的新程式:
Process p = new ProcessBuilder(“myCommand”, “myArg”).start();
下面是一個利用修改過的工作目錄和環境啟動程式的例子:
ProcessBuilder pb = new ProcessBuilder(“myCommand”, “myArg1”, “myArg2”);
Map<String, String> env = pb.environment();
env.put(“VAR1”, “myValue”);
env.remove(“OTHERVAR”);
env.put(“VAR2”, env.get(“VAR1”) + “suffix”);
pb.directory(“myDir”);
Process p = pb.start();
要利用一組明確的環境變數啟動程式,在新增環境變數之前,首先呼叫 Map.clear()。
Map<String, String> env = pb.environment();
env.put(“VAR1”, “myValue”);
env.remove(“OTHERVAR”);
env.put(“VAR2”, env.get(“VAR1”) + “suffix”);
pb.directory(“myDir”);
Process p = pb.start();
要利用一組明確的環境變數啟動程式,在新增環境變數之前,首先呼叫 Map.clear()。
二、API預覽
構造方法摘要
ProcessBuilder(List<String> command)
利用指定的作業系統程式和引數構造一個程式生成器。
ProcessBuilder(String… command)
利用指定的作業系統程式和引數構造一個程式生成器。
構造方法摘要
ProcessBuilder(List<String> command)
利用指定的作業系統程式和引數構造一個程式生成器。
ProcessBuilder(String… command)
利用指定的作業系統程式和引數構造一個程式生成器。
方法摘要
command()
返回此程式生成器的作業系統程式和引數。
command(List<String> command)
設定此程式生成器的作業系統程式和引數。
command(String… command)
設定此程式生成器的作業系統程式和引數。
directory()
返回此程式生成器的工作目錄。
directory(File directory)
設定此程式生成器的工作目錄。
environment()
返回此程式生成器環境的字串對映檢視。
redirectErrorStream()
通知程式生成器是否合併標準錯誤和標準輸出。
redirectErrorStream(boolean redirectErrorStream)
設定此程式生成器的 redirectErrorStream 屬性。
start()
使用此程式生成器的屬性啟動一個新程式。
command()
返回此程式生成器的作業系統程式和引數。
command(List<String> command)
設定此程式生成器的作業系統程式和引數。
command(String… command)
設定此程式生成器的作業系統程式和引數。
directory()
返回此程式生成器的工作目錄。
directory(File directory)
設定此程式生成器的工作目錄。
environment()
返回此程式生成器環境的字串對映檢視。
redirectErrorStream()
通知程式生成器是否合併標準錯誤和標準輸出。
redirectErrorStream(boolean redirectErrorStream)
設定此程式生成器的 redirectErrorStream 屬性。
start()
使用此程式生成器的屬性啟動一個新程式。
三、常見應用
若要使用ProcessBuilder建立一個程式,只需要建立ProcessBuilder的一個例項,指定該程式的名稱和所需引數。要執行此程式,呼叫該例項上的start()即可。下面上一個執行Windows記事本的例子。注意它將要編輯的檔名指定為一個引數。
若要使用ProcessBuilder建立一個程式,只需要建立ProcessBuilder的一個例項,指定該程式的名稱和所需引數。要執行此程式,呼叫該例項上的start()即可。下面上一個執行Windows記事本的例子。注意它將要編輯的檔名指定為一個引數。
class PBDemo {
public static void main(String args[]) {
try {
ProcessBuilder proc = new ProcessBuilder(“notepad.exe”, “testfile”);
proc.start();
} catch (Exception e) {
System.out.println(“Error executing notepad.”);
}
}
}
public static void main(String args[]) {
try {
ProcessBuilder proc = new ProcessBuilder(“notepad.exe”, “testfile”);
proc.start();
} catch (Exception e) {
System.out.println(“Error executing notepad.”);
}
}
}