Класс CallSiteDescriptor

java.lang.Object

jdk.dynalink.SecureLookupSupplier

jdk.dynalink.CallSiteDescriptor

public class CallSiteDescriptor extends SecureLookupSupplier

Дескрипторы точек вызова содержат всю информацию, необходимую для связывания точки вызова. Обычно эта информация передается в качестве параметров методам начальной загрузки и состоит из объекта MethodHandles.Lookup класса вызывающего кода, в котором находится точка вызова, динамической операции в точке вызова и типа метода точки вызова. Объекты CallSiteDescriptor используются в Dynalink для фиксации и сохранения этих параметров для последующего использования в DynamicLinker.

Все конструкторы встроенных реализаций RelinkableCallSite принимают дескриптор точки вызова.

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

Класс расширяет SecureLookupSupplier для инкапсуляции объекта MethodHandles.Lookup. Этот объект поиска следует использовать для поиска дескрипторов методов, назначаемых целевыми объектами точки вызова, описанной данным дескриптором.

С версии:: 9

Краткое описание полей

Поля, объявленные в классе SecureLookupSupplier

GET_LOOKUP_PERMISSION_NAME

Модификатор и тип	Поле	Описание
`static final String`	`GET_LOOKUP_PERMISSION_NAME`	Имя разрешения времени выполнения, необходимого для успешного вызова метода `SecureLookupSupplier.getLookup()`.

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

Конструктор	Описание
`CallSiteDescriptor(MethodHandles.Lookup lookup, Operation operation, MethodType methodType)`	Создает новый дескриптор точки вызова.

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

Модификатор и тип	Метод	Описание
`final CallSiteDescriptor`	`changeMethodType(MethodType newMethodType)`	Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только типом метода.
`protected CallSiteDescriptor`	`changeMethodTypeInternal(MethodType newMethodType)`	Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только типом метода.
`final CallSiteDescriptor`	`changeOperation(Operation newOperation)`	Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только операцией.
`protected CallSiteDescriptor`	`changeOperationInternal(Operation newOperation)`	Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только операцией.
`boolean`	`equals(Object obj)`	Возвращает true, если этот дескриптор точки вызова равен переданному объекту.
`final MethodType`	`getMethodType()`	Тип метода в точке вызова.
`final Operation`	`getOperation()`	Возвращает операцию в точке вызова.
`int`	`hashCode()`	Возвращает хеш-код этого дескриптора точки вызова, вычисленный на основе его операции, типа метода, класса поиска и режимов поиска объекта поиска.
`String`	`toString()`	Возвращает строковое представление этого дескриптора точки вызова в формате `name(parameterTypes)returnType@lookup`.

Методы, объявленные в классе SecureLookupSupplier

getLookup, getLookupPrivileged

Модификатор и тип	Метод	Описание
`final MethodHandles.Lookup`	`getLookup()`	Возвращает объект поиска, защищенный этим `SecureLookupSupplier`.
`protected final MethodHandles.Lookup`	`getLookupPrivileged()`	Возвращает объект поиска, защищенный этим `SecureLookupSupplier`.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

CallSiteDescriptor

public CallSiteDescriptor(MethodHandles.Lookup lookup, Operation operation, MethodType methodType)

Создает новый дескриптор точки вызова.

Параметры:: lookup — объект поиска, описывающий класс, которому принадлежит точка вызова. При создании дескрипторов из метода начальной загрузки java.lang.invoke это должен быть объект поиска, переданный методу начальной загрузки.; operation — динамическая операция в точке вызова.; methodType — тип метода точки вызова. При создании дескрипторов из метода начальной загрузки java.lang.invoke это должен быть тип метода, переданный методу начальной загрузки.

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

getOperation

public final Operation getOperation()

Возвращает операцию в точке вызова.

Возвращает:: операцию в точке вызова.

getMethodType

public final MethodType getMethodType()

Тип метода в точке вызова.

Возвращает:: тип метода в точке вызова.

changeMethodType

public final CallSiteDescriptor changeMethodType(MethodType newMethodType)

Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только типом метода. Вызывает changeMethodTypeInternal(MethodType).

Параметры:: newMethodType — новый тип метода
Возвращает:: дескриптор точки вызова с измененным типом метода.
Вызывает исключение:: NullPointerException — если newMethodType равно null.

changeMethodTypeInternal

protected CallSiteDescriptor changeMethodTypeInternal(MethodType newMethodType)

Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только типом метода. Подклассы должны переопределить этот метод, чтобы он возвращал объект своего точного класса. Если переопределенный метод изменяет в дескрипторе что-либо, кроме типа метода (его класс, объект поиска или операцию), либо возвращает null, из метода changeMethodType(MethodType) будет выброшено исключение AssertionError.

Параметры:: newMethodType — новый тип метода
Возвращает:: дескриптор точки вызова с измененным типом метода.

changeOperation

public final CallSiteDescriptor changeOperation(Operation newOperation)

Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только операцией. Вызывает changeOperationInternal(Operation).

Параметры:: newOperation — новая операция
Возвращает:: дескриптор точки вызова с измененной операцией.
Вызывает исключение:: NullPointerException — если newOperation равно null.

changeOperationInternal

protected CallSiteDescriptor changeOperationInternal(Operation newOperation)

Находит или создает дескриптор точки вызова, отличающийся от данного дескриптора только операцией. Подклассы должны переопределить этот метод, чтобы он возвращал объект своего точного класса. Если переопределенный метод изменяет в дескрипторе что-либо, кроме операции (его класс, объект поиска или тип метода), либо возвращает null, из метода changeOperation(Operation) будет выброшено исключение AssertionError.

Параметры:: newOperation — новая операция
Возвращает:: дескриптор точки вызова с измененной операцией.

equals

public boolean equals(Object obj)

Возвращает true, если этот дескриптор точки вызова равен переданному объекту. Объекты считаются равными, если другой объект принадлежит точно такому же классу, их операции и типы методов равны, а их объекты поиска имеют одинаковые MethodHandles.Lookup.lookupClass() и MethodHandles.Lookup.lookupModes().

Переопределяет:

equals в классе Object

Параметры:

obj — объект-ссылка, с которым выполняется сравнение.

Возвращает:

true, если этот объект совпадает с аргументом obj; в противном случае — false.

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этого дескриптора точки вызова, вычисленный на основе его операции, типа метода, класса поиска и режимов поиска объекта поиска.

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого дескриптора точки вызова, основанный на его значении.

См. также:

toString

public String toString()

Возвращает строковое представление этого дескриптора точки вызова в формате name(parameterTypes)returnType@lookup.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта

© 1993, 2025, 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.