ProcessBuilder 类

定义

[Android.Runtime.Register("java/lang/ProcessBuilder", DoNotGenerateAcw=true)]
public sealed class ProcessBuilder : Java.Lang.Object

[<Android.Runtime.Register("java/lang/ProcessBuilder", DoNotGenerateAcw=true)>]
type ProcessBuilder = class
    inherit Object

继承

Object

Object

ProcessBuilder

属性

RegisterAttribute

注解

此类用于创建操作系统进程。

每个 ProcessBuilder 实例管理进程属性的集合。 该方法 #start() 使用这些属性创建一个新 Process 实例。 #start()可以从同一实例重复调用该方法，以创建新的具有相同或相关属性的子进程。

每个进程生成器管理这些进程属性：

<ul>

<li>a command， a list of strings， which signing the external program file to be invoked and its arguments， if any. 哪些字符串列表表示有效的操作系统命令依赖于系统。 例如，每个概念参数都是此列表中的一个元素很常见，但有一些操作系统要求程序自行标记命令行字符串 -在此类系统上，Java实现可能需要命令仅包含两个元素。

<li>an environment， is a system-dependent mapping from variables to values. 初始值是当前进程环境的副本（请参阅 System#getenv()）。

<li>a working directory. 默认值是当前进程的当前工作目录，通常是由系统属性 user.dir命名的目录。

<li>“redirect-input”>a source of <i>standard input</i>. 默认情况下，子进程从管道读取输入。 Java代码可以通过返回的Process#getOutputStream()输出流访问此管道。 但是，可以使用标准输入重定向到另一个源 #redirectInput(Redirect) redirectInput。 在这种情况下，将返回 null 输出流，为此： Process#getOutputStream()

<ul><li>方法 OutputStream#write(int) write 始终引发 IOException<li>方法 OutputStream#close() close 不 <执行任何 /ul>

<li>“redirect-output”>a destination for <i>standard output</i> and <i>standard error</i>. 默认情况下，子进程将标准输出和标准错误写入管道。 Java代码可以通过返回Process#getInputStream()的输入流访问这些管道。Process#getErrorStream() 但是，标准输出和标准错误可能会重定向到使用 #redirectOutput(Redirect) redirectOutput 和 #redirectError(Redirect) redirectError的其他目标。 在这种情况下， Process#getInputStream() 和/或 Process#getErrorStream() 将返回 null 输入流，为此：

<ul><li>方法InputStream#read() read始终返回 -1<li>方法InputStream#available() available始终返回 li>该方法InputStream#close() close不<执行0<任何 /ul>

<li>a redirectErrorStream 属性。 最初，此属性意味着false子进程的标准输出和错误输出将发送到两个单独的流，可以使用和Process#getErrorStream()方法访问Process#getInputStream()这些流。

如果该值设置为 true，则：

<ul><li>标准错误与标准输出合并，并且始终发送到同一目标（这使得更轻松地将错误消息与相应的输出相关联）<li>标准错误的常见目标，使用><#redirectOutput(Redirect) redirectOutput该方法设置#redirectError(Redirect) redirectError的任何重定向都可以重定向标准输出，在创建子进程 <li>时，返回的Process#getErrorStream()流始终为 null 输入流</ul>

</ul>

修改进程生成器的属性将影响该对象#start()方法随后启动的进程，但永远不会影响以前启动的进程或Java进程本身。

大多数错误检查由 #start() 该方法执行。 可以修改对象的状态，以便失败 #start() 。 例如，除非调用，否则 #start() 将命令属性设置为空列表不会引发异常。

<strong>Note that this class is not synchronized.</strong> 如果多个线程同时访问一个 ProcessBuilder 实例，并且至少有一个线程在结构上修改其中一个属性， 则必须 在外部同步它。

启动使用默认工作目录和环境的新过程非常简单：

{@code
            Process p = new ProcessBuilder("myCommand", "myArg").start();
            }

以下示例使用修改的工作目录和环境启动进程，并重定向要追加到日志文件的标准输出和错误：

{@code
            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(new File("myDir"));
            File log = new File("log");
            pb.redirectErrorStream(true);
            pb.redirectOutput(Redirect.appendTo(log));
            Process p = pb.start();
            assert pb.redirectInput() == Redirect.PIPE;
            assert pb.redirectOutput().file() == log;
            assert p.getInputStream().read() == -1;
            }

若要使用一组显式环境变量启动进程，请先调用 java.util.Map#clear() Map.clear() ，然后再添加环境变量。

在 1.5 中添加。

适用于 . 的 java.lang.ProcessBuilderJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。