Java ThreadGroup 类

说明

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.