Constructor (Java Platform SE 8 )

java.lang.Object
- java.lang.reflect.AccessibleObject
- - java.lang.reflect.Executable
  - - java.lang.reflect.Constructor<T>

参数类型

T - 声明构造函数的类

All Implemented Interfaces:

AnnotatedElement ， GenericDeclaration ， Member
```
public final class Constructor<T>
extends Executable
```
Constructor提供了一个类的单个构造函数的信息和访问。
Constructor允许在将实际参数与newInstance（）与底层构造函数的形式参数进行匹配时进行扩展转换，但如果发生缩小转换，则抛出IllegalArgumentException 。

另请参见：

Member ， 类 ， Class.getConstructors() ， Class.getConstructor(Class[]) ， Class.getDeclaredConstructors()

Field Summary
- Fields inherited from interface java.lang.reflect.Member
  DECLARED, PUBLIC

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` 将此 `Constructor`与指定对象进行比较。
`AnnotatedType`	`getAnnotatedReceiverType()` 返回一个 `AnnotatedType`对象，表示使用类型来指定此可执行文件对象所表示的方法/构造函数的接收器类型。
`AnnotatedType`	`getAnnotatedReturnType()` 返回一个 `AnnotatedType`对象，表示使用一个类型来指定此可执行文件所表示的方法/构造函数的返回类型。
`<T extends Annotation> T`	`getAnnotation(类<T> annotationClass)` 返回该元素的，如果这样的注释，否则返回null指定类型的注释。
`Annotation[]`	`getDeclaredAnnotations()` 返回直接存在于此元素上的注释。
`类<T>`	`getDeclaringClass()` 返回 `类`表示声明该对象表示的可执行的类或接口对象。
`类<?>[]`	`getExceptionTypes()` 返回一个 `类`对象的数组， `类`表示由该对象表示的底层可执行文件声明的异常类型。
`Type[]`	`getGenericExceptionTypes()` 返回一个 `Type`对象的数组， `Type`表示声明为该可执行对象抛出的异常。
`Type[]`	`getGenericParameterTypes()` 返回一个 `Type`对象的数组， `Type`以声明顺序表示由该对象表示的可执行文件的形式参数类型。
`int`	`getModifiers()` 返回由该对象表示的可执行文件的Java语言modifiers 。
`String`	`getName()` 以字符串形式返回此构造函数的名称。
`Annotation[][]`	`getParameterAnnotations()` 返回的数组的数组 `Annotation`表示的形参进行注释s时，声明顺序的的 `Executable`该对象表示。
`int`	`getParameterCount()` 返回由此对象表示的可执行文件的形式参数（无论是显式声明还是隐式声明）的数量。
`类<?>[]`	`getParameterTypes()` 返回一个 `类`对象的数组， `类`以声明顺序表示由该对象表示的可执行文件的形式参数类型。
`TypeVariable<Constructor<T>>[]`	`getTypeParameters()` 返回一个 `TypeVariable`对象的数组，它们以声明顺序表示由此 `GenericDeclaration`对象表示的通用声明声明的类型变量。
`int`	`hashCode()` 返回这个 `Constructor`的哈希码。
`boolean`	`isSynthetic()` 返回`true`如果这个可执行文件是一个合成的构建体; 返回`false`其他。
`boolean`	`isVarArgs()` 返回`true`如果这个可执行文件被宣布为带有可变数量的参数; 返回`false`其他。
`T`	`newInstance(Object... initargs)` 使用此 `Constructor`对象表示的构造函数，使用指定的初始化参数来创建和初始化构造函数的声明类的新实例。
`String`	`toGenericString()` 返回描述此 `Constructor`的字符串，包括类型参数。
`String`	`toString()` 返回一个描述这个 `Constructor`的字符串。

Methods inherited from class java.lang.reflect.Executable
getAnnotatedExceptionTypes, getAnnotatedParameterTypes, getAnnotationsByType, getParameters

Methods inherited from class java.lang.reflect.AccessibleObject
getAnnotations, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAccessible, isAnnotationPresent, setAccessible, setAccessible

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.reflect.AnnotatedElement
getAnnotations, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAnnotationPresent

- 方法详细信息
  - getDeclaringClass
```
public 类<T> getDeclaringClass()
```
    返回 类表示声明该对象表示的可执行的类或接口对象。
    
    Specified by:
    
    getDeclaringClass中的 Member
    
    Specified by:
    
    getDeclaringClass在 Executable
    
    结果
    
    一个表示底层成员声明类的对象
  - getName
```
public String getName()
```
    以字符串形式返回此构造函数的名称。这是构造函数的声明类的二进制名称。
    
    Specified by:
    
    getName在接口 Member
    
    Specified by:
    
    getName在 Executable
    
    结果
    
    底层成员的简单名称
  - getModifiers
```
public int getModifiers()
```
    返回由该对象表示的可执行文件的Java语言modifiers 。
    
    Specified by:
    
    getModifiers中的 Member
    
    Specified by:
    
    getModifiers在 Executable
    
    结果
    
    底层成员的Java语言修饰符
    
    另请参见：
    
    Modifier
  - getTypeParameters
```
public TypeVariable<Constructor<T>>[] getTypeParameters()
```
    返回一个TypeVariable对象的数组，它们以声明顺序表示由此GenericDeclaration对象表示的通用声明声明的类型变量。如果底层通用声明不声明类型变量，则返回长度为0的数组。
    
    Specified by:
    
    getTypeParameters在接口 GenericDeclaration
    
    Specified by:
    
    getTypeParameters在 Executable
    
    结果
    
    一个 TypeVariable对象的数组，表示此通用声明声明的类型变量
    
    异常
    
    GenericSignatureFormatError - 如果此通用声明的通用签名不符合The Java™ Virtual Machine Specification中指定的格式
    
    从以下版本开始：
    
    1.5
  - getParameterTypes
```
public 类<?>[] getParameterTypes()
```
    返回一个类对象的数组， 类以声明顺序表示由该对象表示的可执行文件的形式参数类型。如果底层可执行文件没有参数，则返回长度为0的数组。
    
    Specified by:
    
    getParameterTypes在 Executable
    
    结果
    
    该对象表示的可执行文件的参数类型
  - getParameterCount
```
public int getParameterCount()
```
    返回由此对象表示的可执行文件的形式参数（无论是显式声明还是隐式声明）的数量。
    
    重写：
    
    getParameterCount在 Executable
    
    结果
    
    该对象表示的可执行文件的形式参数的数量
  - getGenericParameterTypes
```
public Type[] getGenericParameterTypes()
```
    返回一个Type对象的数组， Type以声明顺序表示由该对象表示的可执行文件的形式参数类型。如果底层可执行文件没有参数，则返回长度为0的数组。
    如果形式参数类型是参数化类型，返回的Type对象必须准确地反映源代码中使用的实际类型参数。
    
    如果形式参数类型是类型变量或参数化类型，则会创建它。否则解决。
    
    重写：
    
    getGenericParameterTypes在 Executable
    
    结果
    
    一个 Type s的数组，以声明顺序表示底层可执行文件的形式参数类型
    
    异常
    
    GenericSignatureFormatError - 如果通用方法签名不符合The Java™ Virtual Machine Specification中指定的格式
    
    TypeNotPresentException - 如果 TypeNotPresentException任何参数类型是指不存在的类型声明
    
    MalformedParameterizedTypeException - 如果任何基础可执行文件的参数类型是指由于任何原因无法实例化的参数化类型
    
    从以下版本开始：
    
    1.5
  - getExceptionTypes
```
public 类<?>[] getExceptionTypes()
```
    返回一个类对象的数组， 类表示由该对象表示的底层可执行文件抛出的异常类型。如果可执行文件在其throws子句中不声明异常，则返回长度为0的数组。
    
    Specified by:
    
    getExceptionTypes在 Executable
    
    结果
    
    被该对象表示的可执行文件抛出的异常类型
  - getGenericExceptionTypes
```
public Type[] getGenericExceptionTypes()
```
    返回一个Type对象的数组， Type表示声明为该可执行对象抛出的异常。如果底层可执行文件在其throws子句中声明无异常，则返回长度为0的数组。
    如果异常类型是类型变量或参数化类型，则会创建它。否则解决。
    
    重写：
    
    getGenericExceptionTypes在 Executable
    
    结果
    
    一组数组，表示底层可执行文件抛出的异常类型
    
    异常
    
    GenericSignatureFormatError - 如果通用方法签名不符合The Java™ Virtual Machine Specification中指定的格式
    
    TypeNotPresentException - 如果底层可执行文件的 throws子句引用不存在的类型声明
    
    MalformedParameterizedTypeException - 如果底层可执行文件的 throws子句引用了由于任何原因无法实例化的参数化类型
    
    从以下版本开始：
    
    1.5
  - equals
```
public boolean equals(Object obj)
```
    将此Constructor与指定对象进行比较。如果对象相同，则返回true。两个Constructor对象是相同的，如果它们被同一个类声明并具有相同的形式参数类型。
    
    重写：
    
    equals在 Object类
    
    参数
    
    obj - 与之比较的参考对象。
    
    结果
    
    true如果该对象与obj参数相同; false否则。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    返回这个Constructor的哈希码。哈希码与底层构造函数的声明类名称的哈希码相同。
    
    重写：
    
    hashCode在 Object
    
    结果
    
    该对象的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回一个描述这个Constructor的字符串。该字符串格式化为构造函数访问修饰符（如果有），后跟声明类的完全限定名称，后跟括号，逗号分隔的构造函数形式参数类型列表。例如：
```
  public java.util.Hashtable(int,float) 
```
    用于构造器的唯一可能的修改器是访问修改public protected或private 。只有其中一个可能出现，或者如果构造函数具有默认（包）访问权限，则不会显示。
    重写：
    
    toString在 Object类
    
    结果
    
    一个描述这个 Constructor的字符串
    
    See The Java™ Language Specification:
    
    8.8.3。构造函数修饰符
  - toGenericString
```
public String toGenericString()
```
    返回描述此Constructor的字符串，包括类型参数。该字符串格式化为构造函数访问修饰符（如果有），后跟一个由括号括起的逗号分隔的构造函数类型参数列表（如果有），后跟声明类的完全限定名称，后跟括号，构造函数的通用形式参数类型的分隔列表。如果这个构造函数被声明为采用可变数量的参数，而不是将最后一个参数表示为“ Type[] ”，则表示为“ Type... ”。一个空格用于将访问修饰符彼此和类型参数或返回类型分开。如果没有类型参数，则类型参数列表将被删除; 如果存在类型参数列表，则会将列表与类名称隔开。如果构造函数被声明为抛出异常，则参数列表后跟一个空格，后跟“ throws ”，后面是抛出的异常类型的逗号分隔列表。
    构造函数的唯一可能的修饰符是访问修改public protected或private 。只有其中一个可能出现，或者如果构造函数具有默认（包）访问权限，则不会显示。
    
    Specified by:
    
    toGenericString在 Executable类
    
    结果
    
    一个描述这个 Constructor的字符串，包括类型参数
    
    从以下版本开始：
    
    1.5
    
    See The Java™ Language Specification:
    
    8.8.3。构造函数修饰符
  - newInstance
```
public T newInstance(Object... initargs)
              throws InstantiationException,
                     IllegalAccessException,
                     IllegalArgumentException,
                     InvocationTargetException
```
    使用由此Constructor对象表示的构造函数，使用指定的初始化参数创建和初始化构造函数的声明类的新实例。个别参数自动解包以匹配原始形式参数，原始参考参数和参考参数都需要进行方法调用转换。
    如果底层构造函数所需的形式参数的数量为0，则提供的initargs数组的长度为0或为空。
    
    如果构造函数的声明类是非静态上下文中的内部类，则构造函数的第一个参数需要是封闭实例; 见The Java™ Language Specification第15.9.3 节。
    
    如果所需的访问和参数检查成功，并且实例化将继续进行，那么构造函数的声明类如果尚未被初始化，则将被初始化。
    
    如果构造函数正常完成，则返回新创建和初始化的实例。
    
    参数
    
    initargs - 要作为构造函数调用的参数传递的对象的数组; 原始类型的值被包装在适当类型的包装器对象中（例如float中的float ）
    
    结果
    
    通过调用此对象代表的构造函数创建的新对象
    
    异常
    
    IllegalAccessException - 如果这个 Constructor对象正在执行Java语言访问控制，并且底层构造函数不可访问。
    
    IllegalArgumentException - 如果实际和形式参数的数量不同; 如果原始参数的解包转换失败; 或者如果在可能的展开之后，通过方法调用转换，参数值不能转换为相应的形式参数类型; 如果此构造函数属于枚举类型。
    
    InstantiationException - 如果声明底层构造函数的类表示抽象类。
    
    InvocationTargetException - 如果底层构造函数引发异常。
    
    ExceptionInInitializerError - 如果由此方法引发的初始化失败。
  - isVarArgs
```
public boolean isVarArgs()
```
    返回true如果这个可执行文件被宣布为带有可变数量的参数; 返回false其他。
    
    重写：
    
    isVarArgs在 Executable
    
    结果
    
    true如果只有这个可执行文件被声明为采用可变数量的参数。
    
    从以下版本开始：
    
    1.5
  - isSynthetic
```
public boolean isSynthetic()
```
    返回true如果这个可执行文件是一个合成的构建体; 返回false其他。
    
    Specified by:
    
    isSynthetic中的 Member
    
    重写：
    
    isSynthetic在 Executable
    
    结果
    
    如果且仅当此可执行文件是由The Java™ Language Specification定义的合成结构，则为true 。
    
    从以下版本开始：
    
    1.5
    
    See The Java™ Language Specification:
    
    13.1二进制形式
  - getAnnotation
```
public <T extends Annotation> T getAnnotation(类<T> annotationClass)
```
    返回该元素的，如果这样的注释，否则返回null指定类型的注释。
    
    Specified by:
    
    getAnnotation中的 AnnotatedElement
    
    重写：
    
    getAnnotation在 Executable
    
    参数类型
    
    T - 要查询的注释类型，如果存在则返回
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    该元素的注释指定的注释类型，如果存在于此元素，否则为null
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.5
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    返回直接存在于此元素上的注释。此方法忽略继承的注释。如果此元素上没有直接显示的注释，则返回值为长度为0的数组。此方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotations中的 AnnotatedElement
    
    重写：
    
    getDeclaredAnnotations在 Executable
    
    结果
    
    此元素上直接显示的注释
    
    从以下版本开始：
    
    1.5
  - getParameterAnnotations
```
public Annotation[][] getParameterAnnotations()
```
    返回一个Annotation的数组数组，表示由该对象表示的Executable的形式参数（以声明顺序）的Executable 。合成和强制参数（见下面的说明），如内部类构造函数的外部“this”参数将在返回的数组中表示。如果可执行文件没有参数（意思是没有正式的，没有合成的，没有强制的参数），那么将返回一个零长度的数组。如果Executable具有一个或多个参数，则对于没有注释的每个参数，返回长度为零的嵌套数组。包含在返回的数组中的注释对象是可序列化的。此方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。编译器可以添加在源（“强制”）中隐式声明的额外参数，以及在源（“合成”）中既不是隐式也不显式声明方法的参数列表的参数。见Parameter以获取更多信息。
    
    Specified by:
    
    getParameterAnnotations在 Executable
    
    结果
    
    表示由该对象表示的可执行文件的声明顺序的形式和隐式参数上的注释数组
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    Parameter ， Parameter.getAnnotations()
  - getAnnotatedReturnType
```
public AnnotatedType getAnnotatedReturnType()
```
    返回一个AnnotatedType对象，表示使用一个类型来指定此可执行文件所表示的方法/构造函数的返回类型。如果此Executable对象表示构造函数，则AnnotatedType对象表示AnnotatedType对象的类型。如果这个Executable对象表示一个方法，那么AnnotatedType对象表示使用一个类型来指定方法的返回类型。
    
    Specified by:
    
    getAnnotatedReturnType在 Executable类
    
    结果
    
    表示由该表示的方法或构造的返回类型的对象 Executable
    
    从以下版本开始：
    
    1.8
  - getAnnotatedReceiverType
```
public AnnotatedType getAnnotatedReceiverType()
```
    返回一个AnnotatedType对象，表示使用类型来指定此可执行文件对象所表示的方法/构造函数的接收器类型。只有方法/构造函数具有接收器参数 （JLS 8.4.1），方法/构造函数的接收器类型才可用 。如果此Executable对象表示一个没有接收器参数的构造函数或实例方法，或者具有一个接收器参数，其类型上没有注释，那么返回值是一个AnnotatedType没有注释的元素的AnnotatedType对象。如果此Executable对象表示静态方法，则返回值为null。
    
    重写：
    
    getAnnotatedReceiverType在 Executable
    
    结果
    
    表示由该 Executable表示的方法或构造函数的接收器类型的对象
    
    从以下版本开始：
    
    1.8

Class Constructor<T>

Field Summary

Fields inherited from interface java.lang.reflect.Member

方法摘要

Methods inherited from class java.lang.reflect.Executable

Methods inherited from class java.lang.reflect.AccessibleObject

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.reflect.AnnotatedElement

方法详细信息

getDeclaringClass

getName

getModifiers

getTypeParameters

getParameterTypes

getParameterCount

getGenericParameterTypes

getExceptionTypes

getGenericExceptionTypes

equals

hashCode

toString

toGenericString

newInstance

isVarArgs

isSynthetic

getAnnotation

getDeclaredAnnotations

getParameterAnnotations

getAnnotatedReturnType

getAnnotatedReceiverType