java.lang.ThreadGroup翻译

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML>

<HEAD>

<TITLE>

ThreadGroup (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="ThreadGroup (Java 2 Platform SE v1.4.2)";

}

</SCRIPT>

</HEAD>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/lang/Thread.html" title="class in java.lang">PREV CLASS</A>

<A HREF="../../java/lang/ThreadLocal.html" title="class in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="ThreadGroup.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<H2>

java.lang

Class ThreadGroup</H2>

<PRE>

<A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>

<IMG SRC="../../resources/inherit.gif" ALT="extended by">java.lang.ThreadGroup

</PRE>

<HR>

<DL>

<DT>public class ThreadGroup<DT>extends <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></DL>

A thread group represents a set of threads. In addition, a thread

group can also include other thread groups. The thread groups form

a tree in which every thread group except the initial thread group

has a parent.

ThreadGroup表示一组线程。另外，一个线程组可以包含其他线程组。树形结构中的线程组除了最顶层的都有自己的父线程组。

A thread is allowed to access information about its own thread

group, but not to access information about its thread group's

parent thread group or any other thread groups.

一个线程可访问其所属的线程组，但无法访问其父线程组或其他线程组。

<DL>

<DT>Since:</DT>

</DL>

<HR>

Constructor Summary</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#ThreadGroup(java.lang.String)">ThreadGroup</A>(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)</CODE>

Constructs a new thread group. 创建一个新线程组。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#ThreadGroup(java.lang.ThreadGroup, java.lang.String)">ThreadGroup</A>(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A> parent,

<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)</CODE>

Creates a new thread group. 创建一个新线程组。</TD>

</TR>

</TABLE>

Method Summary</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#activeCount()">activeCount</A>()</CODE>

          Returns an estimate of the number of active threads in this

thread group.返回该线程组中活动线程的估计值。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#activeGroupCount()">activeGroupCount</A>()</CODE>

          Returns an estimate of the number of active groups in this

thread group. 返回该线程组中活动组的估计值。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#allowThreadSuspension(boolean)">allowThreadSuspension</A>(boolean b)</CODE>

Deprecated. The definition of this call depends on <A HREF="../../java/lang/ThreadGroup.html#suspend()"><CODE>suspend()</CODE></A>,

which is deprecated. Further, the behavior of this call

was never specified. 该调用的定义依赖于suspend()（已不支持），而且，该调用的行为从未指定。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#checkAccess()">checkAccess</A>()</CODE>

          Determines if the currently running thread has permission to

modify this thread group. 确定当前运行县城是否允许修改该线程组。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#destroy()">destroy</A>()</CODE>

          Destroys this thread group and all of its subgroups.

销毁该线程组及其所有子线程组。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#enumerate(java.lang.Thread[])">enumerate</A>(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A>[] list)</CODE>

          Copies into the specified array every active thread in this

thread group and its subgroups.

将该线程组及其子线程组中的所有活动线程拷贝到指定数组中。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#enumerate(java.lang.Thread[], boolean)">enumerate</A>(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A>[] list,

boolean recurse)</CODE>

          Copies into the specified array every active thread in this

thread group.将该线程组中的所有活动线程拷贝到指定数组中。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#enumerate(java.lang.ThreadGroup[])">enumerate</A>(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A>[] list)</CODE>

          Copies into the specified array references to every active

subgroup in this thread group.

将该线程组中的所有活动子线程组拷贝到指定数组中。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#enumerate(java.lang.ThreadGroup[], boolean)">enumerate</A>(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A>[] list,

boolean recurse)</CODE>

          Copies into the specified array references to every active

subgroup in this thread group.

将该线程组中的所有活动子线程组拷贝到指定数组中。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#getMaxPriority()">getMaxPriority</A>()</CODE>

          Returns the maximum priority of this thread group.

返回该线程组的最高优先级。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#getName()">getName</A>()</CODE>

          Returns the name of this thread group.

返回该线程组名称。</TD>

</TR>

<CODE> <A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#getParent()">getParent</A>()</CODE>

          Returns the parent of this thread group.

返回该线程组的父线程组。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#interrupt()">interrupt</A>()</CODE>

          Interrupts all threads in this thread group.

中断该线程组的所有线程。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#isDaemon()">isDaemon</A>()</CODE>

          Tests if this thread group is a daemon thread group.

判断该线程组是否是守护线程组。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#isDestroyed()">isDestroyed</A>()</CODE>

          Tests if this thread group has been destroyed.

判断该线程组是否被销毁。</TD>

</TR>

          Prints information about this thread group to the standard

output. 在标准输出中打印该线程组信息。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#parentOf(java.lang.ThreadGroup)">parentOf</A>(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A> g)</CODE>

          Tests if this thread group is either the thread group

argument or one of its ancestor thread groups.

判断该线程组是否是threadGroup参数本身或者它的祖先线程组。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#resume()">resume</A>()</CODE>

Deprecated. This method is used solely in conjunction with

<tt>Thread.suspend</tt> and <tt>ThreadGroup.suspend</tt>,

both of which have been deprecated, as they are inherently

deadlock-prone. See <A HREF="../../java/lang/Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A> for details.

该方法仅和Thread.suspend和ThreadGroup.suspend联合使用，但它们均已不推荐使用，因为容易造成死锁。详情查看Thread.suspend()。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#setDaemon(boolean)">setDaemon</A>(boolean daemon)</CODE>

          Changes the daemon status of this thread group.

改变该线程组的守护状态。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#setMaxPriority(int)">setMaxPriority</A>(int pri)</CODE>

          Sets the maximum priority of the group.

设置该线程组的最大优先级。</TD>

</TR>

Deprecated. This method is inherently unsafe. See

<A HREF="../../java/lang/Thread.html#stop()"><CODE>Thread.stop()</CODE></A> for details.

该方法本质上不安全。详情查看Thread.stop()。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#suspend()">suspend</A>()</CODE>

Deprecated. This method is inherently deadlock-prone. See

<A HREF="../../java/lang/Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A> for details.

该方法本质上不安全。详情查看Thread.suspend()。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#toString()">toString</A>()</CODE>

          Returns a string representation of this Thread group.

返回该线程组的字符串形式。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/ThreadGroup.html#uncaughtException(java.lang.Thread, java.lang.Throwable)">uncaughtException</A>(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A> t,

<A HREF="../../java/lang/Throwable.html" title="class in java.lang">Throwable</A> e)</CODE>

          Called by the Java Virtual Machine when a thread in this

thread group stops because of an uncaught exception.

当该线程组中某线程因为无法捕获的异常而停止时，Java虚拟机调用该方法。</TD>

</TR>

</TABLE>

<TD>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></TD>

</TR>

<TD><CODE><A HREF="../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>

</TR>

</TABLE>

Constructor Detail</TD>

</TR>

</TABLE>

ThreadGroup</H3>

<PRE>

public ThreadGroup(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)</PRE>

<DL>

<DD>Constructs a new thread group. The parent of this new group is

the thread group of the currently running thread.

创建一个新线程组。新线程组的父线程组即当前运行线程的线程组。

The <code>checkAccess</code> method of the parent thread group is

called with no arguments; this may result in a security exception.

调用父线程组的无参数的checkAccess方法，这可能导致安全异常。

<DT>Parameters:<DD><CODE>name</CODE> - the name of the new thread group. 新线程组的名称。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot create a

thread in the specified thread group.

当前线程不能在指定线程组中创建线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

<HR>

ThreadGroup</H3>

<PRE>

public ThreadGroup(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A> parent,

<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)</PRE>

<DL>

<DD>Creates a new thread group. The parent of this new group is the

specified thread group.

创建一个新线程组。新线程组的父线程组即当前运行线程的线程组。

The <code>checkAccess</code> method of the parent thread group is

called with no arguments; this may result in a security exception.

调用父线程组的无参数的checkAccess方法，这可能导致安全异常。

<DT>Parameters:<DD><CODE>parent</CODE> - the parent thread group. 父线程组。<DD><CODE>name</CODE> - the name of the new thread group.

新线程组的名称。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if the thread group argument is

<code>null</code>. 线程组参数为null时抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot create a

thread in the specified thread group. 当前线程不能在指定线程组中创建线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

Method Detail</TD>

</TR>

</TABLE>

getName</H3>

<PRE>

public final <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getName()</PRE>

<DL>

<DD>Returns the name of this thread group. 返回该线程组名称。

<DT>Returns:<DD>the name of this thread group. 该线程组名称。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

getParent</H3>

<PRE>

public final <A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A> getParent()</PRE>

<DL>

<DD>Returns the parent of this thread group. 返回该线程组的父线程组。

First, if the parent is not <code>null</code>, the

<code>checkAccess</code> method of the parent thread group is

called with no arguments; this may result in a security exception.

如果parent不为null，先调用父线程组的无参数的checkAccess方法，这可能导致安全异常。

<DT>Returns:<DD>the parent of this thread group. The top-level thread group

is the only thread group whose parent is <code>null</code>. 该线程组的父线程组。顶层线程组的父线程组为null。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot modify

this thread group. 当前线程不能修改该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A>,

<A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/RuntimePermission.html" title="class in java.lang"><CODE>RuntimePermission</CODE></A></DL>

</DD>

</DL>

<HR>

getMaxPriority</H3>

<PRE>

public final int getMaxPriority()</PRE>

<DL>

<DD>Returns the maximum priority of this thread group. Threads that are

part of this group cannot have a higher priority than the maximum

priority.

返回该线程组的最高优先级。该线程组中线程的优先级不可能比其高。

<DT>Returns:<DD>the maximum priority that a thread in this thread group

can have. 线程组中线程所能拥有的最高优先级。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#setMaxPriority(int)"><CODE>setMaxPriority(int)</CODE></A></DL>

</DD>

</DL>

<HR>

isDaemon</H3>

<PRE>

public final boolean isDaemon()</PRE>

<DL>

<DD>Tests if this thread group is a daemon thread group. A

daemon thread group is automatically destroyed when its last

thread is stopped or its last thread group is destroyed.

判断该线程组是否是守护线程组。守护线程组中最后一个线程停止运行或最后一个线程组被销毁，守护线程组也

自动销毁。

<DT>Returns:<DD><code>true</code> if this thread group is a daemon thread group;

<code>false</code> otherwise. 如果该线程组是守护线程组，返回true，否则false。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

isDestroyed</H3>

<PRE>

public boolean isDestroyed()</PRE>

<DL>

<DD>Tests if this thread group has been destroyed. 判断该线程组是否被销毁。

<DT>Returns:<DD>true if this object is destroyed 如果该对象被销毁，返回true<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

setDaemon</H3>

<PRE>

public final void setDaemon(boolean daemon)</PRE>

<DL>

<DD>Changes the daemon status of this thread group.

改变该线程组的守护状态。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

A daemon thread group is automatically destroyed when its last

thread is stopped or its last thread group is destroyed.

守护线程组中最后一个线程停止运行或最后一个线程组被销毁，守护线程组也

自动销毁。

<DT>Parameters:<DD><CODE>daemon</CODE> - if <code>true</code>, marks this thread group as

a daemon thread group; otherwise, marks this

thread group as normal.

如果为true，将该线程组标记为守护线程组，否则标记为普通线程。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot modify

this thread group. 当前线程不能修改该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

setMaxPriority</H3>

<PRE>

public final void setMaxPriority(int pri)</PRE>

<DL>

<DD>Sets the maximum priority of the group. Threads in the thread

group that already have a higher priority are not affected.

设置该线程组的最大优先级。如果线程组中某些线程的优先级更高，则不受影响。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

If the <code>pri</code> argument is less than

<A HREF="../../java/lang/Thread.html#MIN_PRIORITY"><CODE>Thread.MIN_PRIORITY</CODE></A> or greater than

<A HREF="../../java/lang/Thread.html#MAX_PRIORITY"><CODE>Thread.MAX_PRIORITY</CODE></A>, the maximum priority of the group

remains unchanged.

如果pri参数小于Thread.MIN_PRIORITY或着大于Thread.MAX_PRIORITY，该线程组的优先级保持不变。

Otherwise, the priority of this ThreadGroup object is set to the

smaller of the specified <code>pri</code> and the maximum permitted

priority of the parent of this thread group. (If this thread group

is the system thread group, which has no parent, then its maximum

priority is simply set to <code>pri</code>.) Then this method is

called recursively, with <code>pri</code> as its argument, for

every thread group that belongs to this thread group.

否则，线程组的优先级被设为指定的pri和该线程组的父线程组所允许的最大优先级中的较小值。

（如果该线程组是系统线程组，没有父线程组，那么最大优先级简单地设为pri）而且该方法对

属于该线程组的每个线程组都以pri作为参数递归调用。

<DT>Parameters:<DD><CODE>pri</CODE> - the new priority of the thread group. 线程组的新优先级

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot modify

this thread group. 当前线程不能修改该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#getMaxPriority()"><CODE>getMaxPriority()</CODE></A>,

<A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

parentOf</H3>

<PRE>

public final boolean parentOf(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A> g)</PRE>

<DL>

<DD>Tests if this thread group is either the thread group

argument or one of its ancestor thread groups.

判断该线程组是否是threadGroup参数本身或者它的祖先线程组。

<DT>Parameters:<DD><CODE>g</CODE> - a thread group. 线程组。

<DT>Returns:<DD><code>true</code> if this thread group is the thread group

argument or one of its ancestor thread groups;

<code>false</code> otherwise.

如果该线程组是threadGroup参数本身或者它的祖先线程组，返回true，否则为false。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

checkAccess</H3>

<PRE>

public final void checkAccess()</PRE>

<DL>

<DD>Determines if the currently running thread has permission to

modify this thread group.

确定当前运行县城是否允许修改该线程组。

If there is a security manager, its <code>checkAccess</code> method

is called with this thread group as its argument. This may result

in throwing a <code>SecurityException</code>.

如果存在安全管理器，以该线程组作参数调用它的的checkAccess方法，这可能导致抛出安全SecurityException。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread is not allowed to

access this thread group.当前线程不能访问该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/SecurityManager.html#checkAccess(java.lang.ThreadGroup)"><CODE>SecurityManager.checkAccess(java.lang.ThreadGroup)</CODE></A></DL>

</DD>

</DL>

<HR>

activeCount</H3>

<PRE>

public int activeCount()</PRE>

<DL>

<DD>Returns an estimate of the number of active threads in this

thread group.

返回该线程组中活动线程的估计值。

<DT>Returns:<DD>the number of active threads in this thread group and in any

other thread group that has this thread group as an ancestor. 当前线程组以及所有以其为祖先的线程组中

所包含的活动线程估计值。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

enumerate</H3>

<PRE>

public int enumerate(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A>[] list)</PRE>

<DL>

<DD>Copies into the specified array every active thread in this

thread group and its subgroups. 将该线程组及其子线程组中的所有活动线程拷贝到指定数组中。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

An application should use the <code>activeCount</code> method to

get an estimate of how big the array should be. If the array is

too short to hold all the threads, the extra threads are silently

ignored.

应用程序应该使用activeCount方法来获取该数组大小的估计值。如果数组过小以至于不能容纳所有的线程，

多余的线程会被忽略。

