Интерфейс EventRequestManager

ClassPrepareRequest createClassPrepareRequest()

Создает новый отключенный ClassPrepareRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

ClassUnloadRequest createClassUnloadRequest()

Создает новый отключенный ClassUnloadRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

ThreadStartRequest createThreadStartRequest()

Создает новый отключенный ThreadStartRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

ThreadDeathRequest createThreadDeathRequest()

Создает новый отключенный ThreadDeathRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

ExceptionRequest createExceptionRequest(ReferenceType refType, boolean notifyCaught, boolean notifyUncaught)

Создает новый отключенный ExceptionRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

Можно выбрать конкретный тип исключения и его подклассы для событий исключений. Можно выбрать перехваченные исключения, неперехваченные исключения или оба типа. Однако в момент возникновения исключения не всегда можно определить, действительно ли оно перехвачено. См. ExceptionEvent.catchLocation() для получения подробностей.

MethodEntryRequest createMethodEntryRequest()

Создает новый отключенный MethodEntryRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

MethodExitRequest createMethodExitRequest()

Создает новый отключенный MethodExitRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

MonitorContendedEnterRequest createMonitorContendedEnterRequest()

Создает новый отключенный MonitorContendedEnterRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события. Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canRequestMonitorEvents() для определения поддержки операции.

MonitorContendedEnteredRequest createMonitorContendedEnteredRequest()

Создает новый отключенный MonitorContendedEnteredRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события. Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canRequestMonitorEvents() для определения поддержки операции.

MonitorWaitRequest createMonitorWaitRequest()

Создает новый отключенный MonitorWaitRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события. Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canRequestMonitorEvents() для определения поддержки операции.

MonitorWaitedRequest createMonitorWaitedRequest()

Создает новый отключенный MonitorWaitedRequest. Новый запрос события добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события. Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canRequestMonitorEvents() для определения поддержки операции.

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}();
 

BreakpointRequest createBreakpointRequest(Location location)

Создаёт новый отключённый BreakpointRequest. Указанный Location должен иметь допустимый (то есть неотрицательный) индекс кода. Новый брейкпоинт добавляется в список, управляемый этим EventRequestManager. Несколько брейкпоинтов в одном месте допускаются. Используйте EventRequest.enable() для активации этого запроса событий.

AccessWatchpointRequest createAccessWatchpointRequest(Field field)

Создаёт новый отключённый наблюдательный пункт, который следит за доступом к указанному полю. Новый наблюдательный пункт добавляется в список, управляемый этим EventRequestManager. Несколько наблюдательных пунктов для одного и того же поля допускаются. Используйте EventRequest.enable() для активации этого запроса события.

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

ModificationWatchpointRequest createModificationWatchpointRequest(Field field)

Создаёт новый отключённый наблюдательный пункт, который следит за доступом к указанному полю. Новый наблюдательный пункт добавляется в список, управляемый этим EventRequestManager. Несколько наблюдательных пунктов для одного и того же поля допускаются. Используйте EventRequest.enable() для активации этого запроса события.

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

VMDeathRequest createVMDeathRequest()

Создаёт новый отключённый VMDeathRequest. Новый запрос добавляется в список, управляемый этим EventRequestManager. Используйте EventRequest.enable() для активации этого запроса события.

Этот запрос (если он активирован) заставит отправить VMDeathEvent при завершении целевой VM.

VMDeathRequest с политикой приостановки SUSPEND_ALL может использоваться для обеспечения обработки входящих SUSPEND_NONE или SUSPEND_EVENT_THREAD событий до смерти VM. Если вся обработка событий выполняется в том же потоке, что и считывание наборов событий, включение запроса — всё, что нужно, так как VM будет приостановлена, пока не будет возобновлён EventSet, содержащий VMDeathEvent.

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

void deleteEventRequest(EventRequest eventRequest)

Удаляет eventRequest. eventRequest отключается и удаляется из запросов, управляемых этим EventRequestManager. После удаления eventRequest, никакие операции (например, EventRequest.setEnabled(boolean)) не разрешены - попытки сделать это, как правило, приведут к InvalidRequestStateException. Никакие другие eventRequests не затронуты.

Поскольку этот метод изменяет базовые списки запросов событий, попытки прямого удаления из списка, возвращенного аксессором запроса (например, ниже):

   Iterator iter = requestManager.stepRequests().iterator();
   while (iter.hasNext()) {
      requestManager.deleteEventRequest(iter.next());
  }
 

может вызвать ConcurrentModificationException. Вместо этого используйте deleteEventRequests(List) или скопируйте список перед итерацией.

void deleteEventRequests(List<? extends EventRequest> eventRequests)

Удаляет список EventRequests.

void deleteAllBreakpoints()

Удаляет все брейкпоинты, управляемые этим EventRequestManager.

List<StepRequest> stepRequests()

Возвращает неизменяемый список запросов шага, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ClassPrepareRequest> classPrepareRequests()

Возвращает неизменяемый список запросов подготовки классов, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ClassUnloadRequest> classUnloadRequests()

Возвращает неизменяемый список запросов разгрузки классов, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ThreadStartRequest> threadStartRequests()

Возвращает неизменяемый список запросов запуска потоков, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ThreadDeathRequest> threadDeathRequests()

Возвращает неизменяемый список запросов смерти потоков, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ExceptionRequest> exceptionRequests()

Возвращает неизменяемый список запросов исключений, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<BreakpointRequest> breakpointRequests()

Возвращает неизменяемый список запросов брейкпоинтов, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<AccessWatchpointRequest> accessWatchpointRequests()

Возвращает неизменяемый список запросов наблюдательных пунктов доступа, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<ModificationWatchpointRequest> modificationWatchpointRequests()

Возвращает неизменяемый список запросов наблюдательных пунктов модификации, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<MethodEntryRequest> methodEntryRequests()

Возвращает неизменяемый список запросов входа в методы, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<MethodExitRequest> methodExitRequests()

Возвращает неизменяемый список запросов выхода из методов, включённых и отключённых. Этот список — это живое представление этих запросов, и, следовательно, он меняется по мере добавления и удаления запросов.

List<MonitorContendedEnterRequest> monitorContendedEnterRequests()

Возвращает неизменяемый список включенных и выключенных запросов на вхождение в монитор. Этот список представляет текущее состояние запросов, поэтому он изменяется при добавлении и удалении запросов.

List<MonitorContendedEnteredRequest> monitorContendedEnteredRequests()

Возвращает неизменяемый список включенных и выключенных запросов на вхождение в монитор. Этот список представляет текущее состояние запросов, поэтому он изменяется при добавлении и удалении запросов.

List<MonitorWaitRequest> monitorWaitRequests()

Возвращает неизменяемый список включенных и выключенных запросов ожидания монитора. Этот список представляет текущее состояние запросов, поэтому он изменяется при добавлении и удалении запросов.

List<MonitorWaitedRequest> monitorWaitedRequests()

Возвращает неизменяемый список включенных и выключенных запросов ожидания монитора. Этот список представляет текущее состояние запросов, поэтому он изменяется при добавлении и удалении запросов.

List<VMDeathRequest> vmDeathRequests()

Возвращает неизменяемый список включенных и выключенных запросов смерти виртуальной машины. Этот список представляет текущее состояние запросов, поэтому он изменяется при добавлении и удалении запросов. Примечание: неявное событие VMDeathEvent не имеет соответствующего запроса.