Contents | Package | Class | Tree | Deprecated | Index | Help | Java 1.2 Beta 3 | ||
PREV | NEXT | SHOW LISTS | HIDE LISTS |
java.lang.Object | +----java.lang.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.
Constructor Summary | |
ThreadGroup(String name)
|
|
ThreadGroup(ThreadGroup parent,
String name)
|
Method Summary | |
int | activeCount()
|
int | activeGroupCount()
|
boolean | allowThreadSuspension(boolean b)
|
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()
|
void | setDaemon(boolean daemon)
|
void | setMaxPriority(int pri)
|
void | stop()
|
void | suspend()
|
String | toString()
|
void | uncaughtException(Thread t,
Throwable e)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public ThreadGroup(String name)
name
- the name of the new thread group.
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
.Method Detail |
public final String getName()
public final ThreadGroup getParent()
null
.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.
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.
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
.
public int activeCount()
public int enumerate(Thread[] list)
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.
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.
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.
public int activeGroupCount()
public int enumerate(ThreadGroup[] list)
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.
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.
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.
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.
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.
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.
public final void resume()
suspend
, which is deadlock-prone.
See 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.
public final void destroy()
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.
public boolean allowThreadSuspension(boolean b)
public String toString()
Contents | Package | Class | Tree | Deprecated | Index | Help | Java 1.2 Beta 3 | ||
PREV | NEXT | SHOW LISTS | HIDE LISTS |