<DT>Parameters:<DD><CODE>list</CODE> - an array into which to place the list of threads. 用来放置线程集的数组。

<DT>Returns:<DD>the number of threads put into the array. 放入数组的线程数。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread does not

have permission to enumerate this thread group.

当前线程不允许统计该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#activeCount()"><CODE>activeCount()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

enumerate</H3>

<PRE>

public int enumerate(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A>[] list,

boolean recurse)</PRE>

<DL>

<DD>Copies into the specified array every active thread in this

thread group. If the <code>recurse</code> flag is

<code>true</code>, references to every active thread in this

thread's subgroups are also included. If the array is too short to

hold all the threads, the extra threads are silently ignored.

将该线程组中的所有活动线程拷贝到指定数组中。如果recurse标记为true，将包括

该线程的子组中每个活动线程。如果数组过小以至于不能容纳所有的线程，

多余的线程会被忽略。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

An application should use the <code>activeCount</code> method to

get an estimate of how big the array should be.

应用程序应该使用activeCount方法来获取该数组大小的估计值。

<DT>Parameters:<DD><CODE>list</CODE> - an array into which to place the list of threads.

用来放置线程集的数组。<DD><CODE>recurse</CODE> - a flag indicating whether also to include threads

in thread groups that are subgroups of this

thread group. 标记，表示是否包括该线程组的子组的线程。

<DT>Returns:<DD>the number of threads placed into the array. 放入数组的线程数。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread does not

have permission to enumerate this thread group.

当前线程不允许统计该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#activeCount()"><CODE>activeCount()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

activeGroupCount</H3>

<PRE>

public int activeGroupCount()</PRE>

<DL>

<DD>Returns an estimate of the number of active groups in this

thread group. 返回该线程组中活动组的估计值。

<DT>Returns:<DD>the number of active thread groups with this thread group as

an ancestor.以该线程组为祖先的活动组的估计值。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

enumerate</H3>

<PRE>

public int enumerate(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A>[] list)</PRE>

<DL>

<DD>Copies into the specified array references to every active

subgroup in this thread group. 将该线程组中的所有活动子线程组拷贝到指定数组中。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

An application should use the <code>activeGroupCount</code>

method to get an estimate of how big the array should be. If the

array is too short to hold all the thread groups, the extra thread

groups are silently ignored.

应用程序应该使用activeCount方法来获取该数组大小的估计值。如果数组过小以至于不能容纳所有的线程，

多余的线程会被忽略。

<DT>Parameters:<DD><CODE>list</CODE> - an array into which to place the list of thread groups.

用来放置线程组集的数组。

<DT>Returns:<DD>the number of thread groups put into the array. 放入数组的线程组数。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread does not

have permission to enumerate this thread group.

当前线程不允许统计该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#activeGroupCount()"><CODE>activeGroupCount()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

enumerate</H3>

<PRE>

public int enumerate(<A HREF="../../java/lang/ThreadGroup.html" title="class in java.lang">ThreadGroup</A>[] list,

boolean recurse)</PRE>

<DL>

<DD>Copies into the specified array references to every active

subgroup in this thread group. If the <code>recurse</code> flag is

<code>true</code>, references to all active subgroups of the

subgroups and so forth are also included.

将该线程组中的所有活动子线程组拷贝到指定数组中。如果recurse标记为true，将包括

该线程的子组中每个活动线程组。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

An application should use the <code>activeGroupCount</code>

method to get an estimate of how big the array should be.

应用程序应该使用activeCount方法来获取该数组大小的估计值。

<DT>Parameters:<DD><CODE>list</CODE> - an array into which to place the list of threads.

用来放置线程集的数组。<DD><CODE>recurse</CODE> - a flag indicating whether to recursively enumerate

all included thread groups. 标记，表示是否递归统计所有被包括的线程组。

<DT>Returns:<DD>the number of thread groups put into the array. 放入数组的线程数。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread does not

have permission to enumerate this thread group.

