Интерфейс 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()), вызов метода продолжается.