threadgroup.html

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

<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>daemon</CODE> - 如果为 <code>true</code>，则表示此线程组是一个后台程序线程组；否则，表示此线程组是一个普通线程组。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果当前线程无法修改此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="SecurityException.html" title="java.lang 中的类"><CODE>SecurityException</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setMaxPriority(int)"><!-- --></A><H3>
setMaxPriority</H3>
<PRE>
public final void <B>setMaxPriority</B>(int&nbsp;pri)</PRE>
<DL>
<DD>设置线程组的最高优先级。线程组中已有较高优先级的线程不受影响。
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
如果 <code>pri</code> 参数小于 <A HREF="Thread.html#MIN_PRIORITY"><CODE>Thread.MIN_PRIORITY</CODE></A> 或大于 <A HREF="Thread.html#MAX_PRIORITY"><CODE>Thread.MAX_PRIORITY</CODE></A>，则线程组的最高优先级保持不变。
 <p>
否则，此 ThreadGroup 对象的优先级被设置为比指定的 <code>pri</code> 参数更小，所允许的最高优先级是此线程组的父线程组的优先级。（如果此线程组是系统线程组，没有父线程组，那么只需将最高优先级设置为 <code>pri</code> 即可。）然后使用 <code>pri</code> 作为此方法的参数，以递归的方式对属于此线程组的每个线程组调用此方法。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pri</CODE> - 线程组的新优先级。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果当前线程无法修改此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="ThreadGroup.html#getMaxPriority()"><CODE>getMaxPriority()</CODE></A>, 
<A HREF="SecurityException.html" title="java.lang 中的类"><CODE>SecurityException</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="parentOf(java.lang.ThreadGroup)"><!-- --></A><H3>
parentOf</H3>
<PRE>
public final boolean <B>parentOf</B>(<A HREF="ThreadGroup.html" title="java.lang 中的类">ThreadGroup</A>&nbsp;g)</PRE>
<DL>
<DD>测试此线程组是否为线程组参数或其祖先线程组之一。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>g</CODE> - 一个线程组。
<DT><B>返回：</B><DD>如果此线程组是线程组参数或其祖先线程组之一，则返回 <code>true</code>；否则返回 <code>false</code>。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="checkAccess()"><!-- --></A><H3>
checkAccess</H3>
<PRE>
public final void <B>checkAccess</B>()</PRE>
<DL>
<DD>确定当前运行的线程是否有权修改此线程组。
 <p>
如果有安全管理器，则用此线程组作为其参数调用 <code>checkAccess</code> 方法。结果可能是抛出一个 <code>SecurityException</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程访问此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="SecurityManager.html#checkAccess(java.lang.ThreadGroup)"><CODE>SecurityManager.checkAccess(java.lang.ThreadGroup)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="activeCount()"><!-- --></A><H3>
activeCount</H3>
<PRE>
public int <B>activeCount</B>()</PRE>
<DL>
<DD>返回此线程组中活动线程的估计数。结果并不能反映并发活动，并且可能受某些系统线程的存在状态的影响。
 <p>
由于结果所固有的不精确特性，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此线程组和将此线程组作为其祖先的其他线程组中活动线程的估计数。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="enumerate(java.lang.Thread[])"><!-- --></A><H3>
enumerate</H3>
<PRE>
public int <B>enumerate</B>(<A HREF="Thread.html" title="java.lang 中的类">Thread</A>[]&nbsp;list)</PRE>
<DL>
<DD>把此线程组及其子组中的所有活动线程复制到指定数组中。
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
应用程序可以使用 <code>activeCount</code> 方法获得数组大小的估计数，但是，<i>如果数组太小而无法保持所有线程，则忽略额外的线程</i>。如果获得此线程组及其子组中的所有活动线程非常重要，则调用方应该验证返回的整数值是否确实小于 <tt>list</tt> 的长度。
 <p>
由于使用此方法所固有的竞争条件，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>list</CODE> - 放置线程列表的数组。
<DT><B>返回：</B><DD>放入数组中的线程数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程枚举此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="ThreadGroup.html#activeCount()"><CODE>activeCount()</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="enumerate(java.lang.Thread[], boolean)"><!-- --></A><H3>
enumerate</H3>
<PRE>
public int <B>enumerate</B>(<A HREF="Thread.html" title="java.lang 中的类">Thread</A>[]&nbsp;list,
                     boolean&nbsp;recurse)</PRE>