当前线程不允许统计该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#activeGroupCount()"><CODE>activeGroupCount()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

stop</H3>

<PRE>

public final void stop()</PRE>

<DL>

<DD>Deprecated. This method is inherently unsafe. See

<A HREF="../../java/lang/Thread.html#stop()"><CODE>Thread.stop()</CODE></A> for details.

该方法本质上不安全。详情查看Thread.stop()。

<DD>Stops all threads in this thread group.

停止该线程组中的所有线程。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

This method then calls the <code>stop</code> method on all the

threads in this thread group and in all of its subgroups.

该方法调用该线程组和它的所有子线程组中所有线程的stop方法。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread is not allowed

to access this thread group or any of the threads in

the thread group.当前线程不允许访问该线程组或者线程组中的其他线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/Thread.html#stop()"><CODE>Thread.stop()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

interrupt</H3>

<PRE>

public final void interrupt()</PRE>

<DL>

<DD>Interrupts all threads in this thread group.

中断该线程组中的所有线程。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

This method then calls the <code>interrupt</code> method on all the

threads in this thread group and in all of its subgroups.

该方法调用该线程组和它的所有子线程组中所有线程的interrupt方法。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread is not allowed

to access this thread group or any of the threads in

the thread group.当前线程不允许访问该线程组或者线程组中的其他线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/Thread.html#interrupt()"><CODE>Thread.interrupt()</CODE></A>,

<A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

suspend</H3>

<PRE>

public final void suspend()</PRE>

<DL>

<DD>Deprecated. This method is inherently deadlock-prone. See

<A HREF="../../java/lang/Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A> for details.

该方法本质上不安全。详情查看Thread.suspend()。

<DD>Suspends all threads in this thread group.

挂起该线程组中的所有线程。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

This method then calls the <code>suspend</code> method on all the

threads in this thread group and in all of its subgroups.

该方法调用该线程组和它的所有子线程组中所有线程的suspend方法。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread is not allowed

to access this thread group or any of the threads in

the thread group.如果当前线程不允许访问该线程组或者线程组中的其他线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A>,

<A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

resume</H3>

<PRE>

public final void resume()</PRE>

<DL>

<DD>Deprecated. This method is used solely in conjunction with

<tt>Thread.suspend</tt> and <tt>ThreadGroup.suspend</tt>,

both of which have been deprecated, as they are inherently

deadlock-prone. See <A HREF="../../java/lang/Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A> for details.

该方法仅和Thread.suspend和ThreadGroup.suspend联合使用，但它们均已不推荐使用，因为容易造成死锁。详情查看Thread.suspend()。

<DD>Resumes all threads in this thread group.

恢复该线程组中的所有线程。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

This method then calls the <code>resume</code> method on all the

threads in this thread group and in all of its sub groups.

该方法调用该线程组和它的所有子线程组中所有线程的resume方法。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread is not allowed to

access this thread group or any of the threads in the

thread group.如果当前线程不允许访问该线程组或者线程组中的线程时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/SecurityException.html" title="class in java.lang"><CODE>SecurityException</CODE></A>,

<A HREF="../../java/lang/Thread.html#resume()"><CODE>Thread.resume()</CODE></A>,

<A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

destroy</H3>

<PRE>

public final void destroy()</PRE>

<DL>

<DD>Destroys this thread group and all of its subgroups. This thread

group must be empty, indicating that all threads that had been in

this thread group have since stopped.

销毁该线程组及其所有子线程组。

First, the <code>checkAccess</code> method of this thread group is

called with no arguments; this may result in a security exception.

首先调用该线程组的无参数的checkAccess方法，这可能导致安全异常。

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IllegalThreadStateException.html" title="class in java.lang">IllegalThreadStateException</A></CODE> - if the thread group is not

empty or if the thread group has already been destroyed. 如果该线程不为空或者已经被销毁时抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if the current thread cannot modify this

