compact3

java.lang.management

Класс ThreadInfo

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 это.

Эта информация о потоке class разрабатывается для использования в контроле системы, не для управления синхронизацией.

Отображение 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() Возвращает строковое представление этой информации потока.

Методы, наследованные от class 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 в class 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 как определено в LockInfo.from(javax.management.openmbean.CompositeData) метод. Если 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 как определено в LockInfo.from(javax.management.openmbean.CompositeData) метод. Если 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