|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.lang.ThreadGroup
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.
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.
Constructor Summary | |
ThreadGroup(String name)
Constructs a new thread group. |
|
ThreadGroup(ThreadGroup parent,
String name)
Creates a new thread group. |
Method Summary | |
int |
activeCount()
Returns an estimate of the number of active threads in this thread group. |
int |
activeGroupCount()
Returns an estimate of the number of active groups in this thread group. |
boolean |
allowThreadSuspension(boolean b)
Deprecated. The definition of this call depends on suspend() ,
which is deprecated. Further, the behavior of this call
was never specified. |
void |
checkAccess()
Determines if the currently running thread has permission to modify this thread group. |
void |
destroy()
Destroys this thread group and all of its subgroups. |
int |
enumerate(Thread[] list)
Copies into the specified array every active thread in this thread group and its subgroups. |
int |
enumerate(Thread[] list,
boolean recurse)
Copies into the specified array every active thread in this thread group. |
int |
enumerate(ThreadGroup[] list)
Copies into the specified array references to every active subgroup in this thread group. |
int |
enumerate(ThreadGroup[] list,
boolean recurse)
Copies into the specified array references to every active subgroup in this thread group. |
int |
getMaxPriority()
Returns the maximum priority of this thread group. |
String |
getName()
Returns the name of this thread group. |
ThreadGroup |
getParent()
Returns the parent of this thread group. |
void |
interrupt()
Interrupts all threads in this thread group. |
boolean |
isDaemon()
Tests if this thread group is a daemon thread group. |
boolean |
isDestroyed()
Tests if this thread group has been destroyed. |
void |
list()
Prints information about this thread group to the standard output. |
boolean |
parentOf(ThreadGroup g)
Tests if this thread group is either the thread group argument or one of its ancestor thread groups. |
void |
resume()
Deprecated. This method is used solely in conjunction with Thread.suspend and ThreadGroup.suspend, both of which have been deprecated, as they are inherently deadlock-prone. See Thread.suspend() for details. |
void |
setDaemon(boolean daemon)
Changes the daemon status of this thread group. |
void |
setMaxPriority(int pri)
Sets the maximum priority of the group. |
void |
stop()
Deprecated. This method is inherently unsafe. See Thread.stop() for details. |
void |
suspend()
Deprecated. This method is inherently deadlock-prone. See Thread.suspend() for details. |
String |
toString()
Returns a string representation of this Thread group. |
void |
uncaughtException(Thread t,
Throwable e)
Called by the Java Virtual Machine when a thread in this thread group stops because of an uncaught exception. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Constructor Detail |
public ThreadGroup(String name)
The checkAccess
method of the parent thread group is
called with no arguments; this may result in a security exception.
name
- the name of the new thread group.checkAccess()
public ThreadGroup(ThreadGroup parent, String name)
The checkAccess
method of the parent thread group is
called with no arguments; this may result in a security exception.
parent
- the parent thread group.name
- the name of the new thread group.null
.SecurityException
,
checkAccess()
Method Detail |
public final String getName()
public final ThreadGroup getParent()
First, if the parent is not null
, the
checkAccess
method of the parent thread group is
called with no arguments; this may result in a security exception.
null
.checkAccess()
public final int getMaxPriority()
public final boolean isDaemon()
true
if this thread group is a daemon thread group;
false
otherwise.public boolean isDestroyed()
public final void setDaemon(boolean daemon)
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
A daemon thread group is automatically destroyed when its last thread is stopped or its last thread group is destroyed.
daemon
- if true
, marks this thread group as
a daemon thread group; otherwise, marks this
thread group as normal.SecurityException
,
checkAccess()
public final void setMaxPriority(int pri)
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
Threads in the thread group that already have a higher priority are not affected.
pri
- the new priority of the thread group.SecurityException
,
checkAccess()
public final boolean parentOf(ThreadGroup g)
g
- a thread group.true
if this thread group is the thread group
argument or one of its ancestor thread groups;
false
otherwise.public final void checkAccess()
If there is a security manager, its checkAccess
method
is called with this thread group as its argument. This may result
in throwing a SecurityException
.
SecurityManager.checkAccess(java.lang.ThreadGroup)
public int activeCount()
public int enumerate(Thread[] list)
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application should use the activeCount
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.
list
- an array into which to place the list of threads.activeCount()
,
checkAccess()
public int enumerate(Thread[] list, boolean recurse)
recurse
flag is
true
, 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.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application should use the activeCount
method to
get an estimate of how big the array should be.
list
- an array into which to place the list of threads.recurse
- a flag indicating whether also to include threads
in thread groups that are subgroups of this
thread group.activeCount()
,
checkAccess()
public int activeGroupCount()
public int enumerate(ThreadGroup[] list)
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application should use the activeGroupCount
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.
list
- an array into which to place the list of thread groups.activeGroupCount()
,
checkAccess()
public int enumerate(ThreadGroup[] list, boolean recurse)
recurse
flag is
true
, references to all active subgroups of the
subgroups and so forth are also included.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application should use the activeGroupCount
method to get an estimate of how big the array should be.
list
- an array into which to place the list of threads.recurse
- a flag indicating whether to recursively enumerate
all included thread groups.activeGroupCount()
,
checkAccess()
public final void stop()
Thread.stop()
for details.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
This method then calls the stop
method on all the
threads in this thread group and in all of its subgroups.
SecurityException
,
Thread.stop()
,
checkAccess()
public final void interrupt()
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
This method then calls the interrupt
method on all the
threads in this thread group and in all of its subgroups.
Thread.interrupt()
,
SecurityException
,
checkAccess()
public final void suspend()
Thread.suspend()
for details.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
This method then calls the suspend
method on all the
threads in this thread group and in all of its subgroups.
Thread.suspend()
,
SecurityException
,
checkAccess()
public final void resume()
Thread.suspend()
for details.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
This method then calls the resume
method on all the
threads in this thread group and in all of its sub groups.
SecurityException
,
Thread.resume()
,
checkAccess()
public final void destroy()
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
checkAccess()
public void list()
public void uncaughtException(Thread t, Throwable e)
The uncaughtException
method of
ThreadGroup
does the following:
uncaughtException
method of that parent is called
with the same two arguments.
Throwable
argument is an instance of ThreadDeath
. If so, nothing
special is done. Otherwise, the Throwable
's
printStackTrace
method is called to print a stack
backtrace to the standard error stream.
Applications can override this method in subclasses of
ThreadGroup
to provide alternative handling of
uncaught exceptions.
t
- the thread that is about to exit.e
- the uncaught exception.System.err
,
ThreadDeath
,
Throwable.printStackTrace(java.io.PrintStream)
public boolean allowThreadSuspension(boolean b)
suspend()
,
which is deprecated. Further, the behavior of this call
was never specified.
public String toString()
|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |