Класс ThreadInfo

Информация о потоке. ThreadInfo содержит информацию о потоке, включая:

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

• Идентификатор потока.
• Имя потока.

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

• Состояние потока.
• Объект, на котором поток заблокирован из-за:
  • ожидания входа в блок/метод синхронизации, или
  • ожидания уведомления в методе Object.wait, или
  • остановки из-за вызова LockSupport.park.
• Идентификатор потока, владеющего объектом, на котором заблокирован поток.
• Стек вызовов потока.
• Список мониторов объектов, заблокированных потоком.
• Список блокируемых синхронизаторов, заблокированных потоком.

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

• Количество раз, когда поток блокировался для синхронизации или ожидал уведомления.
• Накопленное время ожидания потоком синхронизации или уведомления с момента включения thread contention monitoring. Некоторые реализации Java виртуальной машины могут не поддерживать это. Метод ThreadMXBean.isThreadContentionMonitoringSupported() может быть использован для определения поддержки этого в Java виртуальной машине.

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

Сопоставление MXBean

Методы

getThreadId

public long getThreadId()

Возвращает идентификатор потока, связанного с этим ThreadInfo.

Возвращает:

идентификатор связанного потока.

getThreadName

public String getThreadName()

Возвращает имя потока, связанного с этим ThreadInfo.

Возвращает:

имя связанного потока.

getThreadState

public Thread.State getThreadState()

Возвращает состояние потока, связанного с этим ThreadInfo.

Возвращает:

состояние связанного потока.

getBlockedTime

public long getBlockedTime()

Возвращает:

приблизительное накопленное время ожидания в миллисекундах, в течение которого поток вошел в состояние BLOCKED ; -1 если мониторинг конкуренции потоков отключен.

Исключение:

UnsupportedOperationException - если виртуальная машина Java не поддерживает эту операцию.

См. также:

ThreadMXBean.isThreadContentionMonitoringSupported(), ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getBlockedCount

public long getBlockedCount()

Возвращает общее количество раз, которое поток, связанный с этим ThreadInfo заблокировал вход или повторный вход в монитор. То есть количество раз, когда поток был в состоянии BLOCKED.

Возвращает:

общее количество раз, когда поток вошёл в состояние BLOCKED.

getWaitedTime

public long getWaitedTime()

Возвращает:

приблизительное накопленное время ожидания в миллисекундах, которое поток провел в состоянии 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 объекта, за которым поток заблокирован в ожидании, если таковой имеется; null в противном случае.

С:

1.6

getLockName

public String getLockName()

getLockInfo().toString()

Возвращает:

строковое представление объекта, на котором поток заблокирован, если таковой имеется; null в противном случае.

См. также:

getLockInfo()

getLockOwnerId

public long getLockOwnerId()

Возвращает идентификатор потока, который владеет объектом, за которым поток, связанный с этим ThreadInfo заблокирован в ожидании. Этот метод возвратит -1 если этот поток не заблокирован в ожидании какого-либо объекта или если объект не принадлежит ни одному потоку.

Возвращает:

идентификатор потока владельца объекта, на котором заблокирован этот поток; -1 если этот поток не заблокирован или если объект не принадлежит ни одному потоку.

См. также:

getLockInfo()

getLockOwnerName

public String getLockOwnerName()

Возвращает имя потока, который владеет объектом, за которым поток, связанный с этим ThreadInfo заблокирован в ожидании. Этот метод возвратит null если этот поток не заблокирован в ожидании какого-либо объекта или если объект не принадлежит ни одному потоку.

Возвращает:

имя потока-владельца объекта, на котором заблокирован этот поток; null если этот поток не заблокирован или если объект не принадлежит ни одному потоку.

См. также:

getLockInfo()

getStackTrace

public StackTraceElement[] getStackTrace()

Возвращает:

массив StackTraceElement объектов потока.

isSuspended

public boolean isSuspended()

Проверяет, приостановлен ли поток, связанный с этим ThreadInfo. Этот метод возвращает true если был вызван Thread.suspend().

Возвращает:

true если поток приостановлен; false в противном случае.

isInNative

public boolean isInNative()

Проверяет, выполняет ли поток, связанный с этим ThreadInfo код нативных функций через Java Native Interface (JNI). Нативный код JNI не включает в себя поддержку виртуальной машины или скомпилированный нативный код, сгенерированный виртуальной машиной.

Возвращает:

true если поток выполняет нативный код; false в противном случае.

toString

public String toString()

Возвращает строковое представление этой информации о потоке. Формат этой строки зависит от реализации. Возвращаемая строка обычно включает в себя имя потока, идентификатор потока, его состояние и стек вызовов, если таковой имеется.

Переопределяет:

toString в классе Object

Возвращает:

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

from

public static ThreadInfo from(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, каждый из которых представляет собой владеющий синхронизатор, который в данный момент заблокирован потоком, связанным с этим ThreadInfo. Если для этого потока не был запрошен заблокированный синхронизатор или поток не заблокировал ни одного синхронизатора, этот метод вернёт массив нулевой длины.

Возвращает:

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

С:

1.6