Конструктор класса<T>

public void setAccessible(boolean flag)

Устанавливает флаг accessible для этого отражённого объекта на указанное булево значение. Значение true указывает, что отражённый объект должен подавлять проверки управления доступом языка Java при его использовании. Значение false указывает, что отражённый объект должен применять проверки управления доступом языка Java при его использовании, с вариацией, отмеченной в описании класса.

Этот метод может быть использован вызывающим объектом в классе C для разрешения доступа к member объекта declaring class D в следующих случаях:

• C и D находятся в одном модуле.
• Член является public, а D находится в пакете, к которому модуль, содержащий D exports экспортирует по меньшей мере в модуль, содержащий C.
• Член является protected static, D находится в пакете, к которому модуль, содержащий D экспортирует по меньшей мере в модуль, содержащий C, и C является подклассом D.
• D находится в пакете, к которому модуль, содержащий D opens экспортирует по меньшей мере в модуль, содержащий C. Все пакеты в безымянных и открытых модулях открыты для всех модулей, поэтому этот метод всегда выполняется успешно, когда D находится в безымянном или открытом модуле.

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

Этот метод не может быть использован для разрешения записи доступа к неизменяемому конечному полю. Следующие поля неизменяемы:

• статические конечные поля, объявленные в любом классе или интерфейсе
• конечные поля, объявленные в скрытом классе
• конечные поля, объявленные в записи

Флаг accessible при true подавляет проверки управления доступом языка Java, чтобы разрешить только чтение доступа к этим неизменяемым конечным полям.

Если есть менеджер безопасности, его метод checkPermission сначала вызывается с разрешением ReflectPermission("suppressAccessChecks").

Исключение SecurityException также возникает, если этот объект является Constructor объектом для класса Class и flag равно true.

public Class<T> getDeclaringClass()

Возвращает объект Class, представляющий класс, который объявляет конструктор, представленный этим объектом.

public String getName()

Возвращает имя этого конструктора в виде строки. Это двоичное имя класса, объявляющего конструктор.

public int getModifiers()

Возвращает модификаторы языка Java для исполняемого объекта, представленного этим объектом.

public TypeVariable<Constructor<T>>[] getTypeParameters()

Возвращает массив объектов TypeVariable, представляющих тип переменных, объявленных обобщённым объявлением, представленным этим объектом GenericDeclaration , в порядке объявления. Возвращает массив длиной 0, если подлежащее обобщённое объявление не объявляет ни одной переменной типа.

public Class<?>[] getParameterTypes()

Возвращает массив объектов Class, представляющих формальные типы параметров в порядке объявления, исполняемого, представленного этим объектом. Возвращает массив длиной 0, если подлежащее исполняемое не принимает никаких параметров. Обратите внимание, что конструкторы некоторых внутренних классов могут иметь неявно объявленный параметр в дополнение к явно объявленным.

public int getParameterCount()

Возвращает количество формальных параметров (как явно, так и неявно объявленных) для исполняемого объекта, представленного этим объектом.

public Type[] getGenericParameterTypes()

Возвращает массив объектов Type, представляющих формальные типы параметров в порядке объявления, исполняемого, представленного этим объектом. Массив длиной 0 возвращается, если подлежащее исполняемое не принимает никаких параметров. Обратите внимание, что конструкторы некоторых вложенных классов могут иметь неявно объявленный параметр в дополнение к явно объявленным. Также обратите внимание, что, как артефакт моделирования модели языка, количество возвращаемых параметров может отличаться в зависимости от наличия информации о дженериках. Если информация о дженериках есть, будут возвращены только параметры, явно присутствующие в исходном коде; если информация о дженериках отсутствует, могут быть возвращены также неявные и синтетические параметры.

Если формальный тип параметра является параметризованным типом, объект Type , возвращённый для него, должен точно отражать фактические аргументы типов, используемые в исходном коде.

Если формальный тип параметра является переменной типа или параметризованным типом, он создаётся. В противном случае он разрешается.

public Class<?>[] getExceptionTypes()

Возвращает массив объектов Class, представляющих типы исключений, объявленные как выбрасываемые подлежащим исполняемым объектом, представленным этим объектом. Возвращает массив длиной 0, если исполняемый объект не объявляет исключения в его throws разделе.

public Type[] getGenericExceptionTypes()

Возвращает массив объектов Type, представляющих исключения, объявленные для выброса этим объектом исполняемого кода. Возвращает массив длиной 0, если подлежащий исполняемый код не объявляет исключений в своём throws разделе.

Если тип исключения является переменной типа или параметризованным типом, он создаётся. В противном случае он разрешается.

public boolean equals(Object obj)

Сравнивает этот Constructor с заданным объектом. Возвращает true, если объекты идентичны. Два объекта Constructor идентичны, если они были объявлены одним и тем же классом и имеют одинаковые типы формальных параметров.

public int hashCode()

Возвращает хэш-код для этого Constructor. Хэш-код совпадает с хэш-кодом имени декларирующего класса подлежащего конструктора.

public String toString()

Возвращает строку, описывающую этот Constructor. Строка форматируется как модификаторы доступа конструктора, если таковые имеются, за которыми следует полное квалифицированное имя декларирующего класса, за которым следует скобочная, разделённая запятыми последовательность типов формальных параметров конструктора. Например:

    public java.util.HashMap(int,float)
 

Если для конструктора объявлено исключение, список параметров следует за пробелом, за которым следует слово "throws", за которым следует список типов выбрасываемых исключений, разделённых запятыми.

Единственные возможные модификаторы для конструкторов — это модификаторы доступа public, protected или private. Может присутствовать только один из них, или ни одного, если конструктор имеет доступ по умолчанию (пакетный).

public String toGenericString()

Возвращает строку, описывающую этот Constructor, включая параметры типа. Строка форматируется как модификаторы доступа конструктора, если таковые имеются, за которыми следует список параметров типа в угловых скобках, разделённых запятыми, если таковые имеются, включая информативные границы параметров типа, если таковые имеются, за которыми следует полное квалифицированное имя декларирующего класса, за которым следует скобочная, разделённая запятыми последовательность обобщённых формальных параметров конструктора. Если этот конструктор объявлен для работы с переменным числом аргументов, вместо обозначения последнего параметра как "Type[]", используется "Type...". Пробел используется для разделения модификаторов доступа друг от друга и от параметров типа или имени класса. Если параметров типа нет, список параметров типа опускается; если список параметров типа присутствует, список отделяется от имени класса пробелом. Если для конструктора объявлены исключения, список параметров следует за пробелом, за которым следует слово "throws", за которым следует список типов исключений, разделённых запятыми.

Единственные возможные модификаторы для конструкторов — это модификаторы доступа public, protected или private. Может присутствовать только один из них, или ни одного, если конструктор имеет доступ по умолчанию (пакетный).

public T newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException

Использует конструктор, представленный этим объектом Constructor, для создания и инициализации нового экземпляра декларируемого классом конструктора, с указанными параметрами инициализации. Индивидуальные параметры автоматически распаковываются для соответствия примитивным формальным параметрам, и как примитивные, так и ссылочные параметры подлежат преобразованиям вызова метода, если необходимо.

Если число формальных параметров, требуемых подлежащим конструктором, равно 0, предоставленный массив initargs может иметь длину 0 или быть null.

Если декларируемый класс конструктора является внутренним классом в контексте нестатическом, первым аргументом конструктора должен быть внешний экземпляр; см. раздел 15.9.3 Спецификации языка Java.

Если необходимые проверки доступа и аргументов пройдены, а инициализация пройдёт, декларируемый класс конструктора инициализируется, если он ещё не был инициализирован.

Если конструктор завершается нормально, возвращает вновь созданный и инициализированный экземпляр.

public boolean isVarArgs()

Возвращает true , если этот исполняемый код был объявлен для работы с переменным числом аргументов; возвращает false в противном случае.

public boolean isSynthetic()

Возвращает true , если этот исполняемый код является синтетической конструкцией; возвращает false в противном случае.

public <T extends Annotation> T getAnnotation(Class<T> annotationClass)

Возвращает аннотацию этого элемента для указанного типа, если такая аннотация присутствует, в противном случае null.

Обратите внимание, что любая аннотация, возвращаемая этим методом, является аннотацией объявления.

public Annotation[] getDeclaredAnnotations()

Возвращает аннотации, которые непосредственно присутствуют на этом элементе. Этот метод игнорирует унаследованные аннотации. Если на этом элементе нет аннотаций непосредственно присутствующих, возвращаемое значение является массивом длиной 0. Вызывающий метод свободен изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другим вызывающим методам.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

public Annotation[][] getParameterAnnotations()

Возвращает массив массивов Annotations, представляющих аннотации формальных параметров, в порядке объявления, Executable , представленного этим объектом. Синтетические и предписанные параметры (см. объяснение ниже), такие как внешний параметр "this" для конструктора внутреннего класса, будут представлены в возвращаемом массиве. Если у исполняемого объекта нет параметров (т. е. нет формальных, синтетических и предписанных параметров), будет возвращен массив нулевой длины. Если у Executable есть один или несколько параметров, для каждого параметра без аннотаций возвращается вложенный массив длиной ноль. Объекты аннотаций, содержащиеся в возвращаемых массивах, сериализуемы. Вызывающий метод свободен изменять возвращаемые массивы; это не повлияет на массивы, возвращаемые другим вызывающим методам. Компилятор может добавить дополнительные параметры, которые неявно объявлены в исходном коде ("предписанные"), а также параметры, которые не являются ни неявно, ни явно объявленными в исходном коде ("синтетические"), в список параметров для метода. См. Parameter для получения дополнительной информации.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

public AnnotatedType getAnnotatedReturnType()

Возвращает объект AnnotatedType, представляющий использование типа для указания типа возвращаемого значения метода/конструктора, представленного этим объектом Executable. Если этот объект Executable представляет конструктор, объект AnnotatedType представляет тип создаваемого объекта. Если этот объект Executable представляет метод, объект AnnotatedType представляет использование типа для указания типа возвращаемого значения метода.

public AnnotatedType getAnnotatedReceiverType()

Возвращает объект AnnotatedType, представляющий использование типа для указания типа получателя метода/конструктора, представленного этим объектом Executable . Тип получателя метода/конструктора доступен только в том случае, если у метода/конструктора есть параметр получателя (JLS 8.4.1). Если этот объект Executable представляет метод экземпляра или представляет конструктор внутреннего класса-члена, и метод/конструктор либо не имеет параметра получателя, либо имеет параметр получателя без аннотаций на его типе, то возвращаемое значение является объектом AnnotatedType , представляющим элемент без аннотаций. Если этот объект Executable представляет статический метод или представляет конструктор верхнего уровня, статического члена, локального или анонимного класса, то возвращаемое значение равно null.