Интерфейс InterfaceType

List<InterfaceType> superinterfaces()

List<InterfaceType> subinterfaces()

List<ClassType> implementors()

default Value invokeMethod(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, он останется в приостановленном состоянии во время вызова, и таким образом тупик всё ещё может возникнуть. По умолчанию, по завершении вызова, все потоки в целевой виртуальной машине приостанавливаются независимо от их состояния перед вызовом. Возможно, что во время вызова могут произойти точки останова или другие события. Это может привести к тупиковым ситуациям, как описано выше. Это также может привести к тупику, если invokeMethod вызывается из потока обработчика событий клиента. В этом случае этот поток будет ждать завершения invokeMethod и не будет читать EventSet, который поступает для нового события. Если этот новый EventSet — SUSPEND_ALL, то произойдет тупиковая ситуация, потому что никто не возобновит EventSet. Для предотвращения этого, все EventRequest должны быть отключены до вызова invokeMethod, или invokeMethod не должен вызываться из потока обработчика событий клиента.

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

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