Класс 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 оставлен нереализованным.