原文：http://zetcode.com/java/processbuilder/

Java ProcessBuilder教程显示了如何使用ProcessBuilder创建操作系统进程。

ProcessBuilder

ProcessBuilder用于创建操作系统进程。 其start()方法创建具有以下属性的新Process实例：

  • 命令
  • 环境
  • 工作目录
  • 输入来源
  • 标准输出和标准错误输出的目标
  • redirectErrorStream

ProcessBuilder运行程序

用command()执行程序。 使用waitFor()，我们可以等待过程完成。

ExecuteProgram.java

  1. package com.zetcode;
  3. import java.io.IOException;
  5. public class ExecuteProgram {
  7.     public static void main(String[] args) throws IOException, InterruptedException {
  9.         var processBuilder = new ProcessBuilder();
  11.         processBuilder.command("notepad.exe");
  13.         var process = processBuilder.start();
  15.         var ret = process.waitFor();
  17.         System.out.printf("Program exited with code: %d", ret);
  18.     }
  19. }

该程序执行 Windows 记事本应用。 它返回其退出代码。

ProcessBuilder命令输出

以下示例执行命令并显示其输出。

ProcessBuilderEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.IOException;
  5. import java.io.InputStreamReader;
  7. public class ProcessBuilderEx {
  9.     public static void main(String[] args) throws IOException {
  11.         var processBuilder = new ProcessBuilder();
  13.         processBuilder.command("cal", "2019", "-m 2");
  15.         var process = processBuilder.start();
  17.         try (var reader = new BufferedReader(
  18.             new InputStreamReader(process.getInputStream()))) {
  20.             String line;
  22.             while ((line = reader.readLine()) != null) {
  23.                 System.out.println(line);
  24.             }
  26.         }
  27.     }
  28. }

该示例运行 Linux cal命令。

  1. processBuilder.command("cal", "2019", "-m 2");

command()执行cal程序。 其他参数是程序的选项。 为了在 Windows 机器上运行命令，我们可以使用以下命令：processBuilder.command("cmd.exe", "/c", "ping -n 3 google.com")。

  1. var process = processBuilder.start();

