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