Интерфейс InterfaceType

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

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

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