Spec-Zone.ru › OpenJDK 27

Интерфейс MethodExitRequest

Все суперинтерфейсы:
EventRequest, Mirror
public interface MethodExitRequest extends EventRequest
Запрос на уведомление о возврате метода в целевой виртуальной машине. Когда срабатывает включенный MethodExitRequest, event set, содержащий MethodExitEvent, помещается в EventQueue. Управление коллекцией существующих MethodExitRequest осуществляется посредством EventRequestManager
С версии:
1.3
См. также:
  • MethodExitEvent
  • EventQueue
  • EventRequestManager

Краткое описание полей

Поля, объявленные в интерфейсе EventRequest

SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE
Модификатор и тип Поле Описание
static final int SUSPEND_ALL
При возникновении события приостановить все потоки
static final int SUSPEND_EVENT_THREAD
При возникновении события приостановить только поток, вызвавший это событие
static final int SUSPEND_NONE
При возникновении события не приостанавливать потоки

Краткое описание методов

Модификатор и тип Метод Описание
void addClassExclusionFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в классе с именем, не соответствующим этому ограниченному регулярному выражению.
void addClassFilter(ReferenceType refType)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в заданном типе-ссылке или любом из его подтипов.
void addClassFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в классе с именем, соответствующим ограниченному регулярному выражению.
void addInstanceFilter(ObjectReference instance)
Ограничивает события, генерируемые этим запросом, только теми, в которых текущий исполняемый экземпляр («this») является указанным объектом.
void addThreadFilter(ThreadReference thread)
Ограничивает события, генерируемые этим запросом, только теми, которые происходят в указанном потоке.

Методы, объявленные в интерфейсе EventRequest

addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy
Модификатор и тип Метод Описание
void addCountFilter(int count)
Ограничивает выдачу запрошенного события так, чтобы оно сообщалось не более одного раза после заданного числа возникновений.
void disable()
То же, что и setEnabled(false).
void enable()
То же, что и setEnabled(true).
Object getProperty(Object key)
Возвращает значение свойства с указанным ключом.
boolean isEnabled()
Определяет, включен ли в данный момент этот запрос события.
void putProperty(Object key, Object value)
Добавляет к этому запросу произвольное свойство «ключ/значение».
void setEnabled(boolean val)
Включает или отключает этот запрос события.
void setSuspendPolicy(int policy)
Определяет, какие потоки следует приостановить при возникновении запрошенного события в целевой виртуальной машине.
int suspendPolicy()
Возвращает значение, описывающее, какие потоки следует приостановить при возникновении запрошенного события в целевой виртуальной машине.

Методы, объявленные в интерфейсе Mirror

toString, virtualMachine
Модификатор и тип Метод Описание
String toString()
Возвращает строку с описанием этого зеркала
VirtualMachine virtualMachine()
Возвращает виртуальную машину, к которой относится это зеркало.

Подробное описание методов

addThreadFilter

void addThreadFilter(ThreadReference thread)
Ограничивает события, генерируемые этим запросом, только теми, которые происходят в указанном потоке.
Параметры:
thread — поток, по которому выполняется фильтрация.
Исключения:
InvalidRequestStateException — если этот запрос в данный момент включен или был удален. Фильтры можно добавлять только к отключенным запросам.

addClassFilter

void addClassFilter(ReferenceType refType)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в заданном типе-ссылке или любом из его подтипов. Событие будет сгенерировано для любого местоположения в типе-ссылке, которое можно безопасно привести к заданному типу-ссылке.
Параметры:
refType — тип-ссылка, по которому выполняется фильтрация.
Исключения:
InvalidRequestStateException — если этот запрос в данный момент включен или был удален. Фильтры можно добавлять только к отключенным запросам.

addClassFilter

void addClassFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в классе с именем, соответствующим ограниченному регулярному выражению. Регулярные выражения ограничены точным совпадением и шаблонами, начинающимися или заканчивающимися символом '*'; например, "*.Foo" или "java.*".
Параметры:
classPattern — строка шаблона для фильтрации.
Исключения:
InvalidRequestStateException — если этот запрос в данный момент включен или был удален. Фильтры можно добавлять только к отключенным запросам.

addClassExclusionFilter

void addClassExclusionFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, только теми, метод которых находится в классе с именем, не соответствующим этому ограниченному регулярному выражению. Регулярные выражения ограничены точным совпадением и шаблонами, начинающимися или заканчивающимися символом '*'; например, "*.Foo" или "java.*".
Параметры:
classPattern — строка шаблона, используемая для фильтрации.
Исключения:
InvalidRequestStateException — если этот запрос в данный момент включен или был удален. Фильтры можно добавлять только к отключенным запросам.

addInstanceFilter

void addInstanceFilter(ObjectReference instance)
Ограничивает события, генерируемые этим запросом, только теми, в которых текущий исполняемый экземпляр («this») является указанным объектом.

Не все целевые системы поддерживают эту операцию. Используйте VirtualMachine.canUseInstanceFilters(), чтобы определить, поддерживается ли операция.

Параметры:
instance — объект, который должен быть текущим экземпляром, чтобы пройти этот фильтр.
Исключения:
UnsupportedOperationException — если целевая виртуальная машина не поддерживает эту операцию.
InvalidRequestStateException — если этот запрос в данный момент включен или был удален. Фильтры можно добавлять только к отключенным запросам.
С версии:
1.4

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API