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