start()启动了该过程。

  1. try (var reader = new BufferedReader(
  2.     new InputStreamReader(process.getInputStream()))) {

使用getInputStream()方法，我们从流程的标准输出中获取输入流。

  1. February 2019      
  2. Su Mo Tu We Th Fr Sa  
  3.                 1  2  
  4.     3  4  5  6  7  8  9  
  5. 10 11 12 13 14 15 16  
  6. 17 18 19 20 21 22 23  
  7. 24 25 26 27 28

这是输出。

ProcessBuilder重定向输出

使用redirectOutput()，我们可以重定向流程构建器的标准输出目的地。

RedirectOutputEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.File;
  5. import java.io.IOException;
  6. import java.io.InputStreamReader;
  8. public class RedirectOutputEx {
  10.     public static void main(String[] args) throws IOException {
  12.         var homeDir = System.getProperty("user.home");
  14.         var processBuilder = new ProcessBuilder();
  16.         processBuilder.command("cmd.exe", "/c", "date /t");
  18.         var fileName = new File(String.format("%s/Documents/tmp/output.txt", homeDir));
  20.         processBuilder.redirectOutput(fileName);
  22.         var process = processBuilder.start();
  24.         try (var reader = new BufferedReader(
  25.                 new InputStreamReader(process.getInputStream()))) {
  27.             String line;
  28.             while ((line = reader.readLine()) != null) {
  29.                 System.out.println(line);
  30.             }
  31.         }
  32.     }
  33. }

该程序将构建器的输出重定向到文件。 它运行 Windows date命令。

  1. processBuilder.redirectOutput(fileName);

我们将流程构建器的标准输出重定向到文件。

  1. try (var reader = new BufferedReader(
  2.     new InputStreamReader(process.getInputStream()))) {
  4.     String line;
  5.     while ((line = reader.readLine()) != null) {
  6.         System.out.println(line);
  7.     }
  8. }

现在输出到文件。

  1. $ echo %cd%
  2. C:\Users\Jano\Documents\tmp
  3. $ more output.txt
  4. Thu 02/14/2019

当前日期已写入output.txt文件。

ProcessBuilder重定向输入和输出

下一个示例同时重定向输入和输出。

src/resources/input.txt

  1. sky
  2. blue
  3. steel
  4. morning
  5. coffee
  6. earth
  7. forest

这是input.txt文件的内容。

ProcessBuilderRedirectIOEx.java

  1. package com.zetcode;
  3. import java.io.File;
  4. import java.io.IOException;
  6. public class ProcessBuilderRedirectIOEx {
  8.     public static void main(String[] args) throws IOException {
  10.         var processBuilder = new ProcessBuilder();
  12.         processBuilder.command("cat")
  13.                 .redirectInput(new File("src/resources", "input.txt"))
  14.                 .redirectOutput(new File("src/resources/", "output.txt"))
  15.                 .start();
  16.     }
  17. }

在程序中，我们将输入从input.txt文件重定向到cat命令，并将命令的输出重定向到output.txt文件。

ProcessBuilder继承 IO

inheritIO()将子流程标准 I/O 的源和目的地设置为与当前 Java 流程相同。

ProcessBuilderInheritIOEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  5. public class ProcessBuilderInheritIOEx {
  7.     public static void main(String[] args) throws IOException, InterruptedException {
  9.         var processBuilder = new ProcessBuilder();
  11.         processBuilder.command("cmd.exe", "/c", "dir");
  13.         var process = processBuilder.inheritIO().start();
  15.         int exitCode = process.waitFor();
  16.         System.out.printf("Program ended with exitCode %d", exitCode);
  17.     }
  18. }

通过继承已执行命令的 IO，我们可以跳过读取步骤。 程序输出项目目录的内容和显示退出代码的消息。

  1. 02/14/2019  04:55 PM    <DIR>          .
  2. 02/14/2019  04:55 PM    <DIR>          ..
  3. 02/19/2019  01:11 PM    <DIR>          .idea
  4. 02/14/2019  04:55 PM    <DIR>          out
  5. 02/14/2019  04:52 PM                     433 ProcessBuilderInheritIOEx.iml
  6. 02/14/2019  04:53 PM    <DIR>          src
  7.                 1 File(s)            433 bytes
  8.                 5 Dir(s)  157,350,264,832 bytes free
  9. Program ended with exitCode 0

我们同时获得执行的命令和自己的 Java 程序的输出。

ProcessBuilder环境

environment()方法返回流程构建器环境的字符串映射视图。

ProcessBuilderEnvEx.java

  1. package com.zetcode;
  3. public class ProcessBuilderEnvEx {
  5.     public static void main(String[] args) {
  7.         var pb = new ProcessBuilder();
  8.         var env = pb.environment();
  10.         env.forEach((s, s2) -> {
  11.             System.out.printf("%s %s %n", s, s2);
  12.         });
  14.         System.out.printf("%s %n", env.get("PATH"));
  15.     }
  16. }

该程序显示所有环境变量。

  1. configsetroot C:\WINDOWS\ConfigSetRoot 
  2. USERDOMAIN_ROAMINGPROFILE LAPTOP-OBKOFV9J 
  3. LOCALAPPDATA C:\Users\Jano\AppData\Local 
  4. PROCESSOR_LEVEL 6 
  5. USERDOMAIN LAPTOP-OBKOFV9J 
  6. LOGONSERVER \\LAPTOP-OBKOFV9J 
  7. JAVA_HOME C:\Users\Jano\AppData\Local\Programs\Java\openjdk-11\ 
  8. SESSIONNAME Console 
  9. ...

这是 Windows 上的示例输出。

在下一个程序中，我们定义一个自定义环境变量。

ProcessBuilderEnvEx2.java

  1. package com.zetcode;
  3. import java.io.IOException;
  5. public class ProcessBuilderEnvEx2 {
  7.     public static void main(String[] args) throws IOException {
  9.         var pb = new ProcessBuilder();
  10.         var env = pb.environment();
  12.         env.put("mode", "development");
  14.         pb.command("cmd.exe", "/c", "echo", "%mode%");
  16.         pb.inheritIO().start();
  17.     }
  18. }

该程序定义一个mode变量并在 Windows 上输出。

  1. pb.command("cmd.exe", "/c", "echo", "%mode%");

%mode%是 Windows 的环境变量语法； 在 Linux 上，我们使用$mode。

ProcessBuilder目录

directory()方法设置流程构建器的工作目录。

ProcessBuilderDirectoryEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.File;
  5. import java.io.IOException;
  6. import java.io.InputStreamReader;
  8. public class ProcessBuilderDirectoryEx {
  10.     public static void main(String[] args) throws IOException {
  12.         var homeDir = System.getProperty("user.home");
  14.         var pb = new ProcessBuilder();
  16.         pb.command("cmd.exe", "/c", "dir");
  17.         pb.directory(new File(homeDir));
  19.         var process = pb.start();
  21.         try (var reader = new BufferedReader(
  22.                 new InputStreamReader(process.getInputStream()))) {
  24.             String line;
  25.             while ((line = reader.readLine()) != null) {
  26.                 System.out.println(line);
  27.             }
  28.         }
  29.     }
  30. }

该示例将主目录设置为流程生成器的当前目录。 我们显示主目录的内容。

  1. var homeDir = System.getProperty("user.home");

我们得到用户的主目录。

  1. pb.command("cmd.exe", "/c", "dir");

我们定义了一个在 Windows 上执行dir程序的命令。

  1. pb.directory(new File(homeDir));

我们设置流程构建器的目录。

  1. Volume in drive C is Windows
  2. Volume Serial Number is 4415-13BB
  4. Directory of C:\Users\Jano
  6. 02/14/2019  11:48 AM    <DIR>          .
  7. 02/14/2019  11:48 AM    <DIR>          ..
  8. 10/13/2018  08:38 AM    <DIR>          .android
  9. 01/31/2019  10:58 PM               281 .bash_history
  10. 12/17/2018  03:02 PM    <DIR>          .config
  11. ...

这是一个示例输出。

ProcessBuilder非阻塞操作

在下面的示例中，我们创建一个异步过程。

ProcessBuilderNonBlockingEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.IOException;
  5. import java.io.InputStream;
  6. import java.io.InputStreamReader;
  7. import java.util.List;
  8. import java.util.concurrent.Callable;
  9. import java.util.concurrent.ExecutionException;
  10. import java.util.concurrent.Executors;
  11. import java.util.concurrent.Future;
  12. import java.util.concurrent.TimeUnit;
  13. import java.util.concurrent.TimeoutException;
  14. import java.util.stream.Collectors;
  16. public class ProcessBuilderNonBlockingEx {
  18.     public static void main(String[] args) throws InterruptedException,
  19.             ExecutionException, TimeoutException, IOException {
  21.         var executor = Executors.newSingleThreadExecutor();
  23.         var processBuilder = new ProcessBuilder();
  25.         processBuilder.command("cmd.exe", "/c", "ping -n 3 google.com");
  27.         try {
  29.             var process = processBuilder.start();
  31.             System.out.println("processing ping command ...");
  32.             var task = new ProcessTask(process.getInputStream());
  33.             Future<List<String>> future = executor.submit(task);
  35.             // non-blocking, doing other tasks
  36.             System.out.println("doing task1 ...");
  37.             System.out.println("doing task2 ...");
  39.             var results = future.get(5, TimeUnit.SECONDS);
  41.             for (String res : results) {
  42.                 System.out.println(res);
  43.             }
  45.         } finally {
  46.             executor.shutdown();
  47.         }
  48.     }
  50.     private static class ProcessTask implements Callable<List<String>> {
  52.         private InputStream inputStream;
  54.         public ProcessTask(InputStream inputStream) {
  55.             this.inputStream = inputStream;
  56.         }
  58.         @Override
  59.         public List<String> call() {
  60.             return new BufferedReader(new InputStreamReader(inputStream))
  61.                     .lines()
  62.                     .collect(Collectors.toList());
  63.         }
  64.     }
  65. }

该程序创建一个在控制台上运行ping命令的进程。 它在Executors.newSingleThreadExecutor()方法的帮助下在单独的线程中执行。

  1. processing ping command ...
  2. doing task1 ...
  3. doing task2 ...
  5. Pinging google.com [2a00:1450:4001:825::200e] with 32 bytes of data:
  6. Reply from 2a00:1450:4001:825::200e: time=108ms 
  7. Reply from 2a00:1450:4001:825::200e: time=111ms 
  8. Reply from 2a00:1450:4001:825::200e: time=112ms 
  10. Ping statistics for 2a00:1450:4001:825::200e:
  11.     Packets: Sent = 3, Received = 3, Lost = 0 (0% loss),
  12. Approximate round trip times in milli-seconds:
  13.     Minimum = 108ms, Maximum = 112ms, Average = 110ms

这是输出。

ProcessBuilder管道操作

管道是一种用于将信息从一个程序进程传递到另一个程序进程的技术。

ProcessBuilderPipeEx.java

  1. package com.zetcode;
  3. import java.io.File;
  4. import java.io.IOException;
  6. public class ProcessBuilderPipeEx {
  8.     public static void main(String[] args) throws IOException {
  10.         var homeDir = System.getProperty("user.home");
  12.         var processBuilder = new ProcessBuilder();
  14.         processBuilder.command("cmd.exe", "/c", "dir | grep [dD]o");
  16.         processBuilder.directory(new File(homeDir));
  17.         processBuilder.inheritIO().start();
  18.     }
  19. }

该示例通过管道（|）将信息从dir命令发送到grep命令。

  1. Volume in drive C is Windows
  2. 11/14/2018  06:57 PM    <DIR>          .dotnet
  3. 02/18/2019  10:54 PM    <DIR>          Documents
  4. 02/17/2019  01:11 AM    <DIR>          Downloads

这是输出。

在本教程中，我们使用 Java 的ProcessBuilder执行 OS 进程。 您可能也对相关教程感兴趣： Java Files.walk教程和 Java 教程。