thread group. 当前线程不能修改该线程组时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/ThreadGroup.html#checkAccess()"><CODE>checkAccess()</CODE></A></DL>

</DD>

</DL>

<HR>

list</H3>

<PRE>

public void list()</PRE>

<DL>

<DD>Prints information about this thread group to the standard

output. This method is useful only for debugging.

在标准输出中打印该线程组信息。该方法仅用来调试。

<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

uncaughtException</H3>

<PRE>

public void uncaughtException(<A HREF="../../java/lang/Thread.html" title="class in java.lang">Thread</A> t,

<A HREF="../../java/lang/Throwable.html" title="class in java.lang">Throwable</A> e)</PRE>

<DL>

<DD>Called by the Java Virtual Machine when a thread in this

thread group stops because of an uncaught exception.

当该线程组中某线程因为无法捕获的异常而停止时，Java虚拟机调用该方法。

The <code>uncaughtException</code> method of

<code>ThreadGroup</code> does the following:

ThreadGroup的uncaughtException方法按以下进行：

<ul>

<li>If this thread group has a parent thread group, the

<code>uncaughtException</code> method of that parent is called

with the same two arguments.

如果该线程组有父线程组，以相同的两个参数调用父线程组的uncaughtException方法。

<li>Otherwise, this method determines if the <code>Throwable</code>

argument is an instance of <code>ThreadDeath</code>. If so, nothing

special is done. Otherwise, the <code>Throwable</code>'s

<code>printStackTrace</code> method is called to print a stack

backtrace to the standard error stream.

否则，该方法确定Throwable参数是否是ThreadDeath的实例，如果是，什么也不做，

否则，调用Throwable的printStackTrace方法在标准错误流中打印堆栈信息。

</ul>

Applications can override this method in subclasses of

<code>ThreadGroup</code> to provide alternative handling of

uncaught exceptions.

应用程序应当在ThreadGroup的子类中覆盖该方法，以使未捕获异常的处理方式可选。

<DT>Parameters:<DD><CODE>t</CODE> - the thread that is about to exit.

将要退出的线程。<DD><CODE>e</CODE> - the uncaught exception. 未捕获的异常。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/lang/System.html#err"><CODE>System.err</CODE></A>,

<A HREF="../../java/lang/ThreadDeath.html" title="class in java.lang"><CODE>ThreadDeath</CODE></A>,

<A HREF="../../java/lang/Throwable.html#printStackTrace(java.io.PrintStream)"><CODE>Throwable.printStackTrace(java.io.PrintStream)</CODE></A></DL>

</DD>

</DL>

<HR>

allowThreadSuspension</H3>

<PRE>

public boolean allowThreadSuspension(boolean b)</PRE>

<DL>

<DD>Deprecated. The definition of this call depends on <A HREF="../../java/lang/ThreadGroup.html#suspend()"><CODE>suspend()</CODE></A>,

which is deprecated. Further, the behavior of this call

was never specified. 该调用的定义依赖于suspend()（已不支持），而且，该调用的行为从未指定。

<DD>Used by VM to control lowmem implicit suspension.VM用来控制低内存（?）隐式挂起。

<DT>Parameters:<DD><CODE>b</CODE> - boolean to allow or disallow suspension 是否允许拒绝挂起

<DT>Returns:<DD>true on success 成功为true<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

toString</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> toString()</PRE>

<DL>

<DD>Returns a string representation of this Thread group.

返回该线程组的字符串形式。

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a string representation of this thread group. 该线程组的字符串形式。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/lang/Thread.html" title="class in java.lang">PREV CLASS</A>

<A HREF="../../java/lang/ThreadLocal.html" title="class in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="ThreadGroup.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a> For further API reference and developer documentation, see <a href="../../../relnotes/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../relnotes/license.html">license terms</a>. Also see the <a href="http://java.sun.com/docs/redist.html">documentation redistribution policy</a>.

</BODY>

</HTML>