Класс MethodType

public static MethodType methodType(Class<?> rtype, Class<?>[] ptypes)

Параметры:

rtype — тип возвращаемого значения

ptypes — типы параметров

Возвращает:

тип метода с заданными компонентами

Вызывает исключение:

NullPointerException — если rtype или ptypes либо любой элемент ptypes равен null

IllegalArgumentException — если любой элемент ptypes является void.class

public static MethodType methodType(Class<?> rtype, List<Class<?>> ptypes)

Параметры:

rtype — тип возвращаемого значения

ptypes — типы параметров

Возвращает:

тип метода с заданными компонентами

Вызывает исключение:

NullPointerException — если rtype или ptypes либо любой элемент ptypes равен null

IllegalArgumentException — если любой элемент ptypes является void.class

public static MethodType methodType(Class<?> rtype, Class<?> ptype0, Class<?>... ptypes)

Параметры:

rtype — тип возвращаемого значения

ptype0 — тип первого параметра

ptypes — типы остальных параметров

Возвращает:

тип метода с заданными компонентами

Вызывает исключение:

NullPointerException — если rtype или ptype0 или ptypes либо любой элемент ptypes равен null

IllegalArgumentException — если ptype0 или ptypes либо любой элемент ptypes является void.class

public static MethodType methodType(Class<?> rtype)

Параметры:

rtype — тип возвращаемого значения

Возвращает:

тип метода с заданным возвращаемым значением

Вызывает исключение:

NullPointerException — если rtype равен null

public static MethodType methodType(Class<?> rtype, Class<?> ptype0)

Параметры:

rtype — тип возвращаемого значения

ptype0 — тип параметра

Возвращает:

тип метода с заданными возвращаемым значением и типом параметра

Вызывает исключение:

NullPointerException — если rtype или ptype0 равен null

IllegalArgumentException — если ptype0 является void.class

public static MethodType methodType(Class<?> rtype, MethodType ptypes)

Параметры:

rtype — тип возвращаемого значения

ptypes — тип метода, предоставляющий типы параметров

Возвращает:

тип метода с заданными компонентами

Вызывает исключение:

NullPointerException — если rtype или ptypes равен null

public static MethodType genericMethodType(int objectArgCount, boolean finalArray)

Параметры:

objectArgCount — количество параметров (без учета последнего параметра-массива, если он есть)

finalArray — наличие завершающего параметра-массива типа Object[]

Возвращает:

универсально применимый тип метода для всех вызовов с указанным фиксированным количеством аргументов и собранным массивом дополнительных аргументов

Вызывает исключение:

IllegalArgumentException — если objectArgCount отрицательно или больше 255 (или 254, если finalArray равно true)

См. также:

• genericMethodType(int)

public static MethodType genericMethodType(int objectArgCount)

Параметры:

objectArgCount — количество параметров

Возвращает:

универсально применимый тип метода для всех вызовов с указанным количеством аргументов

Вызывает исключение:

IllegalArgumentException — если objectArgCount отрицательно или больше 255

См. также:

• genericMethodType(int, boolean)

public MethodType changeParameterType(int num, Class<?> nptype)

Определено в:

changeParameterType в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Параметры:

num — индекс (начиная с нуля) изменяемого типа параметра

nptype — новый тип параметра, заменяющий прежний

Возвращает:

тот же тип, но с измененным выбранным параметром

Вызывает исключение:

IndexOutOfBoundsException — если num не является допустимым индексом в parameterArray()

IllegalArgumentException — если nptype является void.class

NullPointerException — если nptype равен null

public MethodType insertParameterTypes(int num, Class<?>... ptypesToInsert)

Определено в:

insertParameterTypes в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Параметры:

num — позиция (начиная с нуля), в которую вставляются типы параметров

ptypesToInsert — ноль или более новых типов параметров для вставки в список параметров

Возвращает:

тот же тип, но с вставленными выбранными параметрами

Вызывает исключение:

IndexOutOfBoundsException — если num отрицательно или больше parameterCount()

IllegalArgumentException — если любой элемент ptypesToInsert является void.class или если в результирующем типе метода будет более 255 слотов параметров

NullPointerException — если ptypesToInsert или любой его элемент равен null

public MethodType appendParameterTypes(Class<?>... ptypesToInsert)

Параметры:

ptypesToInsert — ноль или более новых типов параметров для добавления в конец списка параметров

Возвращает:

тот же тип, но с добавленными выбранными параметрами

Вызывает исключение:

IllegalArgumentException — если любой элемент ptypesToInsert является void.class или если в результирующем типе метода будет более 255 слотов параметров

NullPointerException — если ptypesToInsert или любой его элемент равен null

public MethodType insertParameterTypes(int num, List<Class<?>> ptypesToInsert)

Параметры:

num — позиция (начиная с нуля), в которую вставляются типы параметров

ptypesToInsert — ноль или более новых типов параметров для вставки в список параметров

Возвращает:

тот же тип, но с вставленными выбранными параметрами

Вызывает исключение:

IndexOutOfBoundsException — если num отрицательно или больше parameterCount()

IllegalArgumentException — если любой элемент ptypesToInsert является void.class или если в результирующем типе метода будет более 255 слотов параметров

NullPointerException — если ptypesToInsert или любой его элемент равен null

public MethodType appendParameterTypes(List<Class<?>> ptypesToInsert)

Параметры:

ptypesToInsert — ноль или более новых типов параметров для добавления в конец списка параметров

Возвращает:

тот же тип, но с добавленными выбранными параметрами

Вызывает исключение:

IllegalArgumentException — если любой элемент ptypesToInsert является void.class или если в результирующем типе метода будет более 255 слотов параметров

NullPointerException — если ptypesToInsert или любой его элемент равен null

public MethodType dropParameterTypes(int start, int end)

Определено в:

dropParameterTypes в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Параметры:

start — индекс (начиная с нуля) первого удаляемого типа параметра

end — индекс (больше start) первого типа параметра, следующего за диапазоном удаляемых

Возвращает:

тот же тип, но с удаленными выбранными параметрами

Вызывает исключение:

IndexOutOfBoundsException — если start отрицательно или больше parameterCount(), либо если end отрицательно или больше parameterCount(), либо если start больше end

public MethodType changeReturnType(Class<?> nrtype)

Определено в:

changeReturnType в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Параметры:

nrtype — тип возвращаемого значения, заменяющий прежний

Возвращает:

тот же тип, но с измененным типом возвращаемого значения

Вызывает исключение:

NullPointerException — если nrtype равен null

public boolean hasPrimitives()

Возвращает:

true, если любой из типов является примитивным

public boolean hasWrappers()

Возвращает:

true, если любой из типов является типом-оберткой

public MethodType erase()

Возвращает:

версию исходного типа, в которой заменены все ссылочные типы

public MethodType generic()

Возвращает:

версию исходного типа, в которой заменены все типы

public MethodType wrap()

Возвращает:

версию исходного типа, в которой заменены все примитивные типы

public MethodType unwrap()

Возвращает:

версию исходного типа, в которой заменены все типы-обертки

public Class<?> parameterType(int num)

Определено в:

parameterType в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Параметры:

num — индекс (начиная с нуля) требуемого типа параметра

Возвращает:

выбранный тип параметра

Вызывает исключение:

IndexOutOfBoundsException — если num не является допустимым индексом в parameterArray()

public int parameterCount()

Определено в:

parameterCount в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Возвращает:

количество типов параметров

public Class<?> returnType()

Определено в:

returnType в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Возвращает:

тип возвращаемого значения

public List<Class<?>> parameterList()

Определено в:

parameterList в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Возвращает:

типы параметров (в виде неизменяемого списка)

public Class<?> lastParameterType()

Примечание к API:

Значение-заполнитель выбрано таким образом, чтобы можно было непосредственно выполнять рефлексивные запросы к результату. Значение-заполнитель невозможно спутать с реальным параметром, поскольку void никогда не может быть допустимым типом параметра. Для режимов вызова с переменной арностью выражение lastParameterType().getComponentType() удобно использовать для получения типа параметра «varargs».

Возвращает:

тип последнего параметра, если он есть, иначе void.class

Начиная с версии:

10

public Class<?>[] parameterArray()

Определено в:

parameterArray в интерфейсе TypeDescriptor.OfMethod<Class<?>, MethodType>

Возвращает:

типы параметров (при необходимости — свежую копию)

public boolean equals(Object x)

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

equals в классе Object

Параметры:

x — объект для сравнения

Возвращает:

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

См. также:

• Object.equals(Object)

public int hashCode()

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

hashCode в классе Object

Возвращает:

значение хеш-кода для этого типа метода

См. также:

• Object.hashCode()
• equals(Object)
• List.hashCode()

public String toString()

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

toString в классе Object

Возвращает:

строковое представление объекта

public static MethodType fromMethodDescriptorString(String descriptor, ClassLoader loader) throws IllegalArgumentException, TypeNotPresentException

Примечание к API:

Можно встретить типы методов с допустимыми дескрипторами, которые невозможно создать с помощью этого метода, поскольку их типы компонентов не видны из общего загрузчика классов.

Этот метод включен для приложений, которым необходимо генерировать байт-код для обработки дескрипторов методов и invokedynamic.

Параметры:

descriptor — строка дескриптора метода

loader — загрузчик классов, в котором следует искать типы

Возвращает:

тип метода, соответствующий заданному дескриптору метода

Вызывает исключение:

NullPointerException — если строка равна null

IllegalArgumentException — если строка не является дескриптором метода

TypeNotPresentException — если указанный тип не найден

См. Спецификацию виртуальной машины Java:

4.3.3 Дескрипторы методов

public String toMethodDescriptorString()

Примечание к API:

Этот метод не является строгой обратной операцией для fromMethodDescriptorString, которому требуются дескриптор типа метода (JVMS 4.3.3) и подходящий аргумент загрузчика классов. Два разных объекта MethodType могут иметь одинаковую строку дескриптора, поскольку разные классы могут иметь одинаковые имена, но разные загрузчики классов.

Этот метод включен для приложений, которым необходимо генерировать байт-код для обработки дескрипторов методов и invokedynamic.

Возвращает:

строку дескриптора для этого типа метода

См. Спецификацию виртуальной машины Java:

4.3.3 Дескрипторы методов

См. также:

• Номинальный дескриптор для MethodType

public String descriptorString()

Определено в:

descriptorString в интерфейсе TypeDescriptor

Возвращает:

строку дескриптора для этого типа метода

См. Спецификацию виртуальной машины Java:

4.3.3 Дескрипторы методов

Начиная с версии:

12

См. также:

• Номинальный дескриптор для MethodType

public Optional<MethodTypeDesc> describeConstable()

Определено в:

describeConstable в интерфейсе Constable

Возвращает:

Optional, содержащий полученный номинальный дескриптор, или пустой Optional, если создать его невозможно.

Начиная с версии:

12

См. также:

• Номинальный дескриптор для MethodType