| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Vector groups = …;
int i = …;
ThreadGroup tg = (ThreadGroup)groups.elementAt(i);
Based on 9 examples
ThreadGroup somegroup = new ThreadGroup("GroupA");
Based on 8 examples
public class ThreadGroup extends Object implements Thread.UncaughtExceptionHandler
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 |
Returns an estimate of the number of active threads in this thread group. |
int |
Returns an estimate of the number of active groups in this thread group. |
boolean |
allowThreadSuspension(boolean b) Used by VM to control lowmem implicit suspension. |
void |
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(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 |
Copies into the specified array every active thread in this thread group and its subgroups. |
int |
Copies into the specified array every active thread in this thread group. |
int |
Returns the maximum priority of this thread group. |
String |
getName() Returns the name of this thread group. |
ThreadGroup |
Returns the parent of this thread group. |
void |
Interrupts all threads in this thread group. |
boolean |
isDaemon() Tests if this thread group is a daemon thread group. |
boolean |
Tests if this thread group has been destroyed. |
void |
list() Prints information about this thread group to the standard output. |
boolean |
Tests if this thread group is either the thread group argument or one of its ancestor thread groups. |
void |
resume() Resumes all threads in this thread group. |
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() Stops all threads in this thread group. |
void |
suspend() Suspends all threads in this thread group. |
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, and the thread does not have a specific java.lang.Thread.UncaughtExceptionHandler installed. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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.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.Method Detail |
---|
public int activeCount()
Due to the inherently imprecise nature of the result, it is recommended that this method only be used for informational purposes.
public int activeGroupCount()
Due to the inherently imprecise nature of the result, it is recommended that this method only be used for informational purposes.
public boolean allowThreadSuspension(boolean b)
b
- boolean to allow or disallow suspensionpublic 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 final void destroy()
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
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 might use the activeGroupCount
method to
get an estimate of how big the array should be, however if the
array is too short to hold all the thread groups, the extra thread
groups are silently ignored. If it is critical to obtain every
active subgroup in this thread group, the caller should verify that
the returned int value is strictly less than the length of
list.
Due to the inherent race condition in this method, it is recommended that the method only be used for informational purposes.
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.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application might use the activeGroupCount
method to
get an estimate of how big the array should be, however if the
array is too short to hold all the thread groups, the extra thread
groups are silently ignored. If it is critical to obtain every
active subgroup in this thread group, the caller should verify that
the returned int value is strictly less than the length of
list.
Due to the inherent race condition in this method, it is recommended that the method only be used for informational purposes.
list
- an array into which to place the list of threads.recurse
- a flag indicating whether to recursively enumerate
all included thread groups.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 might use the activeCount
method to
get an estimate of how big the array should be, however if the
array is too short to hold all the threads, the extra threads are
silently ignored. If it is critical to obtain every active
thread in this thread group and its subgroups, the caller should
verify that the returned int value is strictly less than the length
of list.
Due to the inherent race condition in this method, it is recommended that the method only be used for informational purposes.
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.
First, the checkAccess
method of this thread group is
called with no arguments; this may result in a security exception.
An application might use the activeCount
method to
get an estimate of how big the array should be, however if the
array is too short to hold all the threads, the extra threads are
silently ignored. If it is critical to obtain every active thread
in this thread group, the caller should verify that the returned int
value is strictly less than the length of list.
Due to the inherent race condition in this method, it is recommended that the method only be used for informational purposes.
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 final int getMaxPriority()
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
.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 boolean isDaemon()
true
if this thread group is a daemon thread group;
false
otherwise.public synchronized boolean isDestroyed()
public void list()
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 resume()
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 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.
If the pri
argument is less than
{@link Thread#MIN_PRIORITY} or greater than
{@link Thread#MAX_PRIORITY}, the maximum priority of the group
remains unchanged.
Otherwise, the priority of this ThreadGroup object is set to the
smaller of the specified pri
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 pri
.) Then this method is
called recursively, with pri
as its argument, for
every thread group that belongs to this thread group.
pri
- the new priority of the thread group.public final void stop()
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 suspend()
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 String toString()
toString
in class Object
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.
uncaughtException
method is called with the same
two arguments.
Throwable
argument is an instance of {@link ThreadDeath}. If so, nothing
special is done. Otherwise, a message containing the
thread's name, as returned from the thread's {@link
Thread#getName getName} method, and a stack backtrace,
using the Throwable
's {@link
Throwable#printStackTrace printStackTrace} method, is
printed to the {@linkplain System#err 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.
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |