Spec-Zone.ru › OpenJDK 17

Интерфейс ClassPrepareRequest

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

Подготовка класса определяется в спецификации Java Virtual Machine.

С момента:
1.3
См. также:
  • ClassPrepareEvent
  • EventQueue
  • EventRequestManager

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

Поля, объявленные в интерфейсе com.sun.jdi.request.EventRequest

SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE

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

Модификатор и тип Метод Описание
void addClassExclusionFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, подготовкой типов ссылок, имя которых не соответствует этой ограниченной регулярной записи.
void addClassFilter(ReferenceType refType)
Ограничивает события, генерируемые этим запросом, подготовкой заданного типа ссылки и всех его подтипов.
void addClassFilter(String classPattern)
Ограничивает события, генерируемые этим запросом, подготовкой типов ссылок, имя которых соответствует этой ограниченной регулярной записи.
void addSourceNameFilter(String sourceNamePattern)
Ограничивает события, генерируемые этим запросом, подготовкой типов ссылок, для которых ограниченная регулярная запись 'sourceNamePattern' соответствует одному из 'sourceNames' для подготавливаемого типа ссылки.

Методы, объявленные в интерфейсе com.sun.jdi.request.EventRequest

addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy

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

toString, virtualMachine

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

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 - если этот запрос в настоящее время включен или был удалён. Фильтры могут быть добавлены только к отключённым запросам.

addSourceNameFilter

void addSourceNameFilter(String sourceNamePattern)
Ограничивает события, генерируемые этим запросом, подготовкой типов ссылок, для которых ограниченная регулярная запись 'sourceNamePattern' соответствует одному из 'sourceNames' для подготавливаемого типа ссылки. То есть, если refType - это ReferenceType, который готовится, то существует по крайней мере один слой, назовем его 'someStratum', в списке, возвращаемом refType.availableStrata(); такой, что имя в списке, возвращаемом refType.sourceNames(someStratam), соответствует 'sourceNamePattern'. Регулярные выражения ограничены точным соответствием и шаблонами, начинающимися с '*' или заканчивающимися '*'; например, "*.Foo" или "java.*".

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

Параметры:
sourceNamePattern - строка шаблона для фильтрации.
Исключения:
UnsupportedOperationException - если целевая виртуальная машина не поддерживает эту операцию.
InvalidRequestStateException - если этот запрос в настоящее время включен или был удалён. Фильтры могут быть добавлены только к отключённым запросам.
С момента:
1.6

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/jdk.jdi/com/sun/jdi/request/ClassPrepareRequest.html

Spec-Zone.ru

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