processbuilder.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 559 行 · 第 1/3 页

<CODE>&nbsp;<A HREF="../util/List.html" title="java.util 中的接口">List</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>&gt;</CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#command()">command</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此进程生成器的操作系统程序和参数。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#command(java.util.List)">command</A></B>(<A HREF="../util/List.html" title="java.util 中的接口">List</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>&gt;&nbsp;command)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置此进程生成器的操作系统程序和参数。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#command(java.lang.String...)">command</A></B>(<A HREF="String.html" title="java.lang 中的类">String</A>...&nbsp;command)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置此进程生成器的操作系统程序和参数。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.io.File</CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#directory()">directory</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此进程生成器的工作目录。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#directory(java.io.File)">directory</A></B>(java.io.File&nbsp;directory)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置此进程生成器的工作目录。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../util/Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>,<A HREF="String.html" title="java.lang 中的类">String</A>&gt;</CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#environment()">environment</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此进程生成器环境的字符串映射视图。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#redirectErrorStream()">redirectErrorStream</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;通知进程生成器是否合并标准错误和标准输出。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#redirectErrorStream(boolean)">redirectErrorStream</A></B>(boolean&nbsp;redirectErrorStream)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置此进程生成器的 <code>redirectErrorStream</code> 属性。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="Process.html" title="java.lang 中的类">Process</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="ProcessBuilder.html#start()">start</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;使用此进程生成器的属性启动一个新进程。</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>从类 java.lang.<A HREF="Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="Object.html#clone()">clone</A>, <A HREF="Object.html#equals(java.lang.Object)">equals</A>, <A HREF="Object.html#finalize()">finalize</A>, <A HREF="Object.html#getClass()">getClass</A>, <A HREF="Object.html#hashCode()">hashCode</A>, <A HREF="Object.html#notify()">notify</A>, <A HREF="Object.html#notifyAll()">notifyAll</A>, <A HREF="Object.html#toString()">toString</A>, <A HREF="Object.html#wait()">wait</A>, <A HREF="Object.html#wait(long)">wait</A>, <A HREF="Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>构造方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="ProcessBuilder(java.util.List)"><!-- --></A><H3>
ProcessBuilder</H3>
<PRE>
public <B>ProcessBuilder</B>(<A HREF="../util/List.html" title="java.util 中的接口">List</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>&gt;&nbsp;command)</PRE>
<DL>
<DD>利用指定的操作系统程序和参数构造一个进程生成器。此构造方法<i>不会</i> 制作一份 <code>command</code> 列表的副本。后续列表更新将在进程生成器的状态中反映出来。不必检查 <code>command</code> 是否为一个有效的操作系统命令。</p>
<P>
<DL>
<DT><B>参数：</B><DD><CODE>command</CODE> - 包含程序及其参数的列表
<DT><B>抛出：</B>
<DD><CODE><A HREF="NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果参数为 <code>null</code></DL>
</DL>
<HR>

<A NAME="ProcessBuilder(java.lang.String...)"><!-- --></A><H3>
ProcessBuilder</H3>
<PRE>
public <B>ProcessBuilder</B>(<A HREF="String.html" title="java.lang 中的类">String</A>...&nbsp;command)</PRE>
<DL>
<DD>利用指定的操作系统程序和参数构造一个进程生成器。这是一个有用的构造方法，它将进程生成器的命令设置为与 <code>command</code> 数组包含相同字符串的字符串列表，且顺序相同。不必检查 <code>command</code> 是否为一个有效的操作系统命令。</p>
<P>
<DL>
<DT><B>参数：</B><DD><CODE>command</CODE> - 包含程序及其参数的字符串数组</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="command(java.util.List)"><!-- --></A><H3>
command</H3>
<PRE>
public <A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A> <B>command</B>(<A HREF="../util/List.html" title="java.util 中的接口">List</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>&gt;&nbsp;command)</PRE>
<DL>
<DD>设置此进程生成器的操作系统程序和参数。此方法<i>不会</i> 制作一份 <code>command</code> 列表的副本。后续列表更新将在进程生成器的状态中反映出来。不必检查 <code>command</code> 是否为一个有效的操作系统命令。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>command</CODE> - 包含程序及其参数的列表
<DT><B>返回：</B><DD>此进程生成器
<DT><B>抛出：</B>
<DD><CODE><A HREF="NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果参数为 <code>null</code></DL>
</DD>
</DL>
<HR>

<A NAME="command(java.lang.String...)"><!-- --></A><H3>
command</H3>
<PRE>
public <A HREF="ProcessBuilder.html" title="java.lang 中的类">ProcessBuilder</A> <B>command</B>(<A HREF="String.html" title="java.lang 中的类">String</A>...&nbsp;command)</PRE>
<DL>
<DD>设置此进程生成器的操作系统程序和参数。这是一个有用的方法，它将命令设置为与 <code>command</code> 数组包含相同字符串的字符串列表，且顺序相同。不必检查 <code>command</code> 是否为一个有效的操作系统命令。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>command</CODE> - 包含程序及其参数的字符串数组
<DT><B>返回：</B><DD>此进程生成器</DL>
</DD>
</DL>
<HR>

<A NAME="command()"><!-- --></A><H3>
command</H3>
<PRE>
public <A HREF="../util/List.html" title="java.util 中的接口">List</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>&gt; <B>command</B>()</PRE>
<DL>
<DD>返回此进程生成器的操作系统程序和参数。该返回的列表<i>不是</i> 一份副本。后续列表更新将在此进程生成器的状态中反映出来。</p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>此进程生成器的程序及其参数</DL>
</DD>
</DL>
<HR>

<A NAME="environment()"><!-- --></A><H3>
environment</H3>
<PRE>
public <A HREF="../util/Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="String.html" title="java.lang 中的类">String</A>,<A HREF="String.html" title="java.lang 中的类">String</A>&gt; <B>environment</B>()</PRE>
<DL>
<DD>返回此进程生成器环境的字符串映射视图。

无论进程生成器何时创建，都需要将环境初始化为一份当前进程环境的副本（请参阅 <A HREF="System.html#getenv()"><CODE>System.getenv()</CODE></A>）。由此对象的 <A HREF="ProcessBuilder.html#start()"><CODE>start()</CODE></A> 方法启动的后续子进程将使用这一映射作为它们的环境。

<p>可以使用普通的 <A HREF="../util/Map.html" title="java.util 中的接口"><CODE>Map</CODE></A> 操作来修改返回的对象。对于通过 <A HREF="ProcessBuilder.html#start()"><CODE>start()</CODE></A> 方法启动的子进程，这些修改是可见的。两个 <code>ProcessBuilder</code> 实例总是包含独立的进程环境，因此，针对返回的映射的更改从不会在任何其他 <code>ProcessBuilder</code> 实例或由 <A HREF="System.html#getenv(java.lang.String)"><CODE>System.getenv</CODE></A> 返回的值中反映出来。

<p>如果系统不支持环境变量，将返回空映射。

<p>返回的映射不允许空键或空值。试图插入空键或空值或者试图查询它们的存在，都将抛出 <A HREF="NullPointerException.html" title="java.lang 中的类"><CODE>NullPointerException</CODE></A>。试图查询非 <A HREF="String.html" title="java.lang 中的类"><CODE>String</CODE></A> 类型的键或值的存在，都将抛出 <A HREF="ClassCastException.html" title="java.lang 中的类"><CODE>ClassCastException</CODE></A>。