JavaTM 2
Platform
Std.  Ed.  v1. 4.0

java.lang.reflect
클래스 Constructor

java.lang.Object 
  |
  +--java.lang.reflect.AccessibleObject 
        |
        +--java.lang.reflect.Constructor
모든 구현 인터페이스:
Member

public final class Constructor
extends AccessibleObject
implements Member

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

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

관련 항목:
Member , Class , Class.getConstructors() , Class.getConstructor(Class[]) , Class.getDeclaredConstructors()

필드의 개요
 
인터페이스 java.lang.reflect. Member 에서 상속받은 필드
DECLARED , PUBLIC
 
메소드의 개요
 boolean equals (Object  obj)
          Constructor 가 지정된 오브젝트와 비교합니다.
 Class getDeclaringClass ()
          Constructor 에 의해 나타내지는 constructor를 선언하는 클래스를 나타내는 Class 오브젝트를 돌려줍니다.
 Class [] getExceptionTypes ()
          이 Constructor 오브젝트로 나타내지는 기본으로 되는 constructor 에 의해 슬로우 되도록(듯이) 선언되고 있는 예외의 형태를 나타내는 Class 오브젝트의 배열을 돌려줍니다.
 int getModifiers ()
          Constructor 오브젝트에 의해 나타내지는 constructor 의 Java 언어 수식자를 정수로서 돌려줍니다.
 String getName ()
          Constructor 의 명칭을 캐릭터 라인으로서 돌려줍니다.
 Class [] getParameterTypes ()
          Constructor 오브젝트에 의해 나타내지는 constructor 의 가파라미터형을 선언순서로 나타내는 Class 오브젝트의 배열을 돌려줍니다.
 int hashCode ()
          Constructor 의 해시 코드를 돌려줍니다.
 Object newInstance (Object [] initargs)
          지정된 초기화 파라미터로, 이 constructor 의 선언 클래스의 새로운 인스턴스를 생성 및 초기화하는 경우는 이 Constructor 오브젝트에 의해 나타내지는 constructor를 사용합니다.
 String toString ()
          Constructor 를 기술하는 캐릭터 라인을 돌려줍니다.
 
클래스 java.lang.reflect. AccessibleObject 에서 상속받은 메소드
isAccessible , setAccessible , setAccessible
 
클래스 java.lang. Object 에서 상속받은 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

메소드의 상세

getDeclaringClass

public Class  getDeclaringClass()
Constructor 에 의해 나타내지는 constructor를 선언하는 클래스를 나타내는 Class 오브젝트를 돌려줍니다.

정의:
인터페이스 Member 내의 getDeclaringClass
반환값:
기본이 되는 멤버의 선언 클래스를 나타내는 오브젝트

getName

public String  getName()
Constructor 의 명칭을 캐릭터 라인으로서 돌려줍니다. 이것은 항상, constructor를 선언한 클래스의 단순명과 같습니다.

정의:
인터페이스 Member 내의 getName
반환값:
기본이 되는 멤버의 단순명

getModifiers

public int getModifiers()
Constructor 오브젝트에 의해 나타내지는 constructor 의 Java 언어 수식자를 정수로서 돌려줍니다. 수식자를 복호화(decode) 하는 경우에,Modifier 클래스를 사용할 필요가 있습니다.

정의:
인터페이스 Member 내의 getModifiers
반환값:
기본이 되는 멤버의 Java 언어 수식자
관련 항목:
Modifier

getParameterTypes

public Class [] getParameterTypes()
Constructor 오브젝트에 의해 나타내지는 constructor 의 가파라미터형을 선언순서로 나타내는 Class 오브젝트의 배열을 돌려줍니다. 기본으로 되는 constructor 에 파라미터가 설정되어 있지 않은 경우에는 길이 0 의 배열이 돌려주어집니다.

반환값:
이 오브젝트가 나타내는 constructor 의 파라미터형

getExceptionTypes

public Class [] getExceptionTypes()
Constructor 오브젝트로 나타내지는 기본으로 되는 constructor 에 의해 슬로우 되도록(듯이) 선언되고 있는 예외의 형태를 나타내는 Class 오브젝트의 배열을 돌려줍니다. constructor 이 throws 절로 예외를 선언하고 있지 않은 경우는 길이 0 의 배열을 돌려줍니다.

반환값:
선언되는 예외 타입. 이 오브젝트가 나타내는 constructor 에 의해 슬로우 된다

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 의 해시 코드를 돌려줍니다. 이 해시 코드는 클래스명을 선언하는 기본으로 되는 constructor 의 해시 코드와 같습니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 오브젝트의 해시 코드치
관련 항목:
Object.equals(java.lang.Object) , Hashtable

toString

public String  toString()
Constructor 를 기술하는 캐릭터 라인을 돌려줍니다. 이 캐릭터 라인의 서식은 존재하는 경우에는 constructor 의 액세스 수식자, 정의 클래스의 풀네임, 괄호로 둘러싸인 콤마 단락의 constructor 의 가파라미터형의 리스트가 차례로 계속됩니다. 이하에 예를 나타냅니다.
    public java.util.Hashtable(int, float)
 

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

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 오브젝트의 캐릭터 라인 표현

newInstance

public Object  newInstance(Object [] initargs)
                   throws InstantiationException ,
                          IllegalAccessException ,
                          IllegalArgumentException ,
                          InvocationTargetException 
지정된 초기화 파라미터로, 이 constructor 의 선언 클래스의 새로운 인스턴스를 생성 및 초기화하는 경우는 이 Constructor 오브젝트에 의해 나타내지는 constructor를 사용합니다. 개개의 파라미터는 원시적인 가파라미터와 일치시키기 위해서(때문에) 자동적으로 랩 해제되어 원시적 파라미터와 참조 파라미터는 양쪽 모두 필요에 따라서 메소드 호출 변환의 대상이 됩니다.

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

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

constructor 이 정상적으로 완료하면(자), 새롭게 생성 및 초기화된 인스턴스가 돌려주어집니다.

파라미터:
initargs - constructor 호출에 인수로서 건네주는 오브젝트의 배열. 원시적형의 값은 적절한 형태의 래퍼 오브젝트내에 랩 된다 (예,Float 내의 float)
반환값:
이 오브젝트가 나타내는 constructor를 호출하는 것으로 작성되는 신규 오브젝트
예외:
IllegalAccessException - 이 Constructor 오브젝트가 언어 액세스 제어를 실시해, 기본이 되는 constructor 에 액세스 할 수 없는 경우
IllegalArgumentException - 열매 파라미터수와 가파라미터수가 다른 경우, 원시적 인수의 랩 해제 변환이 실패했을 경우, 또는 랩 해제 후, 메소드 호출 변환에 의해 파라미터치를 대응하는 가파라미터형으로 변환할 수 없는 경우
InstantiationException - 기본이 되는 constructor를 선언하는 클래스가 abstract 클래스를 나타내는 경우
InvocationTargetException - 기본이 되는 constructor 이 예외를 슬로우 하는 경우
ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.