<DL>
<DD>把此线程组中的所有活动线程复制到指定数组中。如果 <code>recurse</code> 标志为 <code>true</code>，则还包括对此线程的子组中的所有活动线程的引用。如果数组太小而无法保持所有线程，则忽略额外的线程。
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
应用程序可以使用 <code>activeCount</code> 方法获得数组大小的估计数，但是，<i>如果数组太小而无法保持所有线程，则忽略额外的线程</i>。如果获得此线程组中的所有活动线程非常重要，则调用方应该验证返回的整数值是否确实小于 <tt>list</tt> 的长度。
 <p>
由于使用此方法所固有的竞争条件，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>list</CODE> - 放置线程列表的数组。<DD><CODE>recurse</CODE> - 一个标记，指示是否还包括作为此线程组的子组的线程组中的线程。
<DT><B>返回：</B><DD>放入数组中的线程数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程枚举此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="ThreadGroup.html#activeCount()"><CODE>activeCount()</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="activeGroupCount()"><!-- --></A><H3>
activeGroupCount</H3>
<PRE>
public int <B>activeGroupCount</B>()</PRE>
<DL>
<DD>返回此线程组中活动线程组的估计数。结果并不能反映并发活动。
 <p>
由于结果所固有的不精确特性，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>将此线程组作为祖先线程组的活动线程组的数量。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="enumerate(java.lang.ThreadGroup[])"><!-- --></A><H3>
enumerate</H3>
<PRE>
public int <B>enumerate</B>(<A HREF="ThreadGroup.html" title="java.lang 中的类">ThreadGroup</A>[]&nbsp;list)</PRE>
<DL>
<DD>把对此线程组中的所有活动子组的引用复制到指定数组中。
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
应用程序可以使用 <code>activeGroupCount</code> 方法获得数组大小的估计数，但是，<i>如果数组太小而无法保持所有线程组，则忽略额外的线程组</i>。如果获得此线程组中的所有活动子组非常重要，则调用方应该验证返回的整数值是否确实小于 <tt>list</tt> 的长度。
 <p>
由于使用此方法所固有的竞争条件，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>list</CODE> - 放置线程组列表的数组。
<DT><B>返回：</B><DD>放入数组中的线程组的数量。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程枚举此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="ThreadGroup.html#activeGroupCount()"><CODE>activeGroupCount()</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="enumerate(java.lang.ThreadGroup[], boolean)"><!-- --></A><H3>
enumerate</H3>
<PRE>
public int <B>enumerate</B>(<A HREF="ThreadGroup.html" title="java.lang 中的类">ThreadGroup</A>[]&nbsp;list,
                     boolean&nbsp;recurse)</PRE>
<DL>
<DD>把对此线程组中的所有活动子组的引用复制到指定数组中。如果 <code>recurse</code> 标志为 <code>true</code>，则还包括对子组的所有活动子组的引用，等等。 
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
应用程序可以使用 <code>activeGroupCount</code> 方法获得数组大小的估计数，但是，<i>如果数组太小而无法保持所有线程组，则忽略额外的线程组</i>。如果获得此线程组中的所有活动子组非常重要，则调用方应该验证返回的整数值是否确实小于 <tt>list</tt> 的长度。
 <p>
由于使用此方法所固有的竞争条件，建议只将此方法用于信息目的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>list</CODE> - 放置线程列表的数组。<DD><CODE>recurse</CODE> - 一个标记，指示是否以递归的方式枚举所有已包含的线程组。
<DT><B>返回：</B><DD>放入数组中的线程组的数量。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程枚举此线程组。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="ThreadGroup.html#activeGroupCount()"><CODE>activeGroupCount()</CODE></A>, 
<A HREF="ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="stop()"><!-- --></A><H3>
stop</H3>
<PRE>
<FONT SIZE="-1"><A HREF="Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public final void <B>stop</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>此方法具有固有的不安全性。有关详细信息，请参阅 <A HREF="Thread.html#stop()"><CODE>Thread.stop()</CODE></A>。</I>
<P>
<DD>停止此线程组中的所有线程。
 <p>
首先，不使用任何参数调用此线程组的 <code>checkAccess</code> 方法；这可能导致一个安全性异常。
 <p>
然后，此方法将对此线程组及其所有子组中的所有线程调用 <code>stop</code> 方法。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果不允许当前线程访问此线程组或线程组中的任何线程。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
<DT><B>另请参见：</B><DD><A HREF="SecurityException.html" title="java.lang 中的类"><CODE>SecurityException</CODE></A>,