ThreadInfo (Java Platform SE 8 )

java.lang.Object
- java.lang.management.ThreadInfo

```
public class ThreadInfo
extends Object
```
线程信息。 ThreadInfo包含一个线程的信息包括：
通用线程信息
- 线程ID。
- 线程的名称。
执行信息
- 线程状态。
- 在该线程被阻塞由于对象：
  - 等待输入一个同步块/方法，或
  - 等待一种Object.wait方法通知，或
  - 由于一个LockSupport.park叫停车。
- 拥有线程被阻塞的对象的线程的标识。
- 线程的堆栈跟踪。
- 线程锁定的对象监视器列表。
- 通过对 ownable synchronizers螺纹锁列表。
Synchronization Statistics
- 线程已被同步或等待通知的次数。
- 经过时间的积累，线程阻塞同步或等待通知自thread contention monitoring启用。一些java虚拟机的实现可能不支持这个。的ThreadMXBean.isThreadContentionMonitoringSupported()方法可用来确定是否一个java虚拟机的支持。
此线程信息类是专为用于监视系统而设计的，而不是用于同步控制。

MXBean映射
ThreadInfo映射到一个 CompositeData属性中指定的 from方法。
从以下版本开始：

一点五

另请参见：

ThreadMXBean.getThreadInfo(long)， ThreadMXBean.dumpAllThreads(boolean, boolean)

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`static ThreadInfo`	`from(CompositeData cd)` 返回一个给定的 `CompositeData`代表 `ThreadInfo`对象。
`long`	`getBlockedCount()` 返回时间，这 `ThreadInfo`阻止进入或重新进入监控相关的线程的总数。
`long`	`getBlockedTime()` 返回近似的累计时间（以毫秒为单位），这 `ThreadInfo`关联的线程已经封锁了进入或重新进入监控由于线程争用监控启用。
`MonitorInfo[]`	`getLockedMonitors()` 返回 `MonitorInfo`对象的数组，每个代表一个对象进行监测，这 `ThreadInfo`关联的线程锁定目前。
`LockInfo[]`	`getLockedSynchronizers()` 返回 `LockInfo`对象的数组，其中每一个代表一个 ownable synchronizer采用这种 `ThreadInfo`关联的线程锁定目前。
`LockInfo`	`getLockInfo()` 返回 `LockInfo`对象与该 `ThreadInfo`关联的线程阻塞等待。
`String`	`getLockName()` 返回 `string representation`对象与该 `ThreadInfo`关联的线程阻塞等待。
`long`	`getLockOwnerId()` 返回ID的线程拥有的对象，这 `ThreadInfo`关联的线程阻塞等待。
`String`	`getLockOwnerName()` 返回的名称的线程拥有的对象，这 `ThreadInfo`关联的线程阻塞等待。
`StackTraceElement[]`	`getStackTrace()` 返回这个 `ThreadInfo`关联的线程的堆栈跟踪。
`long`	`getThreadId()` 返回这个 `ThreadInfo`关联的线程的ID。
`String`	`getThreadName()` 返回这个 `ThreadInfo`相关线程的名字。
`Thread.State`	`getThreadState()` 返回这个 `ThreadInfo`关联的线程的状态。
`long`	`getWaitedCount()` 返回时间，这 `ThreadInfo`关联的线程等待通知的总数。
`long`	`getWaitedTime()` 返回近似的累计时间（以毫秒为单位），这 `ThreadInfo`关联的线程等待线程争用监控启用通知。
`boolean`	`isInNative()` 如果这 `ThreadInfo`关联的线程执行本地代码通过java本地接口（JNI）。
`boolean`	`isSuspended()` 如果这 `ThreadInfo`关联的线程被挂起。
`String`	`toString()` 返回此线程信息的字符串表示形式。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

方法详细信息

getThreadId
```
public long getThreadId()
```
返回这个 ThreadInfo关联的线程的ID。

结果

关联线程的标识。

getThreadName
```
public String getThreadName()
```
返回这个 ThreadInfo相关线程的名字。

结果

关联线程的名称。

getThreadState
```
public Thread.State getThreadState()
```
返回这个 ThreadInfo关联的线程的状态。

结果

对关联的线程 Thread.State。

