模块 jdk.jdi

软件包 com.sun.jdi.request

Interface ClassPrepareRequest

All Superinterfaces:

EventRequest ， Mirror

public interface ClassPrepareRequest
extends EventRequest

在目标VM中准备类时请求通知。 当开启了ClassPrepareRequest被满足，一个event set含有ClassPrepareEvent将被放置在EventQueue 。 现有ClassPrepareRequests的收集是由管理EventRequestManager

类准备在Java虚拟机规范中定义。

从以下版本开始：

1.3

另请参见：

ClassPrepareEvent ， EventQueue ， EventRequestManager

字段汇总

Fields declared in interface 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，那么至少存在一个层，在refType.availableStrata（）返回的列表上称它为“someStratum”; 这样refType.sourceNames（someStratam）返回的列表上的名称与'sourceNamePattern'匹配。 正则表达式仅限于以'*'开头或以'*'结尾的完全匹配和模式; 例如，“* .Foo”或“java。*”。

并非所有目标都支持此操作。 使用VirtualMachine.canUseSourceNameFilters()确定是否支持该操作。

参数

sourceNamePattern - 要筛选的模式字符串。

异常

UnsupportedOperationException - 如果目标虚拟机不支持此操作。

InvalidRequestStateException - 如果此请求当前已启用或已被删除。 过滤器只能添加到已禁用的请求中。

从以下版本开始：

1.6