Spec-Zone.ru › OpenJDK 21

Интерфейс MethodHandleDesc

Все суперинтерфейсы:
ConstantDesc
Все известные подинтерфейсы:
DirectMethodHandleDesc
public sealed interface MethodHandleDesc extends ConstantDesc permits DirectMethodHandleDesc (not exhaustive)
Номинальный дескриптор для константы MethodHandle.
С:
12

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

Модификатор и тип Метод Описание
default MethodHandleDesc asType(MethodTypeDesc type)
Возвращает MethodHandleDesc, описывающий этот обработчик метода, адаптированный к другому типу, как если бы с помощью MethodHandle.asType(MethodType).
boolean equals(Object o)
Сравнивает указанный объект с этим дескриптором на равенство.
MethodTypeDesc invocationType()
Возвращает MethodTypeDesc, описывающий тип вызова обработчика метода, описанного этим номинальным дескриптором.
static DirectMethodHandleDesc of(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String name, String lookupDescriptor)
Создаёт MethodHandleDesc, соответствующий вызову объявленного метода, вызову конструктора или доступу к полю.
static DirectMethodHandleDesc ofConstructor(ClassDesc owner, ClassDesc... paramTypes)
Возвращает MethodHandleDesc, соответствующий вызову конструктора.
static DirectMethodHandleDesc ofField(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String fieldName, ClassDesc fieldType)
Создаёт MethodHandleDesc, соответствующий обработчику метода, который обращается к полю.
static DirectMethodHandleDesc ofMethod(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String name, MethodTypeDesc lookupMethodType)
Создаёт MethodHandleDesc, соответствующий вызову объявленного метода или конструктора.
MethodHandle resolveConstantDesc(MethodHandles.Lookup lookup)
Разрешает этот дескриптор рефлексивно, эмулируя поведение разрешения JVMS 5.4.3 и поведение контроля доступа JVMS 5.4.4.

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

of

static DirectMethodHandleDesc of(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String name, String lookupDescriptor)
Создаёт MethodHandleDesc, соответствующий вызову объявленного метода, вызову конструктора или доступу к полю.

Строка описателя поиска имеет тот же формат, что и для различных вариантов CONSTANT_MethodHandle_info и для методов поиска в MethodHandles.Lookup. Для вызова метода или конструктора она интерпретируется как дескриптор типа метода; для доступа к полю — как дескриптор поля. Если kind равно CONSTRUCTOR, параметр name игнорируется, а тип возвращаемого значения в описателе поиска должен быть void. Если kind соответствует виртуальному вызову метода, тип поиска включает параметры метода, но не тип получателя.

Параметры:
kind - Тип обработаемого обработчика метода
owner - ClassDesc, описывающий класс, содержащий метод, конструктор или поле
name - Неполное имя метода или поля (игнорируется, если kind равно CONSTRUCTOR)
lookupDescriptor - Строка дескриптора метода для типа поиска, если запрос относится к вызову метода, или описывающая тип вызова, если запрос относится к полю или конструктору
Возвращает:
MethodHandleDesc
Исключения:
NullPointerException - если любой из неигнорируемых аргументов равен null
IllegalArgumentException - если строка дескриптора не является допустимым дескриптором метода или поля
См. Спецификацию виртуальной машины Java:
4.4.8 The CONSTANT_MethodHandle_info Structure
4.2.2 Unqualified Names
4.3.2 Field Descriptors
4.3.3 Method Descriptors

ofMethod

static DirectMethodHandleDesc ofMethod(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String name, MethodTypeDesc lookupMethodType)
Создаёт MethodHandleDesc, соответствующий вызову объявленного метода или конструктора.

Строка описателя поиска имеет тот же формат, что и для методов поиска в MethodHandles.Lookup. Если kind равно CONSTRUCTOR, имя игнорируется, а тип возвращаемого значения в типе поиска должен быть void. Если kind соответствует виртуальному вызову метода, тип поиска включает параметры метода, но не тип получателя.

Параметры:
kind - Тип обработаемого обработчика метода; должен быть одним из SPECIAL, VIRTUAL, STATIC, INTERFACE_SPECIAL, INTERFACE_VIRTUAL, INTERFACE_STATIC, CONSTRUCTOR
owner - ClassDesc, описывающий класс, содержащий метод или конструктор
name - Неполное имя метода (игнорируется, если kind равно CONSTRUCTOR)
lookupMethodType - MethodTypeDesc, описывающий тип поиска
Возвращает:
MethodHandleDesc
Исключения:
NullPointerException - если любые неигнорируемые аргументы равны null
IllegalArgumentException - если у name неправильный формат или тип некорректен
См. Спецификацию виртуальной машины Java:
4.2.2 Unqualified Names

ofField

static DirectMethodHandleDesc ofField(DirectMethodHandleDesc.Kind kind, ClassDesc owner, String fieldName, ClassDesc fieldType)
Создаёт MethodHandleDesc, соответствующий обработчику метода, который обращается к полю.
Параметры:
kind - тип обработчика метода; должен быть одним из GETTER, SETTER, STATIC_GETTER, или STATIC_SETTER
owner - ClassDesc, описывающий класс, содержащий поле
fieldName - Неполное имя поля
fieldType - ClassDesc, описывающий тип поля
Возвращает:
MethodHandleDesc
Исключения:
NullPointerException - если любой из аргументов равен null
IllegalArgumentException - если kind не является одним из допустимых значений или имя поля некорректно
См. Спецификацию виртуальной машины Java:
4.2.2 Unqualified Names

ofConstructor

static DirectMethodHandleDesc ofConstructor(ClassDesc owner, ClassDesc... paramTypes)
Возвращает MethodHandleDesc, соответствующий вызову конструктора
Параметры:
owner - ClassDesc, описывающий класс, содержащий конструктор
paramTypes - ClassDesc, описывающие типы параметров конструктора
Возвращает:
MethodHandleDesc
Исключения:
NullPointerException - если любой аргумент или его содержимое null

asType

default MethodHandleDesc asType(MethodTypeDesc type)
Возвращает MethodHandleDesc, описывающий этот обработчик метода, адаптированный к другому типу, как если бы это делалось с помощью MethodHandle.asType(MethodType).
Параметры:
type - MethodHandleDesc, описывающий новый тип метода
Возвращает:
MethodHandleDesc для адаптированного обработчика метода
Исключения:
NullPointerException - если аргумент null

invocationType

MethodTypeDesc invocationType()
Возвращает MethodTypeDesc, описывающий тип вызова обработчика метода, описанного этим номинальным дескриптором. Тип вызова описывает полный набор стековых значений, потребляемых при вызове (включая получателя, если таковой имеется).
Возвращает:
MethodHandleDesc, описывающий тип обработчика метода

resolveConstantDesc

MethodHandle resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException
Описание скопировано из интерфейса: ConstantDesc
Решает этот дескриптор рефлексивно, эмулируя поведение разрешения JVMS 5.4.3 и поведение контроля доступа JVMS 5.4.4. Контекст разрешения и контроля доступа предоставляется параметром MethodHandles.Lookup. Кеширование полученного значения не выполняется.
Определено в:
resolveConstantDesc в интерфейсе ConstantDesc
Параметры:
lookup - MethodHandles.Lookup для предоставления контекста разрешения имен и контроля доступа
Возвращает:
разрешённое значение константы
Исключения:
ReflectiveOperationException - если класс, метод или поле не удалось разрешить рефлексивно в процессе разрешения

equals

boolean equals(Object o)
Сравнивает указанный объект с этим дескриптором на равенство. Возвращает true тогда и только тогда, когда указанный объект также является MethodHandleDesc, и оба кодируют то же номинальное описание обработчика метода.
Переопределяет:
equals в классе Object
Параметры:
o - другой объект
Возвращает:
является ли этот дескриптор равным другому объекту
См. также:
  • Object.hashCode()
  • HashMap

© 1993, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/constant/MethodHandleDesc.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API