Интерфейс 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, массивом того же базового типа, или аргументом базового типа, за которым следует любое количество других аргументов того же типа. Если аргумент опущен, то передаётся массив нулевой длины базового типа. Базовый тип может быть примитивным типом. Автоупаковка не поддерживается. См. раздел 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. Чтобы этого избежать, все EventRequest должны быть отключены до выполнения 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

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

Не все целевые виртуальные машины поддерживают эту операцию. См. VirtualMachine#canGetMonitorInfo, чтобы определить, поддерживается ли операция.

List<ObjectReference> referringObjects(long maxReferrers)

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

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

boolean equals(Object obj)

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

int hashCode()

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