Класс DynamicLinker

public final class DynamicLinker extends Object

Обработчик для объектов RelinkableCallSite. Динамический обработчик — это главный объект при использовании Dynalink, он координирует привязку вызовов к обработчикам доступных языковых сред выполнения, которые представлены объектами GuardingDynamicLinker (вы имеете с ними дело только в том случае, если сами реализуете языковую среду выполнения с собственной моделью объектов и/или преобразованиями типов). Для использования Dynalink необходимо создать один или несколько динамических обработчиков с помощью DynamicLinkerFactory. После этого необходимо вызвать его метод link(RelinkableCallSite) из invokedynamic методов инициализации, чтобы он управлял всеми создаваемыми вызовами. Обычное использование заключается в создании по крайней мере одного класса на каждую языковую среду выполнения, содержащего один экземпляр обработчика, как:

 class MyLanguageRuntime {
     private static final GuardingDynamicLinker myLanguageLinker = new MyLanguageLinker();
     private static final DynamicLinker dynamicLinker = createDynamicLinker();

     private static DynamicLinker createDynamicLinker() {
         final DynamicLinkerFactory factory = new DynamicLinkerFactory();
         factory.setPrioritizedLinker(myLanguageLinker);
         return factory.createLinker();
     }

     public static CallSite bootstrap(MethodHandles.Lookup lookup, String name, MethodType type) {
         return dynamicLinker.link(
             new SimpleRelinkableCallSite(
                 new CallSiteDescriptor(lookup, parseOperation(name), type)));
     }

     private static Operation parseOperation(String name) {
         ...
     }
 }
 

Указанная выше настройка с одним статическим экземпляром обработчика часто слишком проста. Часто в языковой среде выполнения присутствует понятие «загрузчик контекстных классов», и вы захотите создать один динамический обработчик на каждый такой загрузчик классов, чтобы убедиться, что он включает обработчики всех других языковых сред выполнения, видимых этому загрузчику классов (см. DynamicLinkerFactory.setClassLoader(ClassLoader)).

В приведенном выше примере необходимо предоставить три компонента:

• Ожидается, что вы предоставите GuardingDynamicLinker для вашего языка. Если ваша среда выполнения не имеет собственной модели объектов или преобразований типов, вам не нужно реализовывать GuardingDynamicLinker; вы просто не вызываете метод setPrioritizedLinker в фабрике.
• Производительность программ может зависеть от вашего выбора класса для представления вызовов. В приведенном выше примере использовался SimpleRelinkableCallSite, но вы можете использовать ChainedCallSite вместо него. Вам необходимо провести эксперименты и решить, что лучше всего подходит для вашей среды выполнения. Вы можете дополнительно наследоваться от одного из этих классов или реализовать свой собственный.
• Вам также необходимо предоставить CallSiteDescriptor для ваших вызовов. Это неизменяемые объекты, содержащие всю информацию о вызове: класс, выполняющий поиск, вызываемая операция и сигнатура метода. Вам придется разработать собственную схему для кодирования и декодирования операций в имени вызова или статических параметрах, поэтому в приведенном выше примере метод parseOperation оставлен нереализованным.