ThreadInfo (Платформа Java SE 7)

java.lang. Объект
- java.lang.management. ThreadInfo

```
public class ThreadInfo
extends Object
```
Информация о потоке. ThreadInfo содержит информацию о потоке включая:
Общая информация о потоке
- ID потока.
- Имя потока.
Информация о выполнении
- Состояние потока.
- Объект, на который поток блокируется из-за:
  - ожидание, чтобы ввести блок/метод синхронизации, или
  - ожидание, которое будет уведомлено в a Object.wait метод, или
  - парковка из-за a LockSupport.park вызвать.
- ID потока, которому принадлежит объект, что поток блокируется.
- Трассировка стека потока.
- Список объектных мониторов заблокирован потоком.
- Список ownable синхронизаторов заблокирован потоком.
Статистика синхронизации
- Число раз, которое поток блокировал для синхронизации или ожидал уведомления.
- Накопленное прошедшее время, когда поток блокировал для синхронизации или ожидал уведомления с тех пор thread contention monitoring был включен. Некоторая реализация виртуальной машины Java, возможно, не поддерживает это. ThreadMXBean.isThreadContentionMonitoringSupported() метод может использоваться, чтобы определить, поддерживает ли виртуальная машина Java это.
Этот класс информации о потоке разрабатывается для использования в контроле системы, не для управления синхронизацией.
Отображение MXBean
ThreadInfo отображается на a CompositeData с атрибутами как определено в from метод.
С тех пор:

1.5

См. Также:
ThreadMXBean.getThreadInfo(long), ThreadMXBean.dumpAllThreads(boolean, boolean)

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`static ThreadInfo`	`from(CompositeData cd)` Возвращает объект `ThreadInfo`, представленный данным `CompositeData`.
`long`	`getBlockedCount()` Возвращает общее количество времен что поток, связанный с этим `ThreadInfo`, блокированным, чтобы ввести или повторно войти в монитор.
`long`	`getBlockedTime()` Возвращает приблизительное накопленное прошедшее время (в миллисекундах), который поток, связанный с этим `ThreadInfo`, блокировал, чтобы ввести или повторно войти в монитор, так как контроль конкуренции потока включается.
`MonitorInfo[]`	`getLockedMonitors()` Возвращает массив `MonitorInfo` объекты, каждый из которых представляет объектный монитор, в настоящий момент заблокированный потоком, связанным с этим `ThreadInfo`.
`LockInfo[]`	`getLockedSynchronizers()` Возвращает массив `LockInfo` объекты, каждый из которых представляет ownable синхронизатор, в настоящий момент заблокированный потоком, связанным с этим `ThreadInfo`.
`LockInfo`	`getLockInfo()` Возвращает `LockInfo` объекта, для которого поток, связанный с этим `ThreadInfo`, блокируется, ожидая.
`Строка`	`getLockName()` Возвраты `string representation` из объекта, для которого поток, связанный с этим `ThreadInfo`, блокируется, ожидая.
`long`	`getLockOwnerId()` Возвращает ID потока, которому принадлежит объект, для которого поток, связанный с этим `ThreadInfo`, блокируется, ожидая.
`Строка`	`getLockOwnerName()` Возвращает имя потока, которому принадлежит объект, для которого поток, связанный с этим `ThreadInfo`, блокируется, ожидая.
`StackTraceElement[]`	`getStackTrace()` Возвращает трассировку стека потока, связанного с этим `ThreadInfo`.
`long`	`getThreadId()` Возвращает ID потока, связанного с этим `ThreadInfo`.
`Строка`	`getThreadName()` Возвращает имя потока, связанного с этим `ThreadInfo`.
`Поток. Государство`	`getThreadState()` Возвращает состояние потока, связанного с этим `ThreadInfo`.
`long`	`getWaitedCount()` Возвращает общее количество времен, что поток, связанный с этим `ThreadInfo`, ожидал уведомления.
`long`	`getWaitedTime()` Возвращает приблизительное накопленное прошедшее время (в миллисекундах), что поток, связанный с этим `ThreadInfo`, ожидал уведомления, так как контроль конкуренции потока включается.
`boolean`	`isInNative()` Тесты, если поток, связанный с этим `ThreadInfo`, выполняет собственный код через Java Собственный Интерфейс (JNI).
`boolean`	`isSuspended()` Тесты, если поток, связанный с этим `ThreadInfo`, приостанавливается.
`Строка`	`toString()` Возвращает строковое представление этой информации потока.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь метода

getThreadId
```
public long getThreadId()
```
Возвращает ID потока, связанного с этим 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 может измерить время с таймером высокого разрешения. Эта статистическая величина сбрасывается, когда контроль конкуренции потока повторно включается.

Возвраты:
приблизительное накопленное прошедшее время в миллисекундах, что поток был в состоянии TIMED_WAITING или WAITING; -1, если контроль конкуренции потока отключается.

Броски:

UnsupportedOperationException - если виртуальная машина Java не поддерживает эту работу.
См. Также:
ThreadMXBean.isThreadContentionMonitoringSupported(), ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getWaitedCount
```
public long getWaitedCount()
```
Возвращает общее количество времен, что поток, связанный с этим ThreadInfo, ожидал уведомления. То есть число раз, что поток был в WAITING или TIMED_WAITING состояние.

Возвраты:
общее количество времен, что поток был в состоянии TIMED_WAITING или WAITING.

getLockInfo
```
public LockInfo getLockInfo()
```
Возвращает LockInfo объекта, для которого поток, связанный с этим ThreadInfo, блокируется, ожидая. Поток может быть блокирован, ожидая одного из следующего:
- объектный монитор, который будет получен за ввод или возвращение в блок/метод синхронизации.
  Поток находится в BLOCKED состояние, ожидающее, чтобы ввести оператор synchronized или метод.
- объектный монитор, который будет уведомлен другим потоком.
  Поток находится в WAITING или TIMED_WAITING утвердите из-за звонка Object.wait метод.
- объект синхронизации, ответственный за парковку потока.
  Поток находится в WAITING или TIMED_WAITING утвердите из-за звонка LockSupport.park метод. Объект синхронизации является объектом, возвращенным из LockSupport.getBlocker метод. Обычно это - ownable синхронизатор или a Condition.
Этот метод возвращает null, если поток не находится ни в одном из вышеупомянутых условий.
Возвраты:
LockInfo объекта, для которого поток блокируется, ожидая если любой; null иначе.
С тех пор:

1.6

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()
```
Возвращает строковое представление этой информации потока. Формат этой строки зависит от реализации. Возвращенная строка будет обычно включать имя потока, ID потока, его состояние, и трассировку стека если любой.

Переопределения:

toString в классе Object

Возвраты:
строковое представление этой информации потока.

от

public static ThreadInfo from(CompositeData cd)

Возвращает объект ThreadInfo, представленный данным CompositeData. Данный CompositeData должен содержать следующие атрибуты если иначе не определено ниже:

Название атрибута Ввести

threadId java.lang.Long

threadName java.lang.String

threadState java.lang.String

приостановленный 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 - отображенный тип для LockInfo как определено в правилах отображения типа MXBeans.
Если cd не будет содержать этот атрибут, то объект LockInfo будет создан из значения атрибута lockName.

lockName java.lang.String

lockOwnerId java.lang.Long

lockOwnerName java.lang.String

stackTrace javax.management.openmbean.CompositeData[]
Каждый элемент является представлением CompositeData StackTraceElement, содержащий следующие атрибуты:

Название атрибута Ввести

имя класса java.lang.String

methodName java.lang.String

имя файла java.lang.String

lineNumber java.lang.Integer

nativeMethod java.lang.Boolean

lockedMonitors javax.management.openmbean.CompositeData[], тип элемента которого является отображенным типом для MonitorInfo как определено в Monitor.from метод.
Если cd не будет содержать этот атрибут, то этот атрибут будет установлен в пустой массив.

lockedSynchronizers javax.management.openmbean.CompositeData[], тип элемента которого является отображенным типом для LockInfo как определено в правилах отображения типа MXBeans.
Если cd не будет содержать этот атрибут, то этот атрибут будет установлен в пустой массив.

Параметры:: cd - CompositeData, представляющий ThreadInfo
Возвраты:: объект ThreadInfo, представленный cd, если cd не является null; null иначе.
Броски:: IllegalArgumentException - если cd не представляет ThreadInfo с атрибутами, описанными выше.

getLockedMonitors
```
public MonitorInfo[] getLockedMonitors()
```
Возвращает массив MonitorInfo объекты, каждый из которых представляет объектный монитор, в настоящий момент заблокированный потоком, связанным с этим ThreadInfo. Если никакой заблокированный монитор не требовали на эту информацию потока, или никакой монитор не блокируется потоком, этот метод возвратит массив нулевой длиной.

Возвраты:
массив объектов MonitorInfo, представляющих объектные мониторы, заблокирован потоком.
С тех пор:

1.6

getLockedSynchronizers
```
public LockInfo[] getLockedSynchronizers()
```
Возвращает массив LockInfo объекты, каждый из которых представляет ownable синхронизатор, в настоящий момент заблокированный потоком, связанным с этим ThreadInfo. Если никакой заблокированный синхронизатор не требовали на эту информацию потока, или никакой синхронизатор не блокируется потоком, этот метод возвратит массив нулевой длиной.

Возвраты:
массив объектов LockInfo, представляющих ownable синхронизаторы, заблокирован потоком.
С тех пор:

1.6

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ThreadInfo

Общая информация о потоке

Информация о выполнении

Статистика синхронизации

Отображение MXBean

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь метода

getThreadId

getThreadName

getThreadState

getBlockedTime

getBlockedCount

getWaitedTime

getWaitedCount

getLockInfo

getLockName

getLockOwnerId

getLockOwnerName

getStackTrace

isSuspended

isInNative

toString

от

getLockedMonitors

getLockedSynchronizers