Интерфейс ClassPrepareRequest

Все суперинтерфейсы:: EventRequest, Mirror

public interface ClassPrepareRequest extends EventRequest

Запрос на получение уведомления о подготовке класса в целевой виртуальной машине. Когда удовлетворяется включённый ClassPrepareRequest, event set, содержащий ClassPrepareEvent, помещается в EventQueue. Коллекцией существующих ClassPrepareRequest управляет EventRequestManager.

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

Начиная с версии:

1.3

См. также:

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

Поля, объявленные в интерфейсе 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' подготавливаемого ссылочного типа.

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

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

Методы, объявленные в интерфейсе 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, то в списке, возвращаемом refType.availableStrata(), существует как минимум один элемент stratum, назовём его 'someStratum', такой, что одно из имён в списке, возвращаемом refType.sourceNames(someStratam), соответствует 'sourceNamePattern'. Регулярные выражения ограничены точными совпадениями и шаблонами, начинающимися с '*' или заканчивающимися на '*'; например, "*.Foo" или "java.*".

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

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

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