Интерфейс 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 ограничивает события шага только для вызывающих областей. Все ограничения по глубине относительны к стеку вызовов непосредственно перед выполнением шага.

В потоке разрешается только один запрос шага.

Обратите внимание, что типичный отладчик захочет отменить выполнение шага после обнаружения первого шага. Таким образом, метод next line будет выполнять следующее:

     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)

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

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

ModificationWatchpointRequest createModificationWatchpointRequest(Field field)

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

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

VMDeathRequest createVMDeathRequest()

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

Этот запрос (если он включён) вызовет VMDeathEvent при завершении работы целевой виртуальной машины.

VMDeathRequest с политикой приостановки SUSPEND_ALL можно использовать для обеспечения обработки входящих SUSPEND_NONE или SUSPEND_EVENT_THREAD событий до завершения работы виртуальной машины. Если вся обработка событий выполняется в том же потоке, что и чтение наборов событий, включение запроса — всё, что необходимо, так как виртуальная машина будет приостановлена до возобновления 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)

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

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

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

List<ModificationWatchpointRequest> modificationWatchpointRequests()

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

List<MethodEntryRequest> methodEntryRequests()

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

List<MethodExitRequest> methodExitRequests()

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

List<MonitorContendedEnterRequest> monitorContendedEnterRequests()

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

List<MonitorContendedEnteredRequest> monitorContendedEnteredRequests()

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

List<MonitorWaitRequest> monitorWaitRequests()

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

List<MonitorWaitedRequest> monitorWaitedRequests()

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

List<VMDeathRequest> vmDeathRequests()

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