|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface ThreadMXBean
Java 虚拟机线程系统的管理接口。
Java 虚拟机具有此接口的实现类的单一实例。实现此接口的实例是一个 MXBean,可以通过调用 ManagementFactory.getThreadMXBean()
方法或从平台 MBeanServer
方法获得它。
在 MBeanServer 内唯一标识线程系统的 MXBean 的 ObjectName 是:
java.lang:type=Threading
Thread.getId()
方法返回的 long 型正值。线程 ID 在其生存期间是唯一的。线程终止时,该线程 ID 可以被重新使用。
此接口中的某些方法将线程 ID 或线程 ID 数组作为输入参数,并返回每个线程的信息。
isThreadCpuTimeSupported()
方法可用于确定 Java 虚拟机是否支持测量任何线程的 CPU 时间。isCurrentThreadCpuTimeSupported()
方法可用于确定 Java 虚拟机是否支持测量当前线程的 CPU 时间。支持任何线程 CPU 时间测量的 Java 虚拟机实现也支持当前线程的 CPU 时间测量。
此接口提供的 CPU 时间具有毫微秒精度,但并不具有毫微秒的准确性。
Java 虚拟机可能默认禁用 CPU 时间测量。isThreadCpuTimeEnabled()
和 setThreadCpuTimeEnabled(boolean)
方法可用于测试是否启用 CPU 时间测量,并且可以分别启用/禁用此支持。启用线程 CPU 测量在某些 Java 虚拟机实现中可能开销很大。
isThreadContentionMonitoringSupported()
方法可用于确定 Java 虚拟机是否支持线程争用监视。默认情况下,线程争用监视是禁用的。setThreadContentionMonitoringEnabled(boolean)
方法可用于启用线程争用监视。
getThreadInfo(long[], boolean, boolean)
和 dumpAllThreads(boolean, boolean)
方法可以用来获取线程堆栈跟踪和同步信息,这些信息包括在获得线程时被哪一个锁阻塞或者正在等待哪一个锁,以及线程当前拥有哪些锁。
ThreadMXBean 接口提供 findMonitorDeadlockedThreads()
和 findDeadlockedThreads()
方法,这些方法用于在运行的应用程序中查找死锁。
方法摘要 | |
---|---|
ThreadInfo[] |
dumpAllThreads(boolean lockedMonitors,
boolean lockedSynchronizers)
返回所有活动线程的线程信息,并带有堆栈跟踪和同步信息。 |
long[] |
findDeadlockedThreads()
查找因为等待获得对象监视器或可拥有同步器而处于死锁状态的线程循环。 |
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,
boolean lockedMonitors,
boolean lockedSynchronizers)
返回每个线程的线程信息,线程 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 |
isObjectMonitorUsageSupported()
测试 Java 虚拟机是否支持使用对象监视器的监视。 |
boolean |
isSynchronizerUsageSupported()
测试 Java 虚拟机是否支持使用 可拥有同步器的监视。 |
boolean |
isThreadContentionMonitoringEnabled()
测试是否启用了线程争用监视。 |
boolean |
isThreadContentionMonitoringSupported()
测试 Java 虚拟机是否支持线程争用监视。 |
boolean |
isThreadCpuTimeEnabled()
测试是否启用了线程 CPU 时间测量。 |
boolean |
isThreadCpuTimeSupported()
测试 Java 虚拟机实现是否支持任何线程的 CPU 时间测量。 |
void |
resetPeakThreadCount()
将峰值线程计数重置为当前活动线程的数量。 |
void |
setThreadContentionMonitoringEnabled(boolean enable)
启用或禁用线程争用监视。 |
void |
setThreadCpuTimeEnabled(boolean enable)
启用或禁用线程 CPU 时间测量。 |
方法详细信息 |
---|
int getThreadCount()
int getPeakThreadCount()
long getTotalStartedThreadCount()
int getDaemonThreadCount()
long[] getAllThreadIds()
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。ThreadInfo getThreadInfo(long id)
getThreadInfo(id, 0);
此方法返回表示指定 ID 的线程的线程信息的 ThreadInfo 对象。返回的 ThreadInfo 对象中的堆栈跟踪、锁定的监视器、锁定的同步器将为空。 如果给定 ID 的线程没有处于活动状态,或不存在,则此方法将返回 null。如果线程已经启动且尚未终止,则该线程处于活动状态。
MBeanServer 访问:
ThreadInfo 的映射类型为 CompositeData,并具有 ThreadInfo.from
方法指定的那些属性。
id
- 线程的线程 ID。必须为正数。
ThreadInfo
对象,不带堆栈跟踪、锁定的监视器和同步器信息;如果给定 ID 的线程没有处于活动状态,或不存在,则返回 null。
IllegalArgumentException
- 如果 id <= 0。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。ThreadInfo[] getThreadInfo(long[] ids)
getThreadInfo
(ids, 0);
此方法返回 ThreadInfo 对象数组。每个 ThreadInfo 对象中的堆栈跟踪、锁定的监视器、锁定的同步器将为空。 如果给定 ID 的线程没有处于活动状态,或不存在,则返回数组中的对应元素将包含 null。如果线程已经启动且尚未终止,则该线程处于活动状态。
MBeanServer 访问:
ThreadInfo 的映射类型为 CompositeData,具有 ThreadInfo.from
方法指定的那些属性。
ids
- 线程 ID 数组。
ThreadInfo
对象的数组,每个数组元素均包含关于线程的信息,该线程 ID 在 ID 输入数组的对应元素中,不带堆栈跟踪、锁定的监视器和同步器信息。
IllegalArgumentException
- 如果输入数组 ids 中的任何元素 <= 0。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。ThreadInfo getThreadInfo(long id, int maxDepth)
StackTraceElement
的最大数目。如果 maxDepth == Integer.MAX_VALUE,则将转储线程的整个堆栈跟踪。如果 maxDepth == 0,则不转储线程的任何堆栈跟踪。此方法不获取线程的锁定的监视器和锁定同步器。
当 Java 虚拟机没有关于线程的堆栈跟踪信息或 maxDepth == 0 时,ThreadInfo 对象中的堆栈跟踪将为空的 StackTraceElement 数组。
如果给定 ID 的线程没有处于活动状态,或不存在,则此方法将返回 null。如果线程已经启动且尚未终止,则该线程处于活动状态。
MBeanServer 访问:
ThreadInfo 的映射类型为 CompositeData,具有 ThreadInfo.from
方法指定的那些属性。
id
- 线程的线程 ID。必须为正数。maxDepth
- 要转储的堆栈跟踪中的最大项数。Integer.MAX_VALUE 可用于请求将整个堆栈转储。
ThreadInfo
,不带锁定的监视器和同步器信息。如果给定 ID 的线程没有处于活动状态,或不存在,则返回 null。
IllegalArgumentException
- 如果 id <= 0。
IllegalArgumentException
- 如果 maxDepth 为负数。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。ThreadInfo[] getThreadInfo(long[] ids, int maxDepth)
StackTraceElement
的最大数目。如果 maxDepth == Integer.MAX_VALUE,则将转储线程的整个堆栈跟踪。如果 maxDepth == 0,则不转储线程的任何堆栈跟踪。此方法不获取线程的锁定的监视器和锁定同步器。
当 Java 虚拟机没有关于线程的堆栈跟踪信息或 maxDepth == 0 时,ThreadInfo 对象中的堆栈跟踪将为空的 StackTraceElement 数组。
此方法返回一个 ThreadInfo 对象的数组,其每个成员均为关于线程的线程信息,索引顺序与 ids 数组中索引相同。如果给定 ID 的线程没有处于活动状态,或不存在,则返回数组中的对应元素将设置为 null。如果线程已经启动且尚未终止,则该线程处于活动状态。
MBeanServer 访问:
ThreadInfo 的映射类型为 CompositeData,具有 ThreadInfo.from
方法指定的那些属性。
ids
- 线程 ID 数组maxDepth
- 要转储的堆栈跟踪中的最大项数。Integer.MAX_VALUE 可用于请求将整个堆栈转储。
ThreadInfo
对象组成的数组,每个数组元素均包含关于线程的信息,该线程 ID 在 ID 输入数组的对应元素中,不带锁定的监视器和同步器信息。
IllegalArgumentException
- 如果 maxDepth 为负数。
IllegalArgumentException
- 如果输入数组 ids 中的任何元素 <= 0。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。boolean isThreadContentionMonitoringSupported()
boolean isThreadContentionMonitoringEnabled()
UnsupportedOperationException
- 如果 Java 虚拟机不支持线程争用监视。isThreadContentionMonitoringSupported()
void setThreadContentionMonitoringEnabled(boolean enable)
enable
- 为 true 则启用;为 false 则禁用。
UnsupportedOperationException
- 如果 Java 虚拟机不支持线程争用监视。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("control")。isThreadContentionMonitoringSupported()
long getCurrentThreadCpuTime()
这是一个便于局部管理的方法,等效于调用:
getThreadCpuTime
(Thread.currentThread().getId());
UnsupportedOperationException
- 如果 Java 虚拟机不支持当前线程的 CPU 时间测量。getCurrentThreadUserTime()
,
isCurrentThreadCpuTimeSupported()
,
isThreadCpuTimeEnabled()
,
setThreadCpuTimeEnabled(boolean)
long getCurrentThreadUserTime()
这是一个便于局部管理的方法,等效于调用:
getThreadUserTime
(Thread.currentThread().getId());
UnsupportedOperationException
- 如果 Java 虚拟机不支持当前线程的 CPU 时间测量。getCurrentThreadCpuTime()
,
isCurrentThreadCpuTimeSupported()
,
isThreadCpuTimeEnabled()
,
setThreadCpuTimeEnabled(boolean)
long getThreadCpuTime(long id)
如果指定 ID 的线程没有处于活动状态,或不存在,则此方法将返回 -1。如果 CPU 时间测量,此方法将返回 -1。如果线程已经启动且尚未终止,则该线程处于活动状态。
如果线程启动后启用了 CPU 时间测量,Java 虚拟机实现可能选择任何时间作为启动 CPU 时间测量的时间,包括启用此功能的时间。
id
- 线程的线程 ID
IllegalArgumentException
- 如果 id <= 0。
UnsupportedOperationException
- 如果 Java 虚拟机不支持其他线程的 CPU 时间测定。getThreadUserTime(long)
,
isThreadCpuTimeSupported()
,
isThreadCpuTimeEnabled()
,
setThreadCpuTimeEnabled(boolean)
long getThreadUserTime(long id)
如果指定 ID 的线程没有处于活动状态,或不存在,则此方法将返回 -1。如果禁用 CPU 时间测量,此方法将返回 -1。如果线程已经启动且尚未终止,则该线程处于活动状态。
如果线程启动后启用了 CPU 时间测量,Java 虚拟机实现可能选择任何时间作为启动 CPU 时间测量的时间,包括启用此功能的时间。
id
- 线程的线程 ID
IllegalArgumentException
- 如果 id <= 0。
UnsupportedOperationException
- 如果 Java 虚拟机不支持其他线程的 CPU 时间测定。getThreadCpuTime(long)
,
isThreadCpuTimeSupported()
,
isThreadCpuTimeEnabled()
,
setThreadCpuTimeEnabled(boolean)
boolean isThreadCpuTimeSupported()
boolean isCurrentThreadCpuTimeSupported()
isThreadCpuTimeSupported()
返回 true,此方法将返回 true。
boolean isThreadCpuTimeEnabled()
UnsupportedOperationException
- 如果 Java 虚拟机不支持其他线程或当前线程的 CPU 时间测量。isThreadCpuTimeSupported()
,
isCurrentThreadCpuTimeSupported()
void setThreadCpuTimeEnabled(boolean enable)
enable
- 为 true 则启用;为 false 则禁用。
UnsupportedOperationException
- 如果 Java 虚拟机不支持任何线程或当前线程的 CPU 时间测量。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("control")。isThreadCpuTimeSupported()
,
isCurrentThreadCpuTimeSupported()
long[] findMonitorDeadlockedThreads()
Object.wait
调用后等待重新进入同步块,此时每个线程拥有一个监视器,且同时试图获取已经由周期中的另一个线程拥有的另一个监视器。
更正式地说,如果线程属于某个周期,处于“等待已被占用的对象监视器”的关系中,则该线程处于监视器死锁 状态。在最简单的情况下,线程 A 被阻塞,在等待线程 B 拥有的监视器,而线程 B 也被阻塞,在等待线程 A 拥有的监视器。
此方法设计用于进行故障排除,但不适合进行同步控制。它可能成为开销很大的操作。
此方法只查找涉及对象监视器的死锁。要查找涉及对象监视器和可拥有同步器的死锁,应该使用 findDeadlockedThreads
方法。
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission("monitor")。findDeadlockedThreads()
void resetPeakThreadCount()
SecurityException
- 如果存在安全管理器,且调用方不具有 ManagementPermission(("control")。getPeakThreadCount()
,
getThreadCount()
long[] findDeadlockedThreads()
此方法设计用于故障排除,不用于异常控制。它是一个开销很大的操作。
SecurityException
- 如果安全管理器存在,且调用者没有 ManagementPermission("monitor")。
UnsupportedOperationException
- 如果 Java 虚拟机不支持使用可拥有同步器的监视。isSynchronizerUsageSupported()
,
findMonitorDeadlockedThreads()
boolean isObjectMonitorUsageSupported()
dumpAllThreads(boolean, boolean)
boolean isSynchronizerUsageSupported()
dumpAllThreads(boolean, boolean)
ThreadInfo[] getThreadInfo(long[] ids, boolean lockedMonitors, boolean lockedSynchronizers)
此方法获取每个线程的线程信息快照,包括:
此方法返回 ThreadInfo 对象数组,每个数组元素是关于线程的线程信息,该线程带有与 ids 数组中相同的索引。如果给定 ID 的线程没有处于活动状态,或不存在,则返回数组中的对应元素将被设置为 null。如果一个线程已经启动且尚未关闭,则称该线程是活动的。
如果线程没有锁定任何对象监视器或 lockedMonitors 为 false,那么返回的 ThreadInfo 对象将有一个空 MonitorInfo 数组。类似地,如果线程没有锁定任何同步器或 lockedSynchronizers 为 false,那么返回的 ThreadInfo 对象将有一个空 LockInfo 数组。
当 lockedMonitors 和 lockedSynchronizers 参数均为 false 时,它等效于调用:
getThreadInfo(ids, Integer.MAX_VALUE)
此方法设计用于故障排除,不用于异常控制。它是一个开销很大的操作。
MBeanServer 访问:
ThreadInfo 的映射类型为 CompositeData,并带有 ThreadInfo.from
方法指定的属性。
ids
- 线程 ID 数组。lockedMonitors
- 如果为 true,则获取所有锁定的监视器。lockedSynchronizers
- 如果为 true,则获取所有锁定的可拥有同步器。
ThreadInfo
对象数组,每个数组元素包含有关线程的信息,该线程的 ID 在 ID 输入数组的对应元素中。
SecurityException
- 如果安全管理器存在,且调用者没有 ManagementPermission("monitor")。
UnsupportedOperationException
- isObjectMonitorUsageSupported()
,
isSynchronizerUsageSupported()
ThreadInfo[] dumpAllThreads(boolean lockedMonitors, boolean lockedSynchronizers)
此方法返回 ThreadInfo
对象数组,ThreadInfo 对象是使用 getThreadInfo(long[], boolean, boolean)
方法指定的。
lockedMonitors
- 如果为 true,则转储所有锁定的监视器。lockedSynchronizers
- 如果为 true,则转储所有锁定的可拥有同步器。
ThreadInfo
数组。
SecurityException
- 如果安全管理器存在,且调用者没有 ManagementPermission("monitor")。
UnsupportedOperationException
- isObjectMonitorUsageSupported()
,
isSynchronizerUsageSupported()
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。