getBlockedTime
```
public long getBlockedTime()
```
返回近似的累计时间（以毫秒为单位），这 ThreadInfo关联的线程已经封锁了进入或重新进入监控由于线程争用监控启用。即累计时间线自去年启用线程争用监测在 BLOCKED状态。此方法返回 -1如果线程争用监控被禁用。
java虚拟机可以测量高分辨率定时器的时间。这一统计重置时，线程争用监控启用。

结果

近似的经过时间的积累在毫秒，线程进入 BLOCKED状态； -1如果线程争用监控被禁用。

异常

UnsupportedOperationException如果java虚拟机不支持此操作。

另请参见：

ThreadMXBean.isThreadContentionMonitoringSupported()， ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getBlockedCount
```
public long getBlockedCount()
```
返回时间，这 ThreadInfo阻止进入或重新进入监控相关的线程的总数。即时间线已在 BLOCKED状态数。

结果

次线程进入 BLOCKED状态总数。

getWaitedTime
```
public long getWaitedTime()
```
返回近似的累计时间（以毫秒为单位），这 ThreadInfo关联的线程等待线程争用监控启用通知。即累计时间线已在 WAITING或 TIMED_WAITING自启用线程争用状态监测。如果线程争用监控被禁用此方法返回 -1。
java虚拟机可以测量高分辨率定时器的时间。这一统计重置时，线程争用监控启用。

结果

近似的经过时间的积累在毫秒，线程已经在 WAITING或 TIMED_WAITING状态； -1如果线程争用监控被禁用。

异常

UnsupportedOperationException如果java虚拟机不支持此操作。

另请参见：

ThreadMXBean.isThreadContentionMonitoringSupported()， ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getWaitedCount
```
public long getWaitedCount()
```
返回时间，这 ThreadInfo关联的线程等待通知的总数。即次数线程已经在 WAITING或 TIMED_WAITING状态。

结果

总次数：线程是在 WAITING或 TIMED_WAITING状态。

getLockInfo
```
public LockInfo getLockInfo()
```
返回 LockInfo对象与该 ThreadInfo关联的线程阻塞等待。一个线程可以被阻塞等待下列之一：
- 一个对象监视器是进入或进入一个同步块/方法获得。
  the线程在BLOCKED状态等待进入synchronized语句或方法。
- 由另一个线程通知的对象监视器。
  the线程在WAITING或TIMED_WAITING由于打电话到Object.wait方法状态。
- 负责线程停车的同步对象。
  the线程在WAITING或TIMED_WAITING由于打电话到LockSupport.park方法状态。同步对象从LockSupport.getBlocker方法返回的对象。它通常是一个 ownable synchronizer或Condition。
此方法返回null如果线程不在上述任何条件。
结果

一个对象的线程被阻塞等待，如果任何 LockInfo； null否则。

从以下版本开始：

一点六

getLockName
```
public String getLockName()
```
返回 string representation对象与该 ThreadInfo关联的线程阻塞等待。这种方法相当于调用：
```
 getLockInfo().toString()
 
```
这个方法将返回null如果线程不阻塞如果对象没有被任何线程拥有等待任何对象或。
结果

在该线程被阻塞如果任何对象的字符串表示形式； null否则。

另请参见：

getLockInfo()

getLockOwnerId
```
public long getLockOwnerId()
```
返回ID的线程拥有的对象，这 ThreadInfo关联的线程阻塞等待。该方法将如果线程不阻塞如果对象没有被任何线程拥有等待任何对象或返回 -1。

结果

业主的线程对象的这个线程被阻塞的线程的ID； -1如果线程不阻塞或如果对象没有被任何线程拥有。

另请参见：

getLockInfo()

getLockOwnerName
```
public String getLockOwnerName()
```
返回的名称的线程拥有的对象，这 ThreadInfo关联的线程阻塞等待。该方法将如果线程不阻塞如果对象没有被任何线程拥有等待任何对象或返回 null。

结果

该线程拥有这个对象的线程被阻塞的名称； null如果线程不阻塞或如果对象没有被任何线程拥有。

另请参见：

getLockInfo()

getStackTrace
```
public StackTraceElement[] getStackTrace()
```
返回这个 ThreadInfo关联的线程的堆栈跟踪。如果此线程信息没有请求堆栈跟踪，此方法将返回一零个长度数组。如果返回的数组是非零的长度，那么数组的第一个元素代表堆栈的顶部，这是序列中最新的方法调用。数组的最后一个元素表示堆栈的底部，这是序列中的最近的方法调用。
一些java虚拟机可以在某些情况下，省略一个或多个堆栈帧从堆栈跟踪。在极端的情况下，虚拟机没有堆栈跟踪信息关于这个ThreadInfo关联的线程被允许返回一零数组长度从这个方法。

结果

线程的 StackTraceElement对象数组。

isSuspended
```
public boolean isSuspended()
```
如果这 ThreadInfo关联的线程被挂起。此方法返回 true如果 Thread.suspend()被称为。

结果

true如果线程被挂起； false否则。

isInNative
```
public boolean isInNative()
```
如果这 ThreadInfo关联的线程执行本地代码通过java本地接口（JNI）。JNI本地代码不包括虚拟机支持代码或编译本地代码由虚拟机生成的。

结果

true如果线程执行本地代码； false否则。

toString
```
public String toString()
```
返回此线程信息的字符串表示形式。这个字符串的格式取决于实现。返回的字符串通常包含 thread name，的 thread ID，其 state，和 stack trace如果任何。

重写：

toString 方法重写，继承类 Object

结果

此线程信息的字符串表示。

from

public static ThreadInfo from(CompositeData cd)

返回一个对象的 CompositeData代表了 ThreadInfo。给定的 CompositeData必须包含以下属性除非下文另有规定：

Attribute Name Type

threadId java.lang.Long

threadName java.lang.String

threadState java.lang.String

suspended java.lang.Boolean

inNative java.lang.Boolean

blockedCount java.lang.Long

blockedTime java.lang.Long

waitedCount java.lang.Long

waitedTime java.lang.Long

lockInfo javax.management.openmbean.CompositeData - the mapped type for LockInfo as specified in the LockInfo.from(javax.management.openmbean.CompositeData) method.
If cd does not contain this attribute, the LockInfo object will be constructed from the value of the lockName attribute.

lockName java.lang.String

lockOwnerId java.lang.Long

lockOwnerName java.lang.String

stackTrace javax.management.openmbean.CompositeData[]
Each element is a CompositeData representing StackTraceElement containing the following attributes:

Attribute Name Type

className java.lang.String

methodName java.lang.String

fileName java.lang.String

lineNumber java.lang.Integer

nativeMethod java.lang.Boolean

lockedMonitors javax.management.openmbean.CompositeData[] whose element type is the mapped type for MonitorInfo as specified in the Monitor.from method.
If cd does not contain this attribute, this attribute will be set to an empty array.

lockedSynchronizers javax.management.openmbean.CompositeData[] whose element type is the mapped type for LockInfo as specified in the LockInfo.from(javax.management.openmbean.CompositeData) method.
If cd does not contain this attribute, this attribute will be set to an empty array.

参数: cd - CompositeData代表 ThreadInfo
结果: 一个 ThreadInfo对象代表的 cd如果 cd不 null； null否则。
异常: IllegalArgumentException -如果 cd并不代表上述属性 ThreadInfo。

getLockedMonitors
```
public MonitorInfo[] getLockedMonitors()
```
返回 MonitorInfo对象的数组，每个代表一个对象进行监测，这 ThreadInfo关联的线程锁定目前。如果没有被锁定的监视器被请求为这个线程信息或没有监视器被锁定的线程，这种方法将返回一零个长度数组。

结果

对 MonitorInfo对象代表对象的监视器的线程锁定数组。

从以下版本开始：

一点六

getLockedSynchronizers
```
public LockInfo[] getLockedSynchronizers()
```
返回 LockInfo对象的数组，其中每一个代表一个 ownable synchronizer采用这种 ThreadInfo关联的线程锁定目前。如果没有锁定的同步请求这个线程的信息或不同步的线程锁定，此方法将返回一零数组长度。

结果

表示可拥有同步器的螺纹锁 LockInfo对象数组。

从以下版本开始：

一点六

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ThreadInfo

通用线程信息

执行信息

Synchronization Statistics

MXBean映射

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

getThreadId

getThreadName

getThreadState

getBlockedTime

getBlockedCount

getWaitedTime

getWaitedCount

getLockInfo

getLockName

getLockOwnerId

getLockOwnerName

getStackTrace

isSuspended

isInNative

toString

from

getLockedMonitors

getLockedSynchronizers