JavaTM Platform
Standard Ed. 6

java.lang
�� ThreadGroup

java.lang.Object
  �̳��� java.lang.ThreadGroup
������ʵ�ֵĽӿڣ�
Thread.UncaughtExceptionHandler

public class ThreadGroup
extends Object
implements Thread.UncaughtExceptionHandler

�߳����ʾһ���̵߳ļ��ϡ����⣬�߳���Ҳ���԰��������߳��顣�߳��鹹��һ�����������У����˳�ʼ�߳����⣬ÿ���߳��鶼��һ�����߳��顣

�����̷߳����й��Լ����߳������Ϣ�����Dz������������й����߳���ĸ��߳���������κ��߳������Ϣ��

�����°汾��ʼ��
JDK1.0

���췽��ժҪ
ThreadGroup(String name)
          ����һ�����߳��顣
ThreadGroup(ThreadGroup parent, String name)
          ����һ�����߳��顣
 
����ժҪ
 int activeCount()
          ���ش��߳����л�̵߳Ĺ�������
 int activeGroupCount()
          ���ش��߳����л�߳���Ĺ�������
 boolean allowThreadSuspension(boolean b)
          �ѹ�ʱ�� �˵��õĶ���ȡ���� suspend()�����������ˡ�����һ����˵���˵��õ���Ϊ�Ӳ���ָ����
 void checkAccess()
          ȷ����ǰ���е��߳��Ƿ���Ȩ�޸Ĵ��߳��顣
 void destroy()
          ���ٴ��߳��鼰���������顣
 int enumerate(Thread[] list)
          �Ѵ��߳��鼰�������е����л�̸߳��Ƶ�ָ�������С�
 int enumerate(Thread[] list, boolean recurse)
          �Ѵ��߳����е����л�̸߳��Ƶ�ָ�������С�
 int enumerate(ThreadGroup[] list)
          �ѶԴ��߳����е����л��������ø��Ƶ�ָ�������С�
 int enumerate(ThreadGroup[] list, boolean recurse)
          �ѶԴ��߳����е����л��������ø��Ƶ�ָ�������С�
 int getMaxPriority()
          ���ش��߳����������ȼ���
 String getName()
          ���ش��߳�������ơ�
 ThreadGroup getParent()
          ���ش��߳���ĸ��߳��顣
 void interrupt()
          �жϴ��߳����е������̡߳�
 boolean isDaemon()
          ���Դ��߳����Ƿ�Ϊһ����̨�����߳��顣
 boolean isDestroyed()
          ���Դ��߳����Ƿ��Ѿ������١�
 void list()
          ���йش��߳������Ϣ��ӡ����׼�����
 boolean parentOf(ThreadGroup g)
          ���Դ��߳����Ƿ�Ϊ�߳���������������߳���֮һ��
 void resume()
          �ѹ�ʱ�� �˷���ֻ�������� Thread.suspend �� ThreadGroup.suspend ʱ����Ϊ���������е����׵������������ԣ��������߶��ѷ������й���ϸ��Ϣ������� Thread.suspend()��
 void setDaemon(boolean daemon)
          ���Ĵ��߳���ĺ�̨����״̬��
 void setMaxPriority(int pri)
          �����߳����������ȼ���
 void stop()
          �ѹ�ʱ�� �˷������й��еIJ���ȫ�ԡ��й���ϸ��Ϣ������� Thread.stop()��
 void suspend()
          �ѹ�ʱ�� �˷������׵����������й���ϸ��Ϣ������� Thread.suspend()��
 String toString()
          ���ش��߳�����ַ�����ʾ��ʽ��
 void uncaughtException(Thread t, Throwable e)
          �����߳����е��߳���Ϊһ��δ������쳣��ֹͣ�������߳�û�а�װ�ض� Thread.UncaughtExceptionHandler ʱ���� Java Virtual Machine ���ô˷�����
 
���� java.lang.Object �̳еķ���
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

���췽����ϸ��Ϣ

ThreadGroup

public ThreadGroup(String name)
����һ�����߳��顣���߳���ĸ��߳�����Ŀǰ���������̵߳��߳��顣

��ʹ���κβ������ø��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

������
name - ���߳�������ơ�
�׳���
SecurityException - �����ǰ�̲߳�����ָ�����߳����д����̡߳�
�����°汾��ʼ��
JDK1.0
������
checkAccess()

ThreadGroup

public ThreadGroup(ThreadGroup parent,
                   String name)
����һ�����߳��顣���߳���ĸ��߳�����ָ�����߳��顣

��ʹ���κβ������ø��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

������
parent - ���߳��顣
name - ���߳�������ơ�
�׳���
NullPointerException - ����߳������Ϊ null��
SecurityException - �����ǰ�̲߳�����ָ�����߳����д����̡߳�
�����°汾��ʼ��
JDK1.0
������
SecurityException, checkAccess()
������ϸ��Ϣ

getName

public final String getName()
���ش��߳�������ơ�

���أ�
���߳�������ơ�
�����°汾��ʼ��
JDK1.0

getParent

public final ThreadGroup getParent()
���ش��߳���ĸ��߳��顣

���ȣ�������߳��鲻Ϊ null����ʹ���κβ���ֱ�ӵ��ø��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

���أ�
�߳���ĸ��߳��顣�����߳����Ϊ��Щ���߳���Ϊ null ���߳��顣
�׳���
SecurityException - �����ǰ�߳��޷��޸Ĵ��߳��顣
�����°汾��ʼ��
JDK1.0
������
checkAccess(), SecurityException, RuntimePermission

getMaxPriority

public final int getMaxPriority()
���ش��߳����������ȼ�����Ϊ���߳���һ���ֵ��̲߳���ӵ�б�������ȼ����ߵ����ȼ���

���أ�
���߳����е��߳̿�ӵ�е�������ȼ���
�����°汾��ʼ��
JDK1.0
������
setMaxPriority(int)

isDaemon

public final boolean isDaemon()
���Դ��߳����Ƿ�Ϊһ����̨�����߳��顣��ֹͣ��̨�����߳�������һ���̻߳����������һ���߳���ʱ���Զ����������̨�����߳��顣

���أ�
������߳�����һ����̨�����߳��飬�򷵻� true�����򷵻� false��
�����°汾��ʼ��
JDK1.0

isDestroyed

public boolean isDestroyed()
���Դ��߳����Ƿ��Ѿ������١�

���أ�
����˶������٣��򷵻� true
�����°汾��ʼ��
JDK1.1

setDaemon

public final void setDaemon(boolean daemon)
���Ĵ��߳���ĺ�̨����״̬��

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

��ֹͣ��̨�����߳�������һ���̻߳����������һ���߳���ʱ���Զ����ٴ˺�̨�����߳��顣

������
daemon - ���Ϊ true�����ʾ���߳�����һ����̨�����߳��飻���򣬱�ʾ���߳�����һ����ͨ�߳��顣
�׳���
SecurityException - �����ǰ�߳��޷��޸Ĵ��߳��顣
�����°汾��ʼ��
JDK1.0
������
SecurityException, checkAccess()

setMaxPriority

public final void setMaxPriority(int pri)
�����߳����������ȼ����߳��������нϸ����ȼ����̲߳���Ӱ�졣

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

��� pri ����С�� Thread.MIN_PRIORITY ����� Thread.MAX_PRIORITY�����߳����������ȼ����ֲ��䡣

���򣬴� ThreadGroup ��������ȼ�������Ϊ��ָ���� pri ������С����������������ȼ��Ǵ��߳���ĸ��߳�������ȼ�����������߳�����ϵͳ�߳��飬û�и��߳��飬��ôֻ�轫������ȼ�����Ϊ pri ���ɡ���Ȼ��ʹ�� pri ��Ϊ�˷����IJ������Եݹ�ķ�ʽ�����ڴ��߳����ÿ���߳�����ô˷�����

������
pri - �߳���������ȼ���
�׳���
SecurityException - �����ǰ�߳��޷��޸Ĵ��߳��顣
�����°汾��ʼ��
JDK1.0
������
getMaxPriority(), SecurityException, checkAccess()

parentOf

public final boolean parentOf(ThreadGroup g)
���Դ��߳����Ƿ�Ϊ�߳���������������߳���֮һ��

������
g - һ���߳��顣
���أ�
������߳������߳���������������߳���֮һ���򷵻� true�����򷵻� false��
�����°汾��ʼ��
JDK1.0

checkAccess

public final void checkAccess()
ȷ����ǰ���е��߳��Ƿ���Ȩ�޸Ĵ��߳��顣

����а�ȫ�����������ô��߳�����Ϊ��������� checkAccess ����������������׳�һ�� SecurityException��

�׳���
SecurityException - �����������ǰ�̷߳��ʴ��߳��顣
�����°汾��ʼ��
JDK1.0
������
SecurityManager.checkAccess(java.lang.ThreadGroup)

activeCount

public int activeCount()
���ش��߳����л�̵߳Ĺ���������������ܷ�ӳ����������ҿ�����ijЩϵͳ�̵߳Ĵ���״̬��Ӱ�졣

���ڽ�������еIJ���ȷ���ԣ�����ֻ���˷���������ϢĿ�ġ�

���أ�
���߳���ͽ����߳�����Ϊ�����ȵ������߳����л�̵߳Ĺ�������
�����°汾��ʼ��
JDK1.0

enumerate

public int enumerate(Thread[] list)
�Ѵ��߳��鼰�������е����л�̸߳��Ƶ�ָ�������С�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ӧ�ó������ʹ�� activeCount ������ȡ�����С�Ĺ����������ǣ��������̫С���޷����������̣߳�����Զ�����߳��������ô��߳��鼰�������е����л�̷߳dz���Ҫ������÷�Ӧ����֤���ص� int ֵ�Ƿ��ϸ�С�� list �ij��ȡ�

����ʹ�ô˷��������еľ�������������ֻ���˷���������ϢĿ�ġ�

������
list - �����߳��б������顣
���أ�
���������е��߳�����
�׳���
SecurityException - �����������ǰ�߳�ö�ٴ��߳��顣
�����°汾��ʼ��
JDK1.0
������
activeCount(), checkAccess()

enumerate

public int enumerate(Thread[] list,
                     boolean recurse)
�Ѵ��߳����е����л�̸߳��Ƶ�ָ�������С���� recurse ��־Ϊ true���򻹰����Դ��̵߳������е����л�̵߳����á��������̫С���޷����������̣߳�����Զ�����̡߳�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ӧ�ó������ʹ�� activeCount ��ȡ�����С�Ĺ����������ǣ��������̫С���޷����������̣߳�����Զ�����߳��������ô��߳����е����л�̷߳dz���Ҫ������÷�Ӧ����֤���ص�����ֵ�Ƿ�ȷʵС�� list �ij��ȡ�

����ʹ�ô˷��������еľ�������������ֻ���˷���������ϢĿ�ġ�

������
list - �����߳��б������顣
recurse - һ����ǣ�ָʾ�Ƿ񻹰�����Ϊ���߳����������߳����е��̡߳�
���أ�
���������е��߳�����
�׳���
SecurityException - �����������ǰ�߳�ö�ٴ��߳��顣
�����°汾��ʼ��
JDK1.0
������
activeCount(), checkAccess()

activeGroupCount

public int activeGroupCount()
���ش��߳����л�߳���Ĺ���������������ܷ�ӳ�������

���ڽ�������еIJ���ȷ���ԣ�����ֻ���˷���������ϢĿ�ġ�

���أ�
�����߳�����Ϊ�����߳���Ļ�߳����������
�����°汾��ʼ��
JDK1.0

enumerate

public int enumerate(ThreadGroup[] list)
�ѶԴ��߳����е����л��������ø��Ƶ�ָ�������С�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ӧ�ó������ʹ�� activeGroupCount ��ȡ�����С�Ĺ����������ǣ��������̫С���޷����������߳��飬����Զ�����߳����������ô��߳����е����л����dz���Ҫ������÷�Ӧ����֤���ص�����ֵ�Ƿ�ȷʵС�� list �ij��ȡ�

����ʹ�ô˷��������еľ�������������ֻ���˷���������ϢĿ�ġ�

������
list - �����߳����б������顣
���أ�
���������е��߳����������
�׳���
SecurityException - �����������ǰ�߳�ö�ٴ��߳��顣
�����°汾��ʼ��
JDK1.0
������
activeGroupCount(), checkAccess()

enumerate

public int enumerate(ThreadGroup[] list,
                     boolean recurse)
�ѶԴ��߳����е����л��������ø��Ƶ�ָ�������С���� recurse ��־Ϊ true���򻹰�������������л��������ã��ȵȡ�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ӧ�ó������ʹ�� activeGroupCount ��ȡ�����С�Ĺ����������ǣ��������̫С���޷����������߳��飬����Զ�����߳����������ô��߳����е����л����dz���Ҫ������÷�Ӧ����֤���ص�����ֵ�Ƿ�ȷʵС�� list �ij��ȡ�

����ʹ�ô˷��������еľ�������������ֻ���˷���������ϢĿ�ġ�

������
list - �����߳��б������顣
recurse - һ����ǣ�ָʾ�Ƿ��Եݹ�ķ�ʽö�������Ѱ������߳��顣
���أ�
���������е��߳����������
�׳���
SecurityException - �����������ǰ�߳�ö�ٴ��߳��顣
�����°汾��ʼ��
JDK1.0
������
activeGroupCount(), checkAccess()

stop

@Deprecated
public final void stop()
�ѹ�ʱ�� �˷������й��еIJ���ȫ�ԡ��й���ϸ��Ϣ������� Thread.stop()��

ֹͣ���߳����е������̡߳�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ȼ�󣬴˷������Դ��߳��鼰�����������е������̵߳��� stop ������

�׳���
SecurityException - �����������ǰ�̷߳��ʴ��߳�����߳����е��κ��̡߳�
�����°汾��ʼ��
JDK1.0
������
SecurityException, Thread.stop(), checkAccess()

interrupt

public final void interrupt()
�жϴ��߳����е������̡߳�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ȼ�󣬴˷������Դ��߳��鼰�����������е������̵߳��� interrupt ������

�׳���
SecurityException - �����������ǰ�̷߳��ʴ��߳�����߳����е��κ��̡߳�
�����°汾��ʼ��
1.2
������
Thread.interrupt(), SecurityException, checkAccess()

suspend

@Deprecated
public final void suspend()
�ѹ�ʱ�� �˷������׵����������й���ϸ��Ϣ������� Thread.suspend()��

������߳����е������̡߳�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ȼ�󣬴˷������Ը��߳��鼰�����������е������̵߳��� suspend ������

�׳���
SecurityException - �����������ǰ�̷߳��ʴ��߳�����߳����е��κ��̡߳�
�����°汾��ʼ��
JDK1.0
������
Thread.suspend(), SecurityException, checkAccess()

resume

@Deprecated
public final void resume()
�ѹ�ʱ�� �˷���ֻ�������� Thread.suspend �� ThreadGroup.suspend ʱ����Ϊ���������е����׵������������ԣ��������߶��ѷ������й���ϸ��Ϣ������� Thread.suspend()��

�������߳����е������̡߳�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

Ȼ�󣬴˷������Ը��߳��鼰�����������е������̵߳��� resume ������

�׳���
SecurityException - �����������ǰ�̷߳��ʴ��߳�����߳����е��κ��̡߳�
�����°汾��ʼ��
JDK1.0
������
SecurityException, Thread.resume(), checkAccess()

destroy

public final void destroy()
���ٴ��߳��鼰���������顣���߳������Ϊ�գ�ָʾ���߳����е������̶߳���ִֹͣ�С�

���ȣ���ʹ���κβ������ô��߳���� checkAccess ����������ܵ���һ����ȫ���쳣��

�׳���
IllegalThreadStateException - ����߳��鲻Ϊ�գ������߳����Ѿ������١�
SecurityException - �����ǰ�̲߳����޸Ĵ��߳��顣
�����°汾��ʼ��
JDK1.0
������
checkAccess()

list

public void list()
���йش��߳������Ϣ��ӡ����׼������˷���ֻ�Ե������á�

�����°汾��ʼ��
JDK1.0

uncaughtException

public void uncaughtException(Thread t,
                              Throwable e)
�����߳����е��߳���Ϊһ��δ������쳣��ֹͣ�������߳�û�а�װ�ض� Thread.UncaughtExceptionHandler ʱ���� Java Virtual Machine ���ô˷�����

ThreadGroup �� uncaughtException ����ִ�����²�����

Ӧ�ó��������д ThreadGroup �������еķ��������ṩ����δ�����쳣������취��

ָ���ߣ�
�ӿ� Thread.UncaughtExceptionHandler �е� uncaughtException
������
t - �����˳����̡߳�
e - δ������쳣��
�����°汾��ʼ��
JDK1.0

allowThreadSuspension

@Deprecated
public boolean allowThreadSuspension(boolean b)
�ѹ�ʱ�� �˵��õĶ���ȡ���� suspend()�����������ˡ�����һ����˵���˵��õ���Ϊ�Ӳ���ָ����

�� VM ���ڿ����ڴ治��ʱ����ʽ����

������
b - ��������������ʱ�IJ���ֵ
���أ�
����ɹ����򷵻� true
�����°汾��ʼ��
JDK1.1

toString

public String toString()
���ش��߳�����ַ�����ʾ��ʽ��

���ǣ�
�� Object �е� toString
���أ�
���߳�����ַ�����ʾ��ʽ��
�����°汾��ʼ��
JDK1.0

JavaTM Platform
Standard Ed. 6

�ύ��������
�йظ���� API �ο����ϺͿ�����Ա�ĵ�������� Java SE ������Ա�ĵ������ĵ���������ϸ�ġ����򿪷���Ա���������Լ�������������ﶨ�塢ʹ�ü��ɺ͹�������ʾ����

��Ȩ���� 2007 Sun Microsystems, Inc. ��������Ȩ���� ����������֤��������������ĵ����·ַ�������