-
- All Superinterfaces:
-
Mirror
public interface EventRequestManager extends Mirror
管理EventRequest
的创建和删除。 此接口的单个实现者存在于特定VM中,可通过VirtualMachine.eventRequestManager()
访问- 从以下版本开始:
- 1.3
- 另请参见:
-
EventRequest
,Event
,BreakpointRequest
,BreakpointEvent
,VirtualMachine
-
-
方法摘要
-
声明方法的接口 com.sun.jdi.Mirror
toString, virtualMachine
-
-
-
-
方法详细信息
-
createClassPrepareRequest
ClassPrepareRequest createClassPrepareRequest()
- 结果
-
创建
ClassPrepareRequest
-
createClassUnloadRequest
ClassUnloadRequest createClassUnloadRequest()
- 结果
-
创建
ClassUnloadRequest
-
createThreadStartRequest
ThreadStartRequest createThreadStartRequest()
- 结果
-
创建于
ThreadStartRequest
-
createThreadDeathRequest
ThreadDeathRequest createThreadDeathRequest()
- 结果
-
创建
ThreadDeathRequest
-
createExceptionRequest
ExceptionRequest createExceptionRequest(ReferenceType refType, boolean notifyCaught, boolean notifyUncaught)
创建一个新的禁用ExceptionRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。可以为异常事件选择特定的异常类型及其子类。 可以选择捕获的异常,未捕获的异常或两者。 但请注意,在抛出异常时,并不总是可以确定它是否真正被捕获。 有关详细信息,请参见
ExceptionEvent.catchLocation()
。- 参数
-
refType
- 如果为非null,则指定将报告作为refType实例的异常。 注意:这将包括子类型的实例。 如果为null,则将报告所有实例 -
notifyCaught
- 如果为true,将报告捕获的异常。 -
notifyUncaught
- 如果为true,将报告未捕获的异常。 - 结果
-
创建的
ExceptionRequest
-
createMethodEntryRequest
MethodEntryRequest createMethodEntryRequest()
- 结果
-
创建
MethodEntryRequest
-
createMethodExitRequest
MethodExitRequest createMethodExitRequest()
- 结果
-
创建
MethodExitRequest
-
createMonitorContendedEnterRequest
MonitorContendedEnterRequest createMonitorContendedEnterRequest()
创建一个新的禁用MonitorContendedEnterRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。 并非所有目标虚拟机都支持此操作。 使用VirtualMachine.canRequestMonitorEvents()
确定是否支持该操作。- 结果
-
创建
MonitorContendedEnterRequest
- 异常
-
UnsupportedOperationException
- 如果目标VM不支持此操作。 - 从以下版本开始:
- 1.6
-
createMonitorContendedEnteredRequest
MonitorContendedEnteredRequest createMonitorContendedEnteredRequest()
创建一个新的禁用MonitorContendedEnteredRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。 并非所有目标虚拟机都支持此操作。 使用VirtualMachine.canRequestMonitorEvents()
确定是否支持该操作。- 结果
-
创建
MonitorContendedEnteredRequest
- 异常
-
UnsupportedOperationException
- 如果目标VM不支持此操作。 - 从以下版本开始:
- 1.6
-
createMonitorWaitRequest
MonitorWaitRequest createMonitorWaitRequest()
创建一个新的禁用MonitorWaitRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。 并非所有目标虚拟机都支持此操作。 使用VirtualMachine.canRequestMonitorEvents()
确定是否支持该操作。- 结果
-
创建
MonitorWaitRequest
- 异常
-
UnsupportedOperationException
- 如果目标VM不支持此操作。 - 从以下版本开始:
- 1.6
-
createMonitorWaitedRequest
MonitorWaitedRequest createMonitorWaitedRequest()
创建一个新的禁用MonitorWaitedRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。 并非所有目标虚拟机都支持此操作。 使用VirtualMachine.canRequestMonitorEvents()
确定是否支持该操作。- 结果
-
创建
MonitorWaitedRequest
- 异常
-
UnsupportedOperationException
- 如果目标VM不支持此操作。 - 从以下版本开始:
- 1.6
-
createStepRequest
StepRequest createStepRequest(ThreadReference thread, int size, int depth)
创建一个新的禁用StepRequest
。 新事件请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。返回的请求将仅控制指定的
thread
中的步进; 所有其他线程将不受影响。 每次代码索引更改时,size
值StepRequest.STEP_MIN
将生成步骤事件。 它代表可用的最小步长,通常映射到指令级别。 每次源行更改时,size
值StepRequest.STEP_LINE
将生成一个步骤事件,除非行号信息不可用,在这种情况下,将执行STEP_MIN。 例如,在执行已被VirtualMachine.redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)
操作废弃的方法期间,没有行号信息可用。depth
值StepRequest.STEP_INTO
将在任何被调用的方法中生成步骤事件。depth
值StepRequest.STEP_OVER
将步骤事件限制为当前帧或调用者帧。depth
值StepRequest.STEP_OUT
仅将步骤事件限制为调用者帧。 所有深度限制都是在步骤发生之前立即相对于调用堆栈。每个线程只允许一个待处理步骤请求。
请注意,典型调试器将在检测到第一步后取消步进。 因此,下一行方法将执行以下操作:
EventRequestManager mgr = myVM.{@link VirtualMachine#eventRequestManager eventRequestManager}(); StepRequest request = mgr.createStepRequest(myThread, StepRequest.{@link StepRequest#STEP_LINE STEP_LINE}, StepRequest.{@link StepRequest#STEP_OVER STEP_OVER}); request.{@link EventRequest#addCountFilter addCountFilter}(1); // next step only request.enable(); myVM.{@link VirtualMachine#resume resume}();
- 参数
-
thread
- 要执行的线程 -
depth
- 步深 -
size
- 步长 - 结果
-
创建的
StepRequest
- 异常
-
DuplicateRequestException
- 如果已存在指定线程的挂起步骤请求。 -
IllegalArgumentException
- 如果size或depth参数包含非法值。
-
createBreakpointRequest
BreakpointRequest createBreakpointRequest(Location location)
创建一个新的禁用BreakpointRequest
。 给定的Location
必须具有有效(即非负)代码索引。 新断点将添加到此EventRequestManager管理的列表中。 允许在同一位置使用多个断点。 使用EventRequest.enable()
激活此事件请求。- 参数
-
location
- 新断点的位置。 - 结果
-
创建
BreakpointRequest
- 异常
-
NativeMethodException
- 如果位置在本机方法中。
-
createAccessWatchpointRequest
AccessWatchpointRequest createAccessWatchpointRequest(字段 field)
创建一个新的禁用观察点,监视对指定字段的访问。 新观察点将添加到此EventRequestManager管理的列表中。 允许在同一个字段上有多个观察点。 使用EventRequest.enable()
激活此事件请求。并非所有目标虚拟机都支持此操作。 使用
VirtualMachine.canWatchFieldAccess()
确定是否支持该操作。- 参数
-
字段
-字段
的领域 - 结果
- 创建的观察点
- 异常
-
UnsupportedOperationException
- 如果目标虚拟机不支持此操作。
-
createModificationWatchpointRequest
ModificationWatchpointRequest createModificationWatchpointRequest(字段 field)
创建一个新的禁用观察点,监视对指定字段的访问。 新观察点将添加到此EventRequestManager管理的列表中。 允许在同一个字段上有多个观察点。 使用EventRequest.enable()
激活此事件请求。并非所有目标虚拟机都支持此操作。 使用
VirtualMachine.canWatchFieldModification()
确定是否支持该操作。- 参数
-
字段
-字段
的领域 - 结果
- 创建的观察点
- 异常
-
UnsupportedOperationException
- 如果目标虚拟机不支持此操作。
-
createVMDeathRequest
VMDeathRequest createVMDeathRequest()
创建一个新的禁用VMDeathRequest
。 新请求将添加到此EventRequestManager管理的列表中。 使用EventRequest.enable()
激活此事件请求。此请求(如果已启用)将导致在终止目标VM时发送
VMDeathEvent
。具有挂起策略
SUSPEND_ALL
的VMDeathRequest可用于确保在VM死亡之前处理传入的SUSPEND_NONE
或SUSPEND_EVENT_THREAD
事件。 如果正在读取事件集的同一线程中进行所有事件处理,则启用该请求是因为VM将被暂停,直到恢复包含VMDeathEvent
的EventSet
为止。并非所有目标虚拟机都支持此操作。 使用
VirtualMachine.canRequestVMDeathEvent()
确定是否支持该操作。- 结果
- 创建的请求
- 异常
-
UnsupportedOperationException
- 如果目标VM不支持此操作。 - 从以下版本开始:
- 1.4
-
deleteEventRequest
void deleteEventRequest(EventRequest eventRequest)
删除eventRequest。 eventRequest被禁用,并从此EventRequestManager管理的请求中删除。 删除eventRequest后,不允许任何操作(例如,EventRequest.setEnabled(boolean)
) - 尝试这样做通常会导致InvalidRequestStateException
。 没有其他事件请求生效。因为此方法更改了事件请求的基础列表,所以尝试直接从请求访问者返回的列表中删除(例如,在下面):
Iterator iter = requestManager.stepRequests().iterator(); while (iter.hasNext()) { requestManager.deleteEventRequest(iter.next()); }
可能会导致ConcurrentModificationException
。 而是使用deleteEventRequests(List)
或在迭代之前复制列表。- 参数
-
eventRequest
- 要删除的eventRequest
-
deleteEventRequests
void deleteEventRequests(List<? extends EventRequest> eventRequests)
删除EventRequest
的列表。- 参数
-
eventRequests
- 要删除的eventRequests列表 - 另请参见:
-
deleteEventRequest(EventRequest)
-
deleteAllBreakpoints
void deleteAllBreakpoints()
删除此EventRequestManager管理的所有断点。
-
stepRequests
List<StepRequest> stepRequests()
返回已启用和已禁用步骤请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
StepRequest
个对象。
-
classPrepareRequests
List<ClassPrepareRequest> classPrepareRequests()
返回已启用和已禁用的类准备请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ClassPrepareRequest
对象。
-
classUnloadRequests
List<ClassUnloadRequest> classUnloadRequests()
返回已启用和已禁用的类卸载请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ClassUnloadRequest
个对象。
-
threadStartRequests
List<ThreadStartRequest> threadStartRequests()
返回已启用和已禁用的线程启动请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ThreadStartRequest
对象。
-
threadDeathRequests
List<ThreadDeathRequest> threadDeathRequests()
返回已启用和已禁用的线程死亡请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ThreadDeathRequest
对象。
-
exceptionRequests
List<ExceptionRequest> exceptionRequests()
返回已启用和已禁用的异常请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ExceptionRequest
对象。
-
breakpointRequests
List<BreakpointRequest> breakpointRequests()
返回已启用和已禁用断点请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
BreakpointRequest
个对象的列表。
-
accessWatchpointRequests
List<AccessWatchpointRequest> accessWatchpointRequests()
返回已启用和已禁用的访问观察点请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
AccessWatchpointRequest
对象。
-
modificationWatchpointRequests
List<ModificationWatchpointRequest> modificationWatchpointRequests()
返回已启用和已禁用的修改观察点请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
ModificationWatchpointRequest
对象。
-
methodEntryRequests
List<MethodEntryRequest> methodEntryRequests()
返回已启用和已禁用的方法条目请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MethodEntryRequest
对象的列表。
-
methodExitRequests
List<MethodExitRequest> methodExitRequests()
返回已启用和已禁用方法退出请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MethodExitRequest
对象的列表。
-
monitorContendedEnterRequests
List<MonitorContendedEnterRequest> monitorContendedEnterRequests()
返回已启用和已禁用的监视器争用输入请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MonitorContendedEnterRequest
对象的列表。 - 从以下版本开始:
- 1.6
-
monitorContendedEnteredRequests
List<MonitorContendedEnteredRequest> monitorContendedEnteredRequests()
返回已启用和已禁用的监视器争用输入请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MonitorContendedEnteredRequest
对象的列表。 - 从以下版本开始:
- 1.6
-
monitorWaitRequests
List<MonitorWaitRequest> monitorWaitRequests()
返回已启用和已禁用的监视器等待请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MonitorWaitRequest
对象的列表。 - 从以下版本开始:
- 1.6
-
monitorWaitedRequests
List<MonitorWaitedRequest> monitorWaitedRequests()
返回已启用和已禁用的监视器等待请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。- 结果
-
所有
MonitorWaitedRequest
对象的列表。 - 从以下版本开始:
- 1.6
-
vmDeathRequests
List<VMDeathRequest> vmDeathRequests()
返回已启用和已禁用的VM死亡请求的不可修改列表。 此列表是这些请求的实时视图,因此在添加和删除请求时进行更改。 注意:未经请求的VMDeathEvent没有相应的请求。- 结果
-
所有
VMDeathRequest
对象的列表。 - 从以下版本开始:
- 1.4
-
-