Интерфейс ObjectReference

static final int INVOKE_SINGLE_THREADED

Выполнить вызов метода только с возобновленным вызывающим потоком

static final int INVOKE_NONVIRTUAL

Выполнить вызов невиртуального метода

ReferenceType referenceType()

Получает ReferenceType, который отражает тип этого объекта. Тип может быть подклассом или реализацией объявленного типа любого поля или переменной, которая его в настоящее время содержит. Например, сразу после следующего оператора.

Object obj = new String("Hello, world!");

ReferenceType объекта obj будет отражать java.lang.String, а не java.lang.Object.

Тип объекта никогда не меняется, поэтому этот метод всегда будет возвращать тот же ReferenceType на протяжении всего жизненного цикла отраженного объекта.

Возвращаемый ReferenceType будет ClassType или ArrayType и никогда InterfaceType.

Value getValue(Field sig)

Получает значение заданного экземпляра или статического поля в этом объекте. Поле должно быть допустимым для этого ObjectReference; то есть оно должно быть из класса отражаемого объекта или его суперкласса.

Map<Field,Value> getValues(List<? extends Field> fields)

Получает значения нескольких полей экземпляра и/или статических полей в этом объекте. Поля должны быть допустимыми для этого ObjectReference; то есть они должны быть из класса отражаемого объекта или его суперкласса.

void setValue(Field field, Value value) throws InvalidTypeException, ClassNotLoadedException

Устанавливает значение заданного экземпляра или статического поля в этом объекте. Field должно быть допустимым для этого ObjectReference; то есть оно должно быть из класса отражаемого объекта или его суперкласса. Поле не должно быть final.

Значения объектов должны быть совместимы с типом поля (Это подразумевает, что тип поля должен быть загружен через загрузчик классов содержащего класса). Примитивные значения должны быть либо совместимы с типом поля, либо могут быть преобразованы в тип поля без потери информации. См. раздел 5.2 спецификации языка Java для получения дополнительной информации о совместимости присваивания.

Value invokeMethod(ThreadReference thread, Method method, List<? extends Value> arguments, int options) throws InvalidTypeException, ClassNotLoadedException, IncompatibleThreadStateException, InvocationException

Вызывает указанный Method для этого объекта в целевой виртуальной машине. Указанный метод может быть определён в классе этого объекта, в суперклассе класса этого объекта или в интерфейсе, реализованном этим объектом. Метод может быть статическим или экземпляром, но не статическим инициализатором или конструктором. Используйте ClassType.newInstance(com.sun.jdi.ThreadReference, com.sun.jdi.Method, java.util.List<? extends com.sun.jdi.Value>, int) для создания нового объекта и запуска его конструктора.

Вызов метода произойдёт в указанной нити. Вызов метода возможен только если указанная нить была приостановлена событием, произошедшим в этой нити. Вызов метода не поддерживается, когда целевая виртуальная машина приостановлена через VirtualMachine.suspend() или когда указанная нить приостановлена через ThreadReference.suspend().

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

Аргументы-объекты должны быть совместимы с типом аргумента по присваиванию (Это означает, что тип аргумента должен быть загружен через загрузчик классов содержащего класса). Примитивные аргументы должны быть либо совместимы с типом аргумента по присваиванию, либо должны быть преобразуемы в тип аргумента без потери информации. Если вызываемый метод принимает переменное количество аргументов, то последний тип аргумента – массив какого-либо компонентного типа. Аргумент в соответствующей позиции может быть опущен или равен null, быть массивом того же компонентного типа, или быть аргументом компонентного типа, за которым следует любое количество других аргументов того же типа. Если аргумент опущен, то передаётся массив длины 0 заданного компонентного типа. Компонентный тип может быть примитивным типом. Автоупаковки не поддерживаются. См. раздел 5.2 спецификации языка Java для получения более подробной информации о совместимости по присваиванию.

По умолчанию метод вызывается с использованием динамического поиска, как описано в разделе 15.12.4.4 спецификации языка Java, в частности, происходит переопределение на основе фактического типа объекта, отражённого этим ObjectReference. Это поведение может быть изменено путём указания флага INVOKE_NONVIRTUAL в options аргументе. Если этот флаг установлен, указанный метод вызывается, независимо от того, переопределён ли он для фактического типа объекта. В этом случае метод должен иметь реализацию, либо в классе, либо в интерфейсе. Этот параметр полезен для выполнения вызовов методов, аналогичных тем, которые выполняются с ключевым словом super в языке программирования Java.

По умолчанию, все нити в целевой виртуальной машине возобновляются во время вызова метода, если они ранее были приостановлены событием или через VirtualMachine.suspend() или ThreadReference.suspend(). Это делается для предотвращения тупиков, которые могут возникнуть, если какая-либо из нитей владеет ресурсами, такими как мониторы, которые потребуются вызываемому методу. Однако обратите внимание, что это неявное возобновление действует точно так же, как ThreadReference.resume(), поэтому, если счётчик приостановки нити больше 1, она останется в приостановленном состоянии во время вызова, и, следовательно, тупик всё ещё может возникнуть. По умолчанию, когда вызов завершается, все нити в целевой виртуальной машине приостанавливаются, независимо от их состояния до вызова. Во время вызова могут происходить точки останова или другие события. Это может привести к тупику, как описано выше. Также может произойти тупик, если invokeMethod вызывается из обработчика событий клиента. В этом случае эта нить будет ожидать завершения invokeMethod и не будет читать EventSet, который поступает для нового события. Если этот новый EventSet – SUSPEND_ALL, то произойдёт тупик, потому что никто не возобновит EventSet. Чтобы этого избежать, все EventRequests должны быть отключены перед вызовом invokeMethod, или invokeMethod не должен вызываться из нити обработчика событий клиента.

Возобновление других нитей во время вызова можно предотвратить, указав флаг INVOKE_SINGLE_THREADED в options аргументе; однако, нет защиты от тупиков, описанных выше, или механизма восстановления, поэтому этот параметр следует использовать с большой осторожностью. Возобновляется только указанная нить (как описано для всех нитей выше). По завершении однонитевого вызова вызывающая нить будет снова приостановлена. Обратите внимание, что любые нити, запущенные во время однонитевого вызова, не будут приостановлены при завершении вызова.

Если целевая виртуальная машина отсоединяется во время вызова (например, через VirtualMachine.dispose()), вызов метода продолжается.

void disableCollection()

Препятствует сборке мусора для этого объекта. По умолчанию все ObjectReference значения, возвращаемые JDI, могут быть собраны в любое время при работе целевой виртуальной машины. Вызов этого метода гарантирует, что объект не будет собран. enableCollection() может быть использован, чтобы разрешить сборку ещё раз.

Количество вызовов этого метода подсчитывается. Каждый вызов этого метода требует соответствующего вызова enableCollection() до того, как сборка мусора будет снова включена.

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

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

void enableCollection()

Разрешает сборку мусора для этого объекта. По умолчанию все ObjectReference значения, возвращаемые JDI, могут быть собраны в любое время при работе целевой виртуальной машины. Вызов этого метода необходим только в том случае, если сборка мусора была ранее отключена с помощью disableCollection().

boolean isCollected()

Определяет, был ли этот объект собран мусором в целевой виртуальной машине.

long uniqueID()

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

List<ThreadReference> waitingThreads() throws IncompatibleThreadStateException

Возвращает список, содержащий ThreadReference для каждого потока платформы, в настоящее время ожидающего монитор этого объекта. См. ThreadReference.currentContendedMonitor() для информации о том, когда поток считается ожидающим монитора.

Не все целевые среды исполнения поддерживают эту операцию. См. VirtualMachine.canGetMonitorInfo() для определения поддержки операции.

ThreadReference owningThread() throws IncompatibleThreadStateException

Возвращает ThreadReference для потока платформы, если таковой имеется, который в настоящее время владеет монитором этого объекта. См. ThreadReference.ownedMonitors() для определения владения.

Не все целевые среды исполнения поддерживают эту операцию. См. VirtualMachine.canGetMonitorInfo() для определения поддержки операции.

int entryCount() throws IncompatibleThreadStateException

Возвращает количество раз, когда монитор этого объекта был введён текущим владеющим потоком, если владеющий поток — поток платформы; возвращает 0, если не владеет платформенный поток. См. ThreadReference.ownedMonitors() для определения владения.

Не все целевые среды исполнения поддерживают эту операцию. См. VirtualMachine.canGetMonitorInfo() для определения поддержки операции.

List<ObjectReference> referringObjects(long maxReferrers)

Возвращает объекты, которые непосредственно ссылаются на этот объект. Возвращаются только объекты, доступные для целей сбора мусора. Обратите внимание, что на объект также можно ссылаться другими способами, например, из локальной переменной в стековом кадре или из глобальной ссылки JNI. Такие не являющиеся объектами ссылки не возвращаются этим методом.

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

boolean equals(Object obj)

Сравнивает указанный объект с этим ObjectReference на равенство.

int hashCode()

Возвращает значение хэш-кода для этого ObjectReference.