Интерфейс RelinkableCallSite

Методы

initialize

void initialize(MethodHandle relinkAndInvoke)

Вызывается динамическим линковщиком для инициализации переподключаемого узла вызова, задавая обработчик переподключения и вызова. Реализация узла вызова должна установить этот обработчик методов в качестве своей цели, используя CallSite.setTarget(MethodHandle). Обработчик переподключения и вызова — это начальный обработчик методов, установленный DynamicLinker.link(RelinkableCallSite), который заставит узел вызова быть переподключенным к соответствующей цели при первом вызове на основе его аргументов, а затем вызов этой связанной цели (отсюда и название). Этот протокол связывания фактически откладывает связывание до вызова узла вызова с фактическими аргументами и, таким образом, гарантирует, что линковщики могут принимать обоснованные решения о связывании на основе этих аргументов, а не только на основе статического типа метода узла вызова.

Параметры:

relinkAndInvoke — обработчик переподключения и вызова, предоставленный Dynalink.

getDescriptor

CallSiteDescriptor getDescriptor()

Возвращает дескриптор этого узла вызова.

Возвращает:

дескриптор этого узла вызова.

relink

void relink(GuardedInvocation guardedInvocation,
            MethodHandle relinkAndInvoke)

Этот метод будет вызываться динамическим линковщиком каждый раз, когда узел вызова переподключается (но см. resetAndRelink(GuardedInvocation, MethodHandle) для исключения). Ему будет передан GuardedInvocation, который узел вызова должен включить в свой целевой обработчик методов. При вызове этого метода узел вызова может сохранить другие не-отменённые вызовы для реализации полиморфных кэшей встраивания и комбинировать их с этим вызовом, чтобы сформировать свою конечную цель.

Параметры:

guardedInvocation — защищённый вызов, который узел вызова должен включить в свой целевой обработчик методов.

relinkAndInvoke — обработчик переподключения и вызова. Это обработчик методов, соответствующий типу метода узла вызова, который предоставляется DynamicLinker в качестве обратного вызова. Он должен использоваться этим узлом вызова в качестве последнего варианта, когда он не может вызвать свою цель с переданными аргументами. Обработчик-запасной вариант, когда он вызывается, попытается получить соответствующий целевой GuardedInvocation для вызова, а затем вызвать relink(GuardedInvocation, MethodHandle) или resetAndRelink(GuardedInvocation, MethodHandle), и, наконец, вызвать цель.

resetAndRelink

void resetAndRelink(GuardedInvocation guardedInvocation,
                    MethodHandle relinkAndInvoke)

Этот метод будет вызываться динамическим линковщиком каждый раз, когда узел вызова переподключается и линковщик хочет, чтобы узел вызова отказался от предыдущего состояния связывания (в этом его отличие от relink(GuardedInvocation, MethodHandle)). Ему будет передан GuardedInvocation, который узел вызова должен использовать для построения своего нового целевого обработчика методов. При вызове этого метода узел вызова не должен сохранять предыдущее состояние и должен связывать только текущий вызов.

Параметры:

guardedInvocation — защищённый вызов, который узел вызова должен использовать для построения своего целевого обработчика методов.

relinkAndInvoke — обработчик переподключения и вызова. Это обработчик методов, соответствующий типу метода узла вызова, который предоставляется DynamicLinker в качестве обратного вызова. Он должен использоваться этим узлом вызова в качестве последнего варианта, когда он не может вызвать свою цель с переданными аргументами. Обработчик-запасной вариант, когда он вызывается, попытается получить соответствующий целевой GuardedInvocation для вызова, а затем вызвать relink(GuardedInvocation, MethodHandle) или resetAndRelink(GuardedInvocation, MethodHandle), и, наконец, вызвать цель.