Интерфейс LinkerServices

MethodHandle asType(MethodHandle handle, MethodType fromType)

Аналогично MethodHandle.asType(MethodType), за исключением того, что она также подключает обработчики методов, созданные всеми доступными GuardingTypeConverterFactory реализациями, обеспечивая языкоспецифическое приведение типов параметров. Она будет применять MethodHandle.asType(MethodType) для всех преобразований примитивный-примитивный, обёртка-примитивный, примитивный-обёртка, а также для всех расширений типов. Для всех остальных преобразований она вставит MethodHandles.filterArguments(MethodHandle, int, MethodHandle...) с составными фильтрами, предоставленными реализациями GuardingTypeConverterFactory.

default MethodHandle asTypeLosslessReturn(MethodHandle handle, MethodType fromType)

Аналогично asType(MethodHandle, MethodType), за исключением того, что она обрабатывает преобразование типа возвращаемого значения особо. Она преобразует тип возвращаемого значения обработчика метода только тогда, когда это можно сделать с помощью преобразования, не теряющего ни точности, ни величины; в противном случае она оставляет его неизменным. Это единственные преобразования возвращаемого значения, которые должны выполняться отдельными языкоспецифическими линкерами, и pre-link transformer of the dynamic linker должен реализовать стратегию для обработки потенциально потери точности преобразований возвращаемого типа специфичным для языковой среды способом, где находится место вызова.

MethodHandle getTypeConverter(Class<?> sourceType, Class<?> targetType)

Учитывая исходный и целевой тип, возвращает обработчик метода, который преобразует между ними. Никогда не возвращает null; в худшем случае он вернёт тождественное преобразование (которое может потерпеть неудачу для некоторых значений во время выполнения). Вам редко нужно использовать этот метод напрямую, и вы должны в основном полагаться на asType(MethodHandle, MethodType) вместо этого. Этот метод необходим, когда вам нужно повторно использовать существующую механику преобразования типов вне контекста обработки запроса на ссылку.

boolean canConvert(Class<?> from, Class<?> to)

Возвращает true, если может существовать преобразование между запрошенными типами (либо автоматическое преобразование JVM, либо одно, предоставленное любым доступным GuardingTypeConverterFactory), или false, если определённо не существует преобразования между запрошенными типами. Обратите внимание, что возвращение true не гарантирует, что преобразование будет успешным во время выполнения для всех значений (особенно если типы "от" или "до" достаточно обобщены), но возвращение false гарантирует, что оно потерпит неудачу.

GuardedInvocation getGuardedInvocation(LinkRequest linkRequest) throws Exception

Создаёт защищённый вызов, делегирующий обратно DynamicLinker, который предоставляет этот объект службы линковщика. Динамический линковщик затем сам делегирует связывание всем своим управляемым GuardingDynamicLinker, включая потенциально этот, если ни один линковщик не отреагирует раньше, так что будьте осторожны с бесконечной рекурсией. Обычно вы создаёте запрос на ссылку таким образом, чтобы он отличался от запроса, который вы сейчас пытаетесь связать.

ConversionComparator.Comparison compareConversion(Class<?> sourceType, Class<?> targetType1, Class<?> targetType2)

Определяет, какое из двух преобразований типа от исходного типа к двум целевым типам предпочтительнее. Это используется для динамического разрешения перегруженных методов. Если исходный тип преобразуется точно в один целевой тип с помощью преобразования вызова метода, он выбирается; в противном случае используются доступные ConversionComparator.

MethodHandle filterInternalObjects(MethodHandle target)

Изменяет обработчик метода так, чтобы любые параметры, которые могут получать потенциально внутренние объекты среды выполнения языка, имели фильтр, добавленный к ним, чтобы предотвратить их утечку, возможно, посредством обёртки. Он также может потенциально добавить фильтр разворачивания к возвращаемому значению. В основном преобразует обработчик метода, используя преобразователь, настроенный с помощью DynamicLinkerFactory.setInternalObjectsFilter(MethodHandleTransformer).

<T> T getWithLookup(Supplier<T> operation, SecureLookupSupplier lookupSupplier)

Выполняет операцию в контексте конкретного объекта поиска MethodHandles.Lookup. Обычно методы на LinkerServices вызываются в рамках механизма связывания, в котором Dynalink внутренне поддерживает текущий поиск по потоку (принадлежащий описателю места вызова, который связывается). Этот поиск может быть получен любым GuardingTypeConverterFactory, участвующим в связывании, если ему нужно сгенерировать чувствительные к поиску преобразователи. Однако методы служб линковщика могут вызываться и вне процесса связывания, когда реализуются схемы распределения вызовов во время вызова, вызываются преобразования во время выполнения и т. д. Если возникает необходимость в использовании любого преобразователя типа в этой ситуации, и он нуждается в поиске, обычно он получит только MethodHandles.publicLookup(), так как поток не участвует в операции связывания. Если существует способ осмысленно связать операцию с контекстом какого-либо класса вызывающего абонента, рассмотрите выполнение её внутри вызова этого метода и передачу полноценного поиска для этого класса, так как это свяжет этот поиск с текущим потоком на время выполнения операции. Поскольку вы передаёте SecureLookupSupplier, любые вызываемые фабрики преобразователей типов всё равно должны иметь необходимые разрешения на выполнение для получения поиска, если им это понадобится.