java.lang.reflect
클래스 Constructor<T>

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

모든 구현된 인터페이스:

AnnotatedElement, GenericDeclaration, Member

public final class Constructor<T>
extends AccessibleObject 
implements GenericDeclaration,
 Member 

Constructor는 클래스의 단일 생성자에 대한 정보와 그 액세스를 제공합니다.

Constructor는 기본으로 되는 생성자 가파라미터와 newInstance()에의 열매 파라미터를 일치시키는 경우에 확장 변환이 발생하는 것을 허용합니다만, 축소 변환이 발생하는 경우는 IllegalArgumentException을 Throw 합니다.

관련 항목:

Member, Class, Class.getConstructors(), Class.getConstructor(Class[]), Class.getDeclaredConstructors()

필드 개요

인터페이스 java.lang.reflect. Member 로부터 상속된 필드

DECLARED, PUBLIC

메서드 개요

boolean	equals (Object obj) Constructor가 지정된 객체와 비교합니다.
<T extends Annotation > T	getAnnotation (Class <T> annotationClass) 지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다.
Annotation []	getDeclaredAnnotations () 이 요소에 직접 존재하는 모든 주석을 리턴합니다.
Class <T >	getDeclaringClass () Constructor 객체에 의해 나타내지는 생성자를 선언하는 클래스를 나타내는 Class 객체를 리턴합니다.
Class <? >[]	getExceptionTypes () 이 Constructor 객체로 나타내지는 기본으로 되는 생성자에 의해 Throw 되도록 선언되고 있는 예외의 형태를 나타내는 Class 객체의 배열을 리턴합니다.
Type []	getGenericExceptionTypes () 이 Constructor 객체에 의해 발생되는 것이 선언되고 있는 예외를 나타내는 Type 객체의 배열을 리턴합니다.
Type []	getGenericParameterTypes () Constructor 객체에 의해 나타내지는 메서드의 가파라미터형을 선언순서로 나타내는 Type 객체의 배열을 리턴합니다.
int	getModifiers () Constructor 객체에 의해 나타내지는 생성자 Java 언어 수식자를 정수로서 리턴합니다.
String	getName () 이 생성자 이름을 캐릭터 라인으로서 리턴합니다.
Annotation [][]	getParameterAnnotations () 이 Method 객체에 의해 나타내진 메서드의 가파라미터의 주석을 나타내는 배열의 배열을 선언순서에 리턴합니다.
Class <? >[]	getParameterTypes () Constructor 객체에 의해 나타내지는 생성자 가파라미터형을 선언순서로 나타내는 Class 객체의 배열을 리턴합니다.
TypeVariable <Constructor <T >>[]	getTypeParameters () GenericDeclaration 객체에 의해 나타내지는 범용적인 선언으로 선언된 형태 변수를 나타내는 TypeVariable 객체의 배열을 선언순서에 리턴합니다.
int	hashCode () Constructor 해시 코드를 리턴합니다.
boolean	isSynthetic () 이 생성자가 합성 생성자 인 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isVarArgs () 이 생성자가 가변수의 인수를 취하도록 선언되고 있었을 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
T	newInstance (Object ... initargs) 지정된 초기화 파라미터로 이 생성자 선언 클래스의 새로운 인스턴스를 작성 및 초기화하는 경우는 이 Constructor 객체에 의해 나타내지는 생성자를 사용합니다.
String	toGenericString () 형태 파라미터를 포함한, 이 Constructor를 기술하는 캐릭터 라인을 리턴합니다.
String	toString () Constructor를 기술하는 캐릭터 라인을 리턴합니다.

클래스 java.lang.reflect. AccessibleObject 로부터 상속된 메서드

getAnnotations, isAccessible, isAnnotationPresent, setAccessible, setAccessible

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

메서드의 상세

getDeclaringClass

public Class <T > getDeclaringClass()

Constructor 객체에 의해 나타내지는 생성자를 선언하는 클래스를 나타내는 Class 객체를 리턴합니다.

정의:

인터페이스 Member 내의 getDeclaringClass

반환값:

기본이 되는 멤버의 선언 클래스를 나타내는 객체

getName

public String  getName()

이 생성자 이름을 캐릭터 라인으로서 리턴합니다. 이것은 항상, 생성자를 선언한 클래스의 단순명과 같습니다.

정의:

인터페이스 Member 내의 getName

반환값:

기본이 되는 멤버의 단순명

getModifiers

public int getModifiers()

Constructor 객체에 의해 나타내지는 생성자 Java 언어 수식자를 정수로서 리턴합니다. 수식자를 복호화 하는 경우에 Modifier 클래스를 사용할 필요가 있습니다.

정의:

인터페이스 Member 내의 getModifiers

반환값:

기본이 되는 멤버의 Java 언어 수식자

관련 항목:

Modifier

getTypeParameters

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

GenericDeclaration 객체에 의해 나타내지는 범용적인 선언으로 선언된 형태 변수를 나타내는 TypeVariable 객체의 배열을 선언순서에 리턴합니다. 기본으로 되는 범용적인 선언으로 형태 변수가 선언되어 있지 않은 경우는 길이 0 배열이 리턴됩니다 .

정의:

인터페이스 GenericDeclaration 내의 getTypeParameters

반환값:

이 범용적인 선언으로 선언된 형태 변수를 나타내는 TypeVariable 객체의 배열

예외:

GenericSignatureFormatError - 이 범용적인 선언의 범용적인 서명이 「Java 가상 머신 사양 제 3 판」으로 규정되는 서식에 적합하지 않는 경우

도입된 버전 :

1.5

getParameterTypes

public Class <? >[] getParameterTypes()

Constructor 객체에 의해 나타내지는 생성자 가파라미터형을 선언순서로 나타내는 Class 객체의 배열을 리턴합니다. 기본으로 되는 생성자에 파라미터가 설정되어 있지 않은 경우에는 길이 0 배열이 리턴됩니다 .

반환값:

이 객체가 나타내는 생성자 파라미터형

getGenericParameterTypes

public Type [] getGenericParameterTypes()

Constructor 객체에 의해 나타내지는 메서드의 가파라미터형을 선언순서로 나타내는 Type 객체의 배열을 리턴합니다. 기본으로 되는 메서드에 파라미터가 설정되어 있지 않은 경우에는 길이 0 배열이 리턴됩니다 .

가파라미터형이, 파라미터화 된 형태의 경우, 리턴된 Type 객체는 원시 코드로 사용되는 실제의 형태 파라미터를 정확하게 반영하지 않으면 안됩니다.

가파라미터형이, 형태 변수 또는 파라미터화 된 형태의 경우, 가파라미터형은 작성됩니다. 그렇지 않은 경우, 가파라미터형은 해결됩니다.

반환값:

기본이 되는 메서드의 가파라미터형을 나타낸다, 선언순서의 Type 배열

예외:

GenericSignatureFormatError - 이 범용적인 메서드의 서명이 「Java 가상 머신 사양 제 3 판」으로 규정되는 서식에 적합하지 않는 경우

TypeNotPresentException - 기본이 되는 메서드의 파라미터형의 어떤 것인가가 존재하지 않는 형태 선언을 참조하는 경우

MalformedParameterizedTypeException - 기본이 되는 메서드의 파라미터형의 어떤 것인가가 어떠한 이유에 의해 인스턴스화할 수 없는 파라미터화 된 형태를 참조하는 경우

도입된 버전 :

1.5

getExceptionTypes

public Class <? >[] getExceptionTypes()

이 Constructor 객체로 나타내지는 기본으로 되는 생성자에 의해 Throw 되도록 선언되고 있는 예외의 형태를 나타내는 Class 객체의 배열을 리턴합니다. 생성자가 throws 절로 예외를 선언하고 있지 않은 경우는 길이 0 배열을 리턴합니다.

반환값:

선언되는 예외 타입. 이 객체가 나타내는 생성자에 의해 Throw 된다

getGenericExceptionTypes

public Type [] getGenericExceptionTypes()

이 Constructor 객체에 의해 발생되는 것이 선언되고 있는 예외를 나타내는 Type 객체의 배열을 리턴합니다. 기본이 되는 메서드가 throws 절로 예외를 선언하고 있지 않은 경우는 길이 0 배열을 리턴합니다.

예외 타입이, 파라미터화 된 형태의 경우, 리턴된 Type 객체는 원시 코드로 사용되는 실제의 형태 파라미터를 정확하게 반영하지 않으면 안됩니다.

예외 타입이, 형태 변수 또는 파라미터화 된 형태의 경우, 예외 타입은 작성됩니다. 그렇지 않은 경우, 예외 타입은 해결됩니다.

반환값:

기본이 되는 메서드에 의해 Throw 된 예외 타입을 나타내는 Type 배열

예외:

GenericSignatureFormatError - 이 범용적인 메서드의 서명이 「Java 가상 머신 사양 제 3 판」으로 규정되는 서식에 적합하지 않는 경우

TypeNotPresentException - 기본이 되는 메서드의 throws 절이 존재하지 않는 형태 선언을 참조하는 경우

MalformedParameterizedTypeException - 기본이 되는 메서드의 throws 절이, 어떠한 이유에 의해 인스턴스화할 수 없는 파라미터화 된 형태를 참조하는 경우

도입된 버전 :

1.5

equals

public boolean equals(Object  obj)

Constructor가 지정된 객체와 비교합니다. 객체가 같은 경우에는 true를 리턴합니다. 2개의 Constructor객체는 같은 클래스에서 선언되어 같은 가파라미터형이 설정되어 있는 경우에는 같습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 참조 객체

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

Constructor 해시 코드를 리턴합니다. 이 해시 코드는 클래스명을 선언하는 기본으로 되는 생성자 해시 코드와 같습니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

toString

public String  toString()

Constructor를 기술하는 캐릭터 라인을 리턴합니다. 이 캐릭터 라인의 서식은 (존재하는 경우에는) 생성자 액세스 수식자, 정의 클래스의 완전 수식명, 괄호로 둘러싸인 콤마 단락의 생성자 가파라미터형의 리스트가 차례로 계속됩니다. 이하에 예를 나타냅니다.

    public java.util.Hashtable(int, float)
 

생성자 으로 지정할 수 있는 수식자는 액세스 수식자의 public, protected 또는 private 뿐입니다. 지정할 수 있는 수식자는 1개 뿐입니다. 디폴트 (package) 액세스를 가지는 생성자에서는 1개 또는 지정하지 않습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

toGenericString

public String  toGenericString()

형태 파라미터를 포함한, 이 Constructor를 기술하는 캐릭터 라인을 리턴합니다. 이 캐릭터 라인의 서식은 (존재하는 경우에는) 생성자 액세스 수식자, 산괄호로 둘러싸인 콤마 단락의 생성자 형태 파라미터 리스트, 선언 클래스의 완전 수식명, 괄호로 둘러싸인 콤마 단락의 생성자 범용가파라미터형의 리스트가 차례로 계속됩니다. 액세스 수식자끼리 및 액세스 수식자와 형태 파라미터나 반환값과의 단락에는 공백 문자가 사용됩니다. 형태 파라미터가 없는 경우, 형태 파라미터의 리스트는 생략 됩니다. 형태 파라미터의 리스트가 존재하는 경우, 리스트와 클래스명은 공백 문자로 단락지어집니다. 생성자가 예외를 Throw 하도록 선언되고 있는 경우, 파라미터의 리스트의 후에 공백, 「throws」라고 하는 캐릭터 라인, 콤마 단락의 발생되는 예외형이 차례로 계속됩니다.

생성자 으로 지정할 수 있는 수식자는 액세스 수식자의 public, protected 또는 private 뿐입니다. 지정할 수 있는 수식자는 1개 뿐입니다. 디폴트 (package) 액세스를 가지는 생성자에서는 1개 또는 지정하지 않습니다.

반환값:

형 파라미터를 포함한, 이 Constructor를 기술하는 캐릭터 라인

도입된 버전 :

1.5

newInstance

public T  newInstance(Object ... initargs)
              throws InstantiationException,

                     IllegalAccessException,

                     IllegalArgumentException,

                     InvocationTargetException 

지정된 초기화 파라미터로 이 생성자 선언 클래스의 새로운 인스턴스를 작성 및 초기화하는 경우는 이 Constructor 객체에 의해 나타내지는 생성자를 사용합니다. 개개의 파라미터는 원시적인 가파라미터와 일치시키기 위해서 자동적으로 랩 해제되어 원시적 파라미터와 참조 파라미터는 양쪽 모두 필요에 따라서 메서드 호출 변환의 대상이 됩니다.

기본이 되는 생성자에 의해 요구되는 가파라미터수가 0인 경우, 지정된 initargs 배열은 길이 0 또는 null이 됩니다.

요구된 액세스 및 인수 체크가 성공해, 인스턴스화를 실행하는 경우, 생성자 선언 클래스가 초기화되어 있지 않으면, 초기화를 합니다.

생성자가 정상적으로 완료하면, 새롭게 작성 및 초기화된 인스턴스가 리턴됩니다 .

파라미터:

initargs - 생성자 호출에 인수로서 건네주는 객체의 배열. 원시형의 값은 적절한 형태의 래퍼 객체내에 랩 된다 (예, Float 내의 float)

반환값:

이 객체가 나타내는 생성자를 호출하는 것으로 작성되는 새로운 객체

예외:

IllegalAccessException - 이 Constructor 객체가 Java 언어 액세스 제어를 실시해, 기본이 되는 생성자에 액세스 할 수 없는 경우

IllegalArgumentException - 열매 파라미터수와 가파라미터수가 다른 경우, 원시적 인수의 랩 해제 변환이 실패했을 경우, 또는 랩 해제 후, 메서드 호출 변환에 의해 파라미터값를 대응하는 가파라미터형으로 변환할 수 없는 경우, 이 생성자가 열거형에 관련하고 있는 경우

InstantiationException - 기본이 되는 생성자를 선언하는 클래스가 abstract 클래스를 나타내는 경우

InvocationTargetException - 기본이 되는 생성자가 예외를 Throw 하는 경우

ExceptionInInitializerError - 이 메서드에 한 초기화가 실패했을 경우

isVarArgs

public boolean isVarArgs()

이 생성자가 가변수의 인수를 취하도록 선언되고 있었을 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

반환값:

이 생성자가 가변수의 인수를 취하도록 선언되고 있었을 경우는 true

도입된 버전 :

1.5

isSynthetic

public boolean isSynthetic()

이 생성자가 합성 생성자 인 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

정의:

인터페이스 Member 내의 isSynthetic

반환값:

이 생성자가 「Java 언어 사양」으로 정의되고 있는 합성 생성자 인 경우에 한정해, true

도입된 버전 :

1.5

getAnnotation

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

인터페이스 AnnotatedElement 기술:

지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다. 그렇지 않은 경우는 null을 리턴합니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotation

오버라이드(override):

클래스 AccessibleObject 내의 getAnnotation

파라미터:

annotationClass - 어노테이션에 대응하는 Class 객체

반환값:

존재하는 경우는 지정된 어노테이션의 요소의 주석. 그렇지 않은 경우는 null

getDeclaredAnnotations

public Annotation [] getDeclaredAnnotations()

인터페이스 AnnotatedElement 기술:

이 요소에 직접 존재하는 모든 주석을 리턴합니다. 이 인터페이스에 있는 다른 메서드와는 달라, 이 메서드는 상속된 주석을 무시합니다 (이 요소에 주석이 직접 존재하지 않는 경우는 길이 제로의 배열을 돌려준다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getDeclaredAnnotations

오버라이드(override):

클래스 AccessibleObject 내의 getDeclaredAnnotations

반환값:

이 요소에 직접 존재하는 모든 주석

getParameterAnnotations

public Annotation [][] getParameterAnnotations()

이 Method 객체에 의해 나타내진 메서드의 가파라미터의 주석을 나타내는 배열의 배열을 선언순서에 리턴합니다. 기본이 되는 메서드가 파라미터를 포함하지 않는 경우는 길이 제로의 배열을 리턴합니다. 메서드에 1개 이상의 파라미터가 있는 경우, 주석을 포함하지 않는 파라미터 마다 길이 제로의 상자의 배열을 리턴합니다. 리턴된 배열에 포함되는 주석 객체는 직렬화할 수 있습니다. 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출해 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

반환값:

이 Method 객체에 의해 나타내진 메서드의 가파라미터의 주석을 나타내는 선언순서의 배열의 배열

도입된 버전 :

1.5