Класс 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:

Значение-заполнитель выбрано таким образом, чтобы запросы через reflection можно было выполнять непосредственно для возвращенного значения. Его невозможно спутать с реальным параметром, поскольку 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