compact3

java.lang.management

Интерфейс ThreadMXBean

Все Суперинтерфейсы:

PlatformManagedObject

public interface ThreadMXBean
extends PlatformManagedObject

Интерфейс управления для системы потока виртуальной машины Java.

У виртуальной машины Java есть единственный экземпляр реализации class этого интерфейса. Этот экземпляр, реализовывая этот интерфейс является MXBean, который может быть получен, вызывая ManagementFactory.getThreadMXBean() метод или от platform MBeanServer метод.

ObjectName для однозначного определения MXBean для системы потока в пределах MBeanServer:

java.lang:type=Threading

Это может быть получено, вызывая PlatformManagedObject.getObjectName() метод.

ID потока

ID потока является положительным длинным значением, возвращенным, вызывая Thread.getId() метод для потока. ID потока уникален во время своего времени жизни. Когда поток завершается, этот ID потока может быть снова использован.

Некоторые методы в этом интерфейсе берут ID потока или массив ID потока как входной параметр и возвращают информацию на поток.

Распараллельте процессорное время

Реализация виртуальной машины Java может поддерживать измерение процессорного времени для текущего потока для любого потока, или ни для каких потоков.

isThreadCpuTimeSupported() метод может использоваться, чтобы определить, поддерживает ли виртуальная машина Java измерение процессорного времени для какого-либо потока. isCurrentThreadCpuTimeSupported() метод может использоваться, чтобы определить, поддерживает ли виртуальная машина Java измерение процессорного времени для текущего потока. Реализация виртуальной машины Java, которая поддерживает измерение процессорного времени для любого потока, будет также поддерживать это для текущего потока.

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

Виртуальная машина Java может отключить измерение процессорного времени по умолчанию. isThreadCpuTimeEnabled() и setThreadCpuTimeEnabled(boolean) методы могут использоваться, чтобы протестировать, если измерение процессорного времени включается и позволять/отключать этой поддержке соответственно. Включение измерению ЦП потока могло быть дорогим в некоторых реализациях виртуальной машины Java.

Распараллельте Состязательный Контроль

Некоторые виртуальные машины Java могут поддерживать контроль конкуренции потока. Когда контроль конкуренции потока будет включен, накопленное прошедшее время, когда поток блокировал для синхронизации или ожидал уведомления, будет собрано и возвращено в объекте ThreadInfo.

isThreadContentionMonitoringSupported() метод может использоваться, чтобы определить, поддерживает ли виртуальная машина Java контроль конкуренции потока. Контроль конкуренции потока отключается по умолчанию. setThreadContentionMonitoringEnabled(boolean) метод может использоваться, чтобы включить контролю конкуренции потока.

Информация о синхронизации и Обнаружение Мертвой блокировки

Некоторые виртуальные машины Java могут поддерживать контроль объектного использования монитора и ownable использования синхронизатора. getThreadInfo(long[], boolean, boolean) и dumpAllThreads(boolean, boolean) методы могут использоваться, чтобы получить трассировку стека потока и информацию о синхронизации, включая которую блокировку поток блокируется, чтобы получить или ожидающий на и который блокирует поток, в настоящий момент имеет.

Интерфейс ThreadMXBean обеспечивает findMonitorDeadlockedThreads() и findDeadlockedThreads() методы, чтобы найти мертвые блокировки в рабочем приложении.

С тех пор:

1.5

См. Также:

ManagementFactory.getPlatformMXBeans(Class), Спецификация JMX., Способы Получить доступ к MXBeans

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

Модификатор и Тип	Метод и Описание
ThreadInfo[]	dumpAllThreads(boolean lockedMonitors, boolean lockedSynchronizers) Возвращает информацию потока для всех живых потоков с трассировкой стека и информацией о синхронизации.
long[]	findDeadlockedThreads() Находит циклы потоков, которые находятся в мертвой блокировке, ожидающей, чтобы получить объектные мониторы или ownable синхронизаторы.
long[]	findMonitorDeadlockedThreads() Находит циклы потоков, которые находятся в мертвой блокировке, ожидающей, чтобы получить объектные мониторы.
long[]	getAllThreadIds() Возвраты все живые ID потока.
long	getCurrentThreadCpuTime() Возвращает полное процессорное время для текущего потока в наносекундах.
long	getCurrentThreadUserTime() Возвращает процессорное время, которое текущий поток выполнил в непривилегированном режиме в наносекундах.
int	getDaemonThreadCount() Возвращает текущее число живых потоков демона.
int	getPeakThreadCount() Возвращает пиковое живое количество потока, так как запущенная виртуальная машина Java или пик была сброшена.
int	getThreadCount() Возвращает текущее число живых потоков и включая демона и включая потоки недемона.
long	getThreadCpuTime(long id) Возвращает полное процессорное время для потока указанного ID в наносекундах.
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 выполнил в непривилегированном режиме в наносекундах.
long	getTotalStartedThreadCount() Возвращает общее количество создаваемых потоков и также запущенный начиная с запущенной виртуальной машины Java.
boolean	isCurrentThreadCpuTimeSupported() Тесты, если виртуальная машина Java поддерживает измерение процессорного времени для текущего потока.
boolean	isObjectMonitorUsageSupported() Тесты, если виртуальная машина Java поддерживает контроль объектного использования монитора.
boolean	isSynchronizerUsageSupported() Тесты, если виртуальная машина Java поддерживает контроль ownable использования синхронизатора.
boolean	isThreadContentionMonitoringEnabled() Тесты, если контроль конкуренции потока включается.
boolean	isThreadContentionMonitoringSupported() Тесты, если виртуальная машина Java поддерживает контроль конкуренции потока.
boolean	isThreadCpuTimeEnabled() Тесты, если измерение процессорного времени потока включается.
boolean	isThreadCpuTimeSupported() Тесты, если реализация виртуальной машины Java поддерживает измерение процессорного времени для какого-либо потока.
void	resetPeakThreadCount() Сбрасывает пиковое количество потока к текущему числу живых потоков.
void	setThreadContentionMonitoringEnabled(boolean enable) Включает или отключает контроль конкуренции потока.
void	setThreadCpuTimeEnabled(boolean enable) Включает или отключает измерение процессорного времени потока.

Методы, наследованные от интерфейса java.lang.management.PlatformManagedObject

getObjectName

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

getThreadCount

int getThreadCount()

Возвращает текущее число живых потоков и включая демона и включая потоки недемона.

Возвраты:

текущее число живых потоков.

getPeakThreadCount

int getPeakThreadCount()

Возвращает пиковое живое количество потока, так как запущенная виртуальная машина Java или пик была сброшена.

Возвраты:

пик живет количество потока.

getTotalStartedThreadCount

long getTotalStartedThreadCount()

Возвращает общее количество создаваемых потоков и также запущенный начиная с запущенной виртуальной машины Java.

Возвраты:

общее количество потоков запускалось.

getDaemonThreadCount

int getDaemonThreadCount()

Возвращает текущее число живых потоков демона.

Возвраты:

текущее число живых потоков демона.

getAllThreadIds

long[] getAllThreadIds()

Возвраты все живые ID потока. Некоторые потоки, включенные в возвращенный массив, возможно, были завершены, когда этот метод возвращается.

Возвраты:

массив long, каждый - ID потока.

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

getThreadInfo

ThreadInfo getThreadInfo(long id)

Возвращает информацию потока для потока указанного id без трассировки стека. Этот метод эквивалентен вызову:

getThreadInfo(id, 0);

Этот метод возвращает объект ThreadInfo представление информации о потоке для потока указанного ID. Трассировка стека, заблокированные мониторы, и заблокированные синхронизаторы в возвращенном объекте ThreadInfo будут пусты. Если поток данного ID не будет жив или не будет существовать, то этот метод возвратит null. Поток жив, если он был запущен и еще не умер.

Доступ MBeanServer:
Отображенным типом ThreadInfo является CompositeData с атрибутами как определено в ThreadInfo.from метод.

Параметры:

id - ID потока потока. Должно быть положительным.

Возвраты:

a ThreadInfo объект для потока данного ID без трассировки стека, никакого заблокированного монитора и никакой информации синхронизатора; null, если поток данного ID не жив или это не существует.

Броски:

IllegalArgumentException - если id <= 0.

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

getThreadInfo

ThreadInfo[] getThreadInfo(long[] ids)

Возвращает информацию потока для каждого потока, ID которого находится во входном массиве ids без трассировки стека. Этот метод эквивалентен вызову:

   getThreadInfo(ids, 0);
 

Этот метод возвращает массив объектов ThreadInfo. Трассировка стека, заблокированные мониторы, и заблокированные синхронизаторы в каждом объекте ThreadInfo будут пусты. Если поток данного ID не будет жив или не будет существовать, то соответствующий элемент в возвращенном массиве будет содержать null. Поток жив, если он был запущен и еще не умер.

Доступ MBeanServer:
Отображенным типом ThreadInfo является CompositeData с атрибутами как определено в ThreadInfo.from метод.

Параметры:

ids - массив ID потока.

Возвраты:

массив ThreadInfo объекты, каждый содержащий информацию о потоке, ID которого в своей стихии входного массива ID без трассировки стека, никакого заблокированного монитора и никакой информации синхронизатора.

Броски:

IllegalArgumentException - если каким-либо элементом во входном массиве ids является <= 0.

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

getThreadInfo

ThreadInfo getThreadInfo(long id,
                         int maxDepth)

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

Возвраты:

a ThreadInfo из потока данного ID без заблокированной информации монитора и синхронизатора null, если поток данного ID не жив или это не существует.

Броски:

IllegalArgumentException - если id <= 0.

IllegalArgumentException - если maxDepth is negative.

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

getThreadInfo

ThreadInfo[] getThreadInfo(long[] ids,
                           int maxDepth)

Возвращает информацию потока для каждого потока, ID которого находится во входном массиве ids с трассировкой стека конкретного количества микроэлементов стека. Параметр 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 is negative.

IllegalArgumentException - если каким-либо элементом во входном массиве ids является <= 0.

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

isThreadContentionMonitoringSupported

boolean isThreadContentionMonitoringSupported()

Тесты, если виртуальная машина Java поддерживает контроль конкуренции потока.

Возвраты:

true, если виртуальная машина Java поддерживает контроль конкуренции потока; false иначе.

isThreadContentionMonitoringEnabled

boolean isThreadContentionMonitoringEnabled()

Тесты, если контроль конкуренции потока включается.

Возвраты:

true, если контроль конкуренции потока включается; false иначе.

Броски:

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

См. Также:

isThreadContentionMonitoringSupported()

setThreadContentionMonitoringEnabled

void setThreadContentionMonitoringEnabled(boolean enable)

Включает или отключает контроль конкуренции потока. Состязательный контроль потока отключается по умолчанию.

Параметры:

enable - true, чтобы включить; false, чтобы отключить.

Броски:

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

SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.

См. Также:

isThreadContentionMonitoringSupported()

getCurrentThreadCpuTime

long getCurrentThreadCpuTime()

Возвращает полное процессорное время для текущего потока в наносекундах. Возвращенное значение имеет точность наносекунд, но не обязательно точность наносекунд. Если реализация различает время непривилегированного режима и системное время режима, возвращенное процессорное время является количеством времени, которое текущий поток выполнил в системном режиме или непривилегированном режиме.

Это - удобный метод для локального использования управления и эквивалентно вызову:

   getThreadCpuTime(Thread.currentThread().getId());
 

Возвраты:

полное процессорное время для текущего потока, если измерение процессорного времени включается; -1 иначе.

Броски:

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для текущего потока.

См. Также:

getCurrentThreadUserTime(), isCurrentThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getCurrentThreadUserTime

long getCurrentThreadUserTime()

Возвращает процессорное время, которое текущий поток выполнил в непривилегированном режиме в наносекундах. Возвращенное значение имеет точность наносекунд, но не обязательно точность наносекунд.

Это - удобный метод для локального использования управления и эквивалентно вызову:

   getThreadUserTime(Thread.currentThread().getId());
 

Возвраты:

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

Броски:

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для текущего потока.

См. Также:

getCurrentThreadCpuTime(), isCurrentThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getThreadCpuTime

long getThreadCpuTime(long id)

Возвращает полное процессорное время для потока указанного ID в наносекундах. Возвращенное значение имеет точность наносекунд, но не обязательно точность наносекунд. Если реализация различает время непривилегированного режима и системное время режима, возвращенное процессорное время является количеством времени, которое поток выполнил в системном режиме или непривилегированном режиме.

Если поток указанного ID не жив или не существует, этот метод возвращает -1. Если измерение процессорного времени отключается, этот метод возвращает -1. Поток жив, если он был запущен и еще не умер.

Если измерение процессорного времени включается после того, как поток запустился, реализация виртуальной машины Java может выбрать любое время до и включая время, когда возможность включается как точка, где измерение процессорного времени запускается.

Параметры:

id - ID потока потока

Возвраты:

полное процессорное время для потока указанного ID, если поток указанного ID существует, поток, живо, и измерение процессорного времени включается; -1 иначе.

Броски:

IllegalArgumentException - если id <= 0 .

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для других потоков.

См. Также:

getThreadUserTime(long), isThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getThreadUserTime

long getThreadUserTime(long id)

Возвращает процессорное время, которое поток указанного ID выполнил в непривилегированном режиме в наносекундах. Возвращенное значение имеет точность наносекунд, но не обязательно точность наносекунд.

Если поток указанного ID не жив или не существует, этот метод возвращает -1. Если измерение процессорного времени отключается, этот метод возвращает -1. Поток жив, если он был запущен и еще не умер.

Если измерение процессорного времени включается после того, как поток запустился, реализация виртуальной машины Java может выбрать любое время до и включая время, когда возможность включается как точка, где измерение процессорного времени запускается.

Параметры:

id - ID потока потока

Возвраты:

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

Броски:

IllegalArgumentException - если id <= 0 .

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для других потоков.

См. Также:

getThreadCpuTime(long), isThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

isThreadCpuTimeSupported

boolean isThreadCpuTimeSupported()

Тесты, если реализация виртуальной машины Java поддерживает измерение процессорного времени для какого-либо потока. Реализация виртуальной машины Java, которая поддерживает измерение процессорного времени для любого потока, будет также поддерживать измерение процессорного времени для текущего потока.

Возвраты:

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

isCurrentThreadCpuTimeSupported

boolean isCurrentThreadCpuTimeSupported()

Тесты, если виртуальная машина Java поддерживает измерение процессорного времени для текущего потока. Этот метод возвращает true если isThreadCpuTimeSupported() возвраты true.

Возвраты:

true, если виртуальная машина Java поддерживает измерение процессорного времени для текущего потока; false иначе.

isThreadCpuTimeEnabled

boolean isThreadCpuTimeEnabled()

Тесты, если измерение процессорного времени потока включается.

Возвраты:

true, если измерение процессорного времени потока включается; false иначе.

Броски:

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для других потоков, ни для текущего потока.

См. Также:

isThreadCpuTimeSupported(), isCurrentThreadCpuTimeSupported()

setThreadCpuTimeEnabled

void setThreadCpuTimeEnabled(boolean enable)

Включает или отключает измерение процессорного времени потока. Значение по умолчанию является зависимой платформой.

Параметры:

enable - true, чтобы включить; false, чтобы отключить.

Броски:

UnsupportedOperationException - если виртуальная машина Java не поддерживает измерение процессорного времени для каких-либо потоков, ни для текущего потока.

SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.

См. Также:

isThreadCpuTimeSupported(), isCurrentThreadCpuTimeSupported()

findMonitorDeadlockedThreads

long[] findMonitorDeadlockedThreads()

Находит циклы потоков, которые находятся в мертвой блокировке, ожидающей, чтобы получить объектные мониторы. Таким образом, потоки, которые блокируются, ожидая, чтобы ввести блок синхронизации или ожидая, чтобы повторно войти в блок синхронизации после Object.wait вызовите, где каждому потоку принадлежит один монитор, пытаясь получить другой монитор, уже сохраненный другим потоком в цикле.

Более формально поток является монитором, заведенным в тупик, если это - часть цикла в отношении, "ожидает объектного монитора, принадлежавшего". В самом простом случае A потока блокируется, ожидая монитора, принадлежавшего потоку B, и поток B блокируется, ожидая монитора, принадлежавшего потоку A.

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

Этот метод находит, что мертвые блокировки, включающие только, возражают мониторам. Найти мертвые блокировки, включающие и объект, контролирует и ownable синхронизаторы, findDeadlockedThreads метод должен использоваться.

Возвраты:

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

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

См. Также:

findDeadlockedThreads()

resetPeakThreadCount

void resetPeakThreadCount()

Сбрасывает пиковое количество потока к текущему числу живых потоков.

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.

См. Также:

getPeakThreadCount(), getThreadCount()

findDeadlockedThreads

long[] findDeadlockedThreads()

Находит циклы потоков, которые находятся в мертвой блокировке, ожидающей, чтобы получить объектные мониторы или ownable синхронизаторы. Потоки заводятся в тупик в цикле, ожидающем блокировки этих двух типов, если каждому потоку принадлежит одна блокировка, пытаясь получить другую блокировку, уже сохраненную другим потоком в цикле.

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

Возвраты:

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

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

UnsupportedOperationException - если виртуальная машина Java не поддерживает monitoriing ownable использования синхронизатора.

С тех пор:

1.6

См. Также:

isSynchronizerUsageSupported(), findMonitorDeadlockedThreads()

isObjectMonitorUsageSupported

boolean isObjectMonitorUsageSupported()

Тесты, если виртуальная машина Java поддерживает контроль объектного использования монитора.

Возвраты:

true, если виртуальная машина Java поддерживает контроль объектного использования монитора; false иначе.

С тех пор:

1.6

См. Также:

dumpAllThreads(boolean, boolean)

isSynchronizerUsageSupported

boolean isSynchronizerUsageSupported()

Тесты, если виртуальная машина Java поддерживает контроль ownable использования синхронизатора.

Возвраты:

true, если виртуальная машина Java поддерживает контроль ownable использования синхронизатора; false иначе.

С тех пор:

1.6

См. Также:

dumpAllThreads(boolean, boolean)

getThreadInfo

ThreadInfo[] getThreadInfo(long[] ids,
                           boolean lockedMonitors,
                           boolean lockedSynchronizers)

Возвращает информацию потока для каждого потока, ID которого находится во входном массиве ids с трассировкой стека и информацией о синхронизации.

Этот метод получает снимок информации о потоке для каждого потока включая:

• вся трассировка стека,
• объект контролирует в настоящий момент заблокированный потоком, если lockedMonitors является true, и
• ownable синхронизаторы, в настоящий момент заблокированные потоком, если lockedSynchronizers является true.

Этот метод возвращает массив объектов 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, получает, все заблокировали ownable синхронизаторы.

Возвраты:

массив ThreadInfo объекты, каждый содержащий информацию о потоке, ID которого в своей стихии входного массива ID.

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

UnsupportedOperationException -

• если lockedMonitors является true, но виртуальная машина Java не поддерживает контроль объектного использования монитора; или
• если lockedSynchronizers является true, но виртуальная машина Java не поддерживает контроль ownable использования синхронизатора.

С тех пор:

1.6

См. Также:

isObjectMonitorUsageSupported(), isSynchronizerUsageSupported()

dumpAllThreads

ThreadInfo[] dumpAllThreads(boolean lockedMonitors,
                            boolean lockedSynchronizers)

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

Этот метод возвращает массив ThreadInfo объекты как определено в getThreadInfo(long[], boolean, boolean) метод.

Параметры:

lockedMonitors - если true, дамп все заблокированные мониторы.

lockedSynchronizers - если true, дамп все заблокировали ownable синхронизаторы.

Возвраты:

массив ThreadInfo для всех живых потоков.

Броски:

SecurityException - если менеджер безопасности существует, и вызывающая сторона не сделала, чтобы ManagementPermission ("контролировал").

UnsupportedOperationException -

• если lockedMonitors является true, но виртуальная машина Java не поддерживает контроль объектного использования монитора; или
• если lockedSynchronizers является true, но виртуальная машина Java не поддерживает контроль ownable использования синхронизатора.

С тех пор:

1.6

См. Также:

isObjectMonitorUsageSupported(), isSynchronizerUsageSupported()