Интерфейс GuardingDynamicLinker

Все известные подинтерфейсы:: TypeBasedGuardingDynamicLinker

Все известные реализующие классы:: BeansLinker, CompositeGuardingDynamicLinker, CompositeTypeBasedGuardingDynamicLinker

public interface GuardingDynamicLinker

Базовый интерфейс для динамических линковщиков, специфичных для языка. Такие линковщики всегда должны создавать обработчики методов с защитой, так как валидность обработчика метода для вызовов в месте вызова неизбежно зависит от некоторого условия (по крайней мере, от принадлежности получателя к среде выполнения языка линковщика). Реализаторы среды выполнения языка обычно реализуют логику линковки для своего языка как один или несколько GuardingDynamicLinker классов. Обычно они устанавливают их как prioritized linkers в DynamicLinkerFactory , которое они настраивают для себя, и, возможно, также некоторые из них устанавливают как

fallback
 linkers

для обработки условий, специфичных для языка, таких как "свойство не найдено" и т.п.

Рассмотрите возможность реализации интерфейса TypeBasedGuardingDynamicLinker вместо этого интерфейса для линковщиков, основанных на классе Java объектов. Если вам необходимо реализовать преобразования типов, специфичные для языка, пусть ваш GuardingDynamicLinker также реализует интерфейс GuardingTypeConverterFactory.

Языки могут экспортировать линковщики в другие среды выполнения языков для automatic discovery с помощью GuardingDynamicLinkerExporter.

Краткое описание методов

Модификатор и тип	Метод	Описание
`GuardedInvocation`	`getGuardedInvocation(LinkRequest linkRequest, LinkerServices linkerServices)`	Создает защищенный вызов, подходящий для конкретного вызова со специфицированными аргументами в месте вызова.

Подробное описание методов

getGuardedInvocation

GuardedInvocation getGuardedInvocation(LinkRequest linkRequest, LinkerServices linkerServices) throws Exception

Создает защищенный вызов, подходящий для конкретного вызова со специфицированными аргументами в месте вызова.

Параметры:: linkRequest - объект, описывающий запрос на линковку конкретного вызова; linkerServices - сервисы линковщика
Возвращает:: защищенный вызов с обработчиком метода, подходящим для аргументов, а также условием защиты, которое, если не выполняется, должно инициировать повторную линковку. Должен вернуть null, если не может разрешить вызов. Если возвращаемый вызов безусловен (что на самом деле довольно редко), защита в возвращаемом значении может быть null. Вызов также может иметь любое количество точек переключения для асинхронной инвалидации линковки, а также подкласс Throwable, который описывает ожидаемое условие исключения, которое также запускает повторную линковку (часто быстрее полагаться на редкое, но ожидаемое ClassCastException, чем на всегда оцениваемую instanceof защиту). Хотя линковщик должен создать вызов с типами параметров, соответствующими описанию места вызова запроса на линковку, он не должен пытаться сопоставить ожидаемый тип возвращаемого значения в месте вызова, за исключением случаев, когда это можно сделать только с преобразованиями, которые не теряют ни точности, ни величины, см. LinkerServices.asTypeLosslessReturn(MethodHandle, MethodType) для получения более подробной информации.
Исключение:: Exception - если операция завершается неудачно по любой причине

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.dynalink/jdk/dynalink/linker/GuardingDynamicLinker.html