Интерфейс ClassType

static final int INVOKE_SINGLE_THREADED

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

ClassType superclass()

Получение суперкласса этого класса.

List<InterfaceType> interfaces()

Получение интерфейсов, непосредственно реализуемых этим классом. Включаются только интерфейсы, объявленные с ключевым словом "implements" в этом классе.

List<InterfaceType> allInterfaces()

Получение интерфейсов, непосредственно и косвенно реализуемых этим классом. Интерфейсы, возвращаемые interfaces(), возвращаются также со всеми суперинтерфейсами.

List<ClassType> subclasses()

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

boolean isEnum()

Определение, был ли этот класс объявлен как перечисление.

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

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

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

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

Вызывает указанный статический Method в целевой виртуальной машине. Указанный метод может быть определен в этом классе или в суперклассе. Метод должен быть статическим, но не статическим инициализатором. Используйте 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 для получения дополнительной информации о совместимости по присваиванию.

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

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

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

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

Создаёт новый экземпляр этого типа, используя указанный конструктор Method в целевой виртуальной машине. Указанный конструктор должен быть определён в этом классе.

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

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

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

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

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

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

Method concreteMethodByName(String name, String signature)

Возвращает единственный не абстрактный Method, видимый из этого класса, имеющий данное имя и сигнатуру. Смотрите ReferenceType.methodsByName(java.lang.String, java.lang.String) для получения информации о формате сигнатуры.

Возвращаемый метод (если не null) является компонентом ClassType.