说明
Java ThreadGroup enumerate(Thread[] list, boolean recurse) 方法将此线程组中的每个活动线程复制到指定的数组中。如果recurse标志为true，则还包括对该线程子组中每个活动线程的引用。
如果数组太短而无法容纳所有线程，则额外的线程将被包含在内。默默地忽略。
声明
以下是java.lang.ThreadGroup.enumerate(Thread[] list, boolean recurse)方法的声明
public int enumerate(Thread[] list, boolean recurse)
参数
list 这是一个用于放置线程列表的数组。
返回值
此方法返回放入数组的线程数。
异常
SecurityException 如果当前线程没有枚举此线程组的权限.
示例 1
以下示例显示了在单个 ThreadGroup 对象的情况下 ThreadGroup enumerate(Thread[] list, boolean recurse) 方法的用法。我们创建了一个 ThreadGroup 对象并为其分配了一个名称。然后我们使用之前创建的线程组对象创建了两个线程。使用 enumerate() 方法，我们将所有活动线程放入一个数组中，然后使用数组上的 for 循环打印它们的名称。
package com.yxjc123;
public class ThreadGroupDemo implements Runnable {
public static void main(String[] args) {
ThreadGroupDemo tg = new ThreadGroupDemo();
tg.start();
}
public void start() {
try {
//创建一个ThreadGroup
ThreadGroup threadGroup = new ThreadGroup("ThreadGroup");
//创建一个线程
Thread t1 = new Thread(threadGroup, this);
System.out.println("Starting " + t1.getName() + "...");
t1.start();
//创建另一个线程
Thread t2 = new Thread(threadGroup, this);
System.out.println("Starting " + t2.getName() + "...");
t2.start();
//返回放入数组的线程数
Thread[] list = new Thread[threadGroup.activeCount()];
int count = threadGroup.enumerate(list, true);
for (int i = 0; i < count; i++) {
System.out.println("Thread " + list[i].getName() + " found.");
}
// 阻塞直到其他线程完成
t1.join();
t2.join();
} catch (InterruptedException ex) {
System.out.println(ex.toString());
}
}
// 实现 run()
public void run() {
for(int i = 0; i < 4;i++) {
i++;
try {
Thread.sleep(50);
} catch (InterruptedException e) {
// TODO 自动生成的 catch 块
e.printStackTrace();
}
}
System.out.println(Thread.currentThread().getName() + " finished executing.");
}
}
输出
让我们编译并运行上面的程序，将产生以下结果 -
Starting Thread-0...
Starting Thread-1...
Thread Thread-0 found.
Thread Thread-1 found.
Thread-0 finished executing.
Thread-1 finished executing.
示例 2
下面的示例展示了 ThreadGroup enumerate(Thread[] list, boolean recurse) 方法的用法如果有多个 ThreadGroup 对象。我们创建了一个 ThreadGroup 对象并为其分配了一个名称。接下来，我们创建了一个子 ThreadGroup 对象。然后我们使用之前创建的线程组对象创建了两个线程。使用 enumerate() 方法，我们将子 ThreadGroup 对象中的所有活动线程获取到一个数组中，然后使用数组上的 for 循环打印它们的名称。由于父 pThreadGroup 对象总共有 2 个活动线程，因此程序将打印找到的两个线程。
package com.yxjc123;
public class ThreadGroupDemo implements Runnable {
public static void main(String[] args) {
ThreadGroupDemo tg = new ThreadGroupDemo();
tg.start();
}
public void start() {
try {
//创建父ThreadGroup
ThreadGroup pThreadGroup = new ThreadGroup("parent ThreadGroup");
//为父ThreadGroup创建子ThreadGroup
ThreadGroup cThreadGroup = new ThreadGroup(pThreadGroup, "child ThreadGroup");
//创建一个线程
Thread t1 = new Thread(pThreadGroup, this);
System.out.println("Starting " + t1.getName() + "...");
t1.start();
//创建另一个线程
Thread t2 = new Thread(cThreadGroup, this);
System.out.println("Starting " + t2.getName() + "...");
t2.start();
//返回放入数组的线程数
Thread[] list = new Thread[pThreadGroup.activeCount()];
int count = pThreadGroup.enumerate(list,true);
for (int i = 0; i < count; i++) {
System.out.println("Thread " + list[i].getName() + " found.");
}
// 阻塞直到其他线程完成
t1.join();
t2.join();
} catch (InterruptedException ex) {
System.out.println(ex.toString());
}
}
// 实现 run()
public void run() {
for(int i = 0; i < 4;i++) {
i++;
try {
Thread.sleep(50);
} catch (InterruptedException e) {
// TODO 自动生成的 catch 块
e.printStackTrace();
}
}
System.out.println(Thread.currentThread().getName() + " finished executing.");
}
}
输出
让我们编译并运行上面的程序，这将产生以下结果−
Starting Thread-0...
Starting Thread-1...
Thread Thread-0 found.
Thread Thread-1 found.
Thread-0 finished executing.
Thread-1 finished executing.
示例 3
以下示例显示了 ThreadGroup enumerate(Thread[] list, boolean recurse) 方法在子 ThreadGroup 和孙 ThreadGroup 对象的情况下的用法。我们创建了一个 ThreadGroup 对象并为其分配了一个名称。接下来，我们创建了一个子 ThreadGroup 对象。然后，我们使用之前创建的子线程组对象和孙线程组对象创建了两个线程。使用 enumerate() 方法，我们将所有活动线程从祖父 ThreadGroup 对象获取到一个数组中，然后使用数组上的 for 循环打印它们的名称。
package com.yxjc123;
public class ThreadGroupDemo implements Runnable {
public static void main(String[] args) {
ThreadGroupDemo tg = new ThreadGroupDemo();
tg.start();
}
public void start() {
try {
//创建父ThreadGroup
ThreadGroup pThreadGroup = new ThreadGroup("Parent ThreadGroup");
//为父ThreadGroup创建子ThreadGroup
ThreadGroup cThreadGroup = new ThreadGroup(pThreadGroup, "Child ThreadGroup");
//为父ThreadGroup创建孙ThreadGroup
ThreadGroup gThreadGroup = new ThreadGroup(cThreadGroup, "GrandChild ThreadGroup");
//创建一个线程
Thread t1 = new Thread(cThreadGroup, this);
System.out.println("Starting " + t1.getName() + "...");
t1.start();
//创建另一个线程
Thread t2 = new Thread(gThreadGroup, this);
System.out.println("Starting " + t2.getName() + "...");
t2.start();
//返回放入数组的线程数
Thread[] list = new Thread[pThreadGroup.activeCount()];
int count = pThreadGroup.enumerate(list,true);
for (int i = 0; i < count; i++) {
System.out.println("Thread " + list[i].getName() + " found.");
}
// 阻塞直到其他线程完成
t1.join();
t2.join();
} catch (InterruptedException ex) {
System.out.println(ex.toString());
}
}
// 实现 run()
public void run() {
for(int i = 0; i < 4;i++) {
i++;
try {
Thread.sleep(50);
} catch (InterruptedException e) {
// TODO 自动生成的 catch 块
e.printStackTrace();
}
}
System.out.println(Thread.currentThread().getName() + " finished executing.");
}
}
输出
让我们编译并运行上面的程序，这将产生以下结果 -
Starting Thread-0...
Starting Thread-1...
Thread Thread-0 found.
Thread Thread-1 found.
Thread-0 finished executing.
Thread-1 finished executing.