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)` 如果存在此注释，则返回此元素的指定类型的注释，否则为空。
`Annotation[]`	`getDeclaredAnnotations()` 返回直接在该元素上的注释。
`类<T>`	`getDeclaringClass()` 返回表示的类或接口声明可执行该对象表示的 `类`对象。
`类<?>[]`	`getExceptionTypes()` 返回 `类`对象表示异常的类型声明是由底层执行该对象表示抛出数组。
`Type[]`	`getGenericExceptionTypes()` 返回表示异常的声明是由可执行对象被 `Type`对象数组。
`Type[]`	`getGenericParameterTypes()` 返回 `Type`对象表示形式参数类型的数组，在声明顺序，该对象表示的可执行文件。
`int`	`getModifiers()` 返回该对象表示可执行的java语言 modifiers。
`String`	`getName()` 返回这个构造函数的名称，作为一个字符串。
`Annotation[][]`	`getParameterAnnotations()` 返回的 `Annotation`s表示注释形式参数数组的数组，在声明顺序，该对象表示的 `Executable`。
`int`	`getParameterCount()` 返回该对象表示的可执行文件的形式参数（无论是否显式声明或隐式声明或隐式声明的或不隐式声明的）的数量。
`类<?>[]`	`getParameterTypes()` 返回表示形式参数类型 `类`对象的数组，在声明顺序，该对象表示的可执行文件。
`TypeVariable<Constructor<T>>[]`	`getTypeParameters()` 返回 `TypeVariable`对象表示的类型变量的声明通过 `GenericDeclaration`对象表示的泛型声明一个数组，在声明顺序。
`int`	`hashCode()` 返回该 `Constructor` hashCode。
`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
    
    从以下版本开始：
    
    一点五
  - getParameterTypes
```
public 类<?>[] getParameterTypes()
```
    返回 类对象表示形式参数类型的数组，在声明顺序，该对象表示的可执行文件。如果基本的可执行文件不需要参数，则返回一个长度为0的数组。
    
    Specified by:
    
    getParameterTypes 方法重写，继承类 Executable
    
    结果
    
    此对象表示的可执行程序的参数类型
  - getParameterCount
```
public int getParameterCount()
```
    返回该对象表示的可执行文件的形式参数（无论是否显式声明或隐式声明或隐式声明的或不隐式声明的）的数量。
    
    重写：
    
    getParameterCount 方法重写，继承类 Executable
    
    结果
    
    该对象表示的可执行文件的正式参数的数目
  - getGenericParameterTypes
```
public Type[] getGenericParameterTypes()
```
    返回表示形式参数类型 Type对象的数组，在声明顺序，该对象表示的可执行文件。如果基本的可执行文件不需要参数，则返回一个长度为0的数组。
    如果形参的类型是一个参数化类型的Type对象返回，它必须准确地反映源代码中使用的实际类型参数。
    
    如果一个正式的参数类型是一个类型变量或参数化类型，则创建它。否则，它是解决。
    
    重写：
    
    getGenericParameterTypes 方法重写，继承类 Executable
    
    结果
    
    对 Types代表潜在的可执行形式参数类型的数组，在声明顺序
    
    异常
    
    GenericSignatureFormatError如果泛型方法签名不符合规定的格式，在 The Java™ Virtual Machine Specification
    
    TypeNotPresentException -如果任何的底层执行的参数类型是指一个不存在的类型声明
    
    MalformedParameterizedTypeException -如果任何相关的可执行文件的参数类型是一个参数化的类型不能被实例化的任何理由
    
    从以下版本开始：
    
    一点五
  - getExceptionTypes
```
public 类<?>[] getExceptionTypes()
```
    返回表示异常的类型声明是由底层执行该对象表示的 类抛出对象数组。返回一个数组的长度0如果可执行文件宣布在其 throws条款没有例外。
    
    Specified by:
    
    getExceptionTypes 方法重写，继承类 Executable
    
    结果
    
    声明为被可执行此对象所引发的异常类型
  - getGenericExceptionTypes
```
public Type[] getGenericExceptionTypes()
```
    返回表示异常的声明是由可执行对象被 Type对象数组。返回的数组长度为0如果底层执行宣布在其 throws条款没有例外。
    如果一个异常类型是一个类型变量或参数化类型，则创建它。否则，它是解决。
    
    重写：
    
    getGenericExceptionTypes 方法重写，继承类 Executable
    
    结果
    
    表示由底层可执行程序引发的异常类型的类型数组
    
    异常
    
    GenericSignatureFormatError如果泛型方法签名不符合规定的格式，在 The Java™ Virtual Machine Specification
    
    TypeNotPresentException如果潜在的可执行的 throws条款是指一个不存在的类型声明
    
    MalformedParameterizedTypeException如果潜在的可执行的 throws条款指的是一个参数化的类型不能被实例化的任何理由
    
    从以下版本开始：
    
    一点五
  - equals
```
public boolean equals(Object obj)
```
    比较这 Constructor与指定对象。如果对象是相同的，则返回真。如果他们是由同一个类声明具有相同的形参类型两 Constructor对象都是相同的。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -参考对象的比较。
    
    结果
    
    如果这个对象是 true obj参数相同； false否则。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回该 Constructor hashCode。hashCode是作为底层的构造函数的声明类的名字相同的hashCode。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回一个描述这个 Constructor字符串。字符串格式化为构造函数的访问修饰符，如果有的话，随后声明类的完全限定名，后面跟着一个括号，以逗号分隔的构造函数的形参类型列表。例如：
```
公共java。直到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字符串，包括类型参数
    
    从以下版本开始：
    
    一点五
    
    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如果只有这个文件被宣布为参数个数可变的。
    
    从以下版本开始：
    
    一点五
  - isSynthetic
```
public boolean isSynthetic()
```
    返回 true如果执行是一种合成的构建；否则返回 false。
    
    Specified by:
    
    isSynthetic 接口 Member
    
    重写：
    
    isSynthetic 方法重写，继承类 Executable
    
    结果
    
    真的当且仅当该可执行文件的合成结构所定义的 The Java™ Language Specification。
    
    从以下版本开始：
    
    一点五
    
    See The Java™ Language Specification:
    
    13.1二进制的形式
  - getAnnotation
```
public <T extends Annotation> T getAnnotation(类<T> annotationClass)
```
    如果存在此注释，则返回此元素的指定类型的注释，否则为空。
    
    Specified by:
    
    getAnnotation 接口 AnnotatedElement
    
    重写：
    
    getAnnotation 方法重写，继承类 Executable
    
    参数类型
    
    T -查询并返回如果目前的标注类型
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    如果此元素上存在指定的注释类型，此元素的注释将在其他元素上为空
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点五
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    返回直接在该元素上的注释。此方法忽略了继承的注释。如果在这个元素上没有直接存在的注释，返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotations 接口 AnnotatedElement
    
    重写：
    
    getDeclaredAnnotations 方法重写，继承类 Executable
    
    结果
    
    直接在这个元素上的注释
    
    从以下版本开始：
    
    一点五
  - getParameterAnnotations
```
public Annotation[][] getParameterAnnotations()
```
    返回的 Annotations表示注释形式参数数组的数组，在声明顺序，该对象表示的 Executable。合成和授权的参数（见下面的解释），如外的“这个”参数到一个内部类的构造函数将在返回的数组中表示。如果可执行文件没有参数（意思是没有正式的，没有合成的，没有规定的参数），一零个长度数组将被退回。如果 Executable具有一个或多个参数，一个嵌套的数组长度为零的返回每个参数没有注释。在返回的数组包含注释的对象序列化。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。编译器可以添加额外的参数，这些参数被隐式地声明在源（“授权”），以及参数，既不隐式也不显式地声明在源（“合成”）的方法的参数列表。更多信息见 Parameter。
    
    Specified by:
    
    getParameterAnnotations 方法重写，继承类 Executable
    
    结果
    
    表示形式和隐式参数上的注释的数组的数组，在声明顺序中，以该对象为代表的可执行文件
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    Parameter， Parameter.getAnnotations()
  - getAnnotatedReturnType
```
public AnnotatedType getAnnotatedReturnType()
```
    返回一个 AnnotatedType表示指定类型的方法或构造器的执行代表的返回类型的使用。如果这 Executable对象代表一个构造函数，该 AnnotatedType对象表示的构造的对象的类型。如果这 Executable对象表示法的 AnnotatedType对象代表一个类型指定方法的返回类型的使用。
    
    Specified by:
    
    getAnnotatedReturnType 方法重写，继承类 Executable
    
    结果
    
    表示的方法或构造函数的 Executable代表返回类型的一个对象
    
    从以下版本开始：
    
    一点八
  - getAnnotatedReceiverType
```
public AnnotatedType getAnnotatedReceiverType()
```
    返回一个 AnnotatedType表示指定类型的方法或构造器的执行对象表示的接收机类型的使用。一种方法或构造器的接收器类型是只有方法/构造函数有一个接收器参数可用（JLS 8.4.1）。如果这 Executable对象代表一个构造函数或实例方法没有接收参数，或有没有注释接收机参数的类型，则返回值是一个 AnnotatedType对象代表没有注释的元素。如果这 Executable对象代表一个静态方法，则返回值为空。
    
    重写：
    
    getAnnotatedReceiverType 方法重写，继承类 Executable
    
    结果
    
    表示的方法或构造函数的 Executable表示接收机类型对象
    
    从以下版本开始：
    
    一点八

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

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