Интерфейс 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)

Получает значение заданного нестатического или статического поля этого объекта. Field должен быть допустим для этого 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(ThreadReference, Method, List, 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. Чтобы этого избежать, перед вызовом invokeMethod следует отключить все EventRequests либо не вызывать 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

Возвращает List, содержащий 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)

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

int hashCode()

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