所有类


java.lang.management
接口 ThreadMXBean


public interface ThreadMXBean

Java 虚拟机线程系统的管理接口。

Java 虚拟机具有此接口的实现类的单一实例。实现此接口的实例是一个 MXBean,可以通过调用 ManagementFactory.getThreadMXBean() 方法或从平台 MBeanServer 方法获得。

在 MBeanServer 内惟一标识线程系统的 MXBean 的 ObjectName 为:

java.lang:type=Threading

线程 ID

线程 ID 是一个通过调用线程的 Thread.getId() 方法返回的 long 型正值。线程 ID 在其生存期间是惟一的。线程终止时,该线程 ID 可以被重新使用。

此接口中的某些方法将线程 ID 或线程 ID 数组作为输入参数,并返回每个线程的信息。

线程 CPU 时间

Java 虚拟机实现可能支持测量当前线程的 CPU 时间、测量任何线程的 CPU 时间,或不能测量任何线程的 CPU 时间。

isThreadCpuTimeSupported() 方法可以用于确定 Java 虚拟机是否支持测量任何线程的 CPU 时间。isCurrentThreadCpuTimeSupported() 方法可以用于确定 Java 虚拟机是否支持测量当前线程的 CPU 时间。支持任何线程 CPU 时间测量的 Java 虚拟机实现也支持当前线程的 CPU 时间测量。

此接口提供的 CPU 时间具有毫微秒精度,但并不具有毫微秒的准确性。

Java 虚拟机可能默认禁用 CPU 时间测量。isThreadCpuTimeEnabled()setThreadCpuTimeEnabled(boolean) 方法可用于测试是否启用 CPU 时间测量,并可分别启用/禁用此支持。启用线程 CPU 测量在某些 Java 虚拟机实现中可能开销很大。

线程争用监视

某些 Java 虚拟机可能支持线程争用监视。isThreadContentionMonitoringSupported() 方法可用于确定 Java 虚拟机是否支持线程争用监视。 默认情况下,线程争用监视是禁用的。setThreadContentionMonitoringEnabled(boolean) 方法可用于启用线程争用监视。

从以下版本开始:
1.5
另请参见:
JMX Specification., 访问 MXBeans 的方式

方法摘要
 long[] findMonitorDeadlockedThreads()
          找到处于死锁状态(等待获取对象监视器)的线程的周期。
 long[] getAllThreadIds()
          返回活动线程 ID。
 long getCurrentThreadCpuTime()
          返回当前线程的总 CPU 时间(以毫微秒为单位)。
 long getCurrentThreadUserTime()
          返回当前线程在用户模式中执行的 CPU 时间(以毫微秒为单位)。
 int getDaemonThreadCount()
          返回活动守护线程的当前数目。
 int getPeakThreadCount()
          返回自从 Java 虚拟机启动或峰值重置以来峰值活动线程计数。
 int getThreadCount()
          返回活动线程的当前数目,包括守护线程和非守护线程。
 long getThreadCpuTime(long id)
          返回指定 ID 的线程的总 CPU 时间(以毫微秒为单位)。
 ThreadInfo getThreadInfo(long id)
          返回指定 id 的不具有堆栈跟踪的线程的线程信息。
 ThreadInfo[] getThreadInfo(long[] ids)
          返回其 ID 在输出数组 ids 中的每个线程的线程信息,这些线程不具有堆栈跟踪。
 ThreadInfo[] getThreadInfo(long[] ids, int maxDepth)
          返回其 ID 在输入数组 ids 中的每个线程的线程信息。
 ThreadInfo getThreadInfo(long id, int maxDepth)
          返回指定的 id 的线程的线程信息。
 long getThreadUserTime(long id)
          返回指定 ID 的线程在用户模式中执行的 CPU 时间(以毫微秒为单位)。
 long getTotalStartedThreadCount()
          返回自从 Java 虚拟机启动以来创建和启动的线程总数目。
 boolean isCurrentThreadCpuTimeSupported()
          测试 Java 虚拟机是否支持当前线程的 CPU 时间测量。
 boolean isThreadContentionMonitoringEnabled()
          测试是否启用了线程争用监视。
 boolean isThreadContentionMonitoringSupported()
          测试 Java 虚拟机是否支持线程争用监视。
 boolean isThreadCpuTimeEnabled()
          测试是否启用了线程 CPU 时间测量。
 boolean isThreadCpuTimeSupported()
          测试 Java 虚拟机实现是否支持任何线程的 CPU 时间测量。
 void resetPeakThreadCount()
          将峰值线程计数重置为当前活动线程的数量。
 void setThreadContentionMonitoringEnabled(boolean enable)
          启用或禁用线程争用监视。
 void setThreadCpuTimeEnabled(boolean enable)
          启用或禁用线程 CPU 时间测量。
 

方法详细信息

getThreadCount

int getThreadCount()
返回活动线程的当前数目,包括守护线程和非守护线程。

返回:
活动线程的当前数目。

getPeakThreadCount

int getPeakThreadCount()
返回自从 Java 虚拟机启动或峰值重置以来峰值活动线程计数。

返回:
峰值活动线程计数。

getTotalStartedThreadCount

long getTotalStartedThreadCount()
返回自从 Java 虚拟机启动以来创建和启动的线程总数目。

返回:
已启动的线程的总数。

getDaemonThreadCount

int getDaemonThreadCount()
返回活动守护线程的当前数目。

返回:
活动守护线程的当前数目。

getAllThreadIds

long[] getAllThreadIds()
返回活动线程 ID。在返回的数组中包含的某些线程可能在此方法返回时已经终止。

返回:
long 数组,每个成员都是线程 ID。
抛出:
SecurityException - 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。

getThreadInfo

ThreadInfo getThreadInfo(long id)
返回指定 id 的不具有堆栈跟踪的线程的线程信息。 此方法等效于调用:
getThreadInfo(id, 0);

此方法返回表示指定 ID 的线程的线程信息的 ThreadInfo 对象。返回的 ThreadInfo 对象中的堆栈跟踪将为一个空的 StackTraceElement 数组。 如果给定 ID 的线程不为活动状态,或不存在,此方法将返回 null。如果线程已经启动且尚未终止,则该线程处于活动状态。

MBeanServer 访问
ThreadInfo 的映射类型为 CompositeData,具有 ThreadInfo 中指定的那些属性。

参数:
id - 线程的线程 ID。必须为正数。
返回:
给定 ID 的不具有堆栈跟踪的线程的 ThreadInfo 对象;如果给定 ID 的线程不为活动状态,或不存在,则返回 null
抛出:
IllegalArgumentException - 如果 id <= 0
SecurityException - 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。

getThreadInfo

ThreadInfo[] getThreadInfo(long[] ids)
返回其 ID 在输出数组 ids 中的每个线程的线程信息,这些线程不具有堆栈跟踪。此方法等效于调用:
   getThreadInfo(ids, 0);
 

此方法返回 ThreadInfo 对象数组。每个 ThreadInfo 对象中的堆栈跟踪将为空的 StackTraceElement 数组。 如果给定 ID 的线程不为活动状态,或不存在,返回数组中的对应元素将包含 null。如果线程已经启动且尚未终止,则该线程处于活动状态。

MBeanServer 访问
ThreadInfo 的映射类型为 CompositeData,具有 ThreadInfo 中指定的那些属性。

参数:
ids - 线程 ID 数组
返回:
一个 ThreadInfo 对象的数组,每个成员均包含关于其 ID 在 IDs 输入数组的对应元素中的线程的信息。
抛出:
IllegalArgumentException - 如果输入数组 ids 中的任何元素 <= 0
SecurityException - 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部