Constructor (Java Platform SE 8)

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

型パラメータ:

T - コンストラクタが宣言されているクラス

すべての実装されたインタフェース:

AnnotatedElement, GenericDeclaration, Member
```
public final class Constructor<T>
extends Executable
```
Constructorは、クラスの単一コンストラクタについての情報と単一コンストラクタへのアクセスを提供します。
Constructorは、基になるコンストラクタの仮パラメータと、newInstance()への実パラメータを一致させる場合に、拡張変換が発生することを許可しますが、縮小変換が発生する場合はIllegalArgumentExceptionをスローします。

関連項目:

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

フィールドのサマリー
- インタフェース java.lang.reflect.Memberから継承されたフィールド
  DECLARED, PUBLIC

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`boolean`	`equals(Object obj)`	この`Constructor`を指定されたオブジェクトと比較します。
`AnnotatedType`	`getAnnotatedReceiverType()`	このExecutableオブジェクトによって表されるメソッドまたはコンストラクタのレシーバの型を指定する型の使用を表す`AnnotatedType`オブジェクトを返します。
`AnnotatedType`	`getAnnotatedReturnType()`	このExecutableによって表されるメソッドまたはコンストラクタの戻り型を指定する型の使用を表す`AnnotatedType`オブジェクトを返します。
`<T extends Annotation> T`	`getAnnotation(Class<T> annotationClass)`	存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
`Annotation[]`	`getDeclaredAnnotations()`	この要素に直接存在する注釈を返します。
`Class<T>`	`getDeclaringClass()`	このオブジェクトによって表される実行可能ファイルを宣言するクラスまたはインタフェースを表す`Class`オブジェクトを返します。
`Class<?>[]`	`getExceptionTypes()`	このオブジェクトで表される基礎となる実行可能ファイルによってスローされるように宣言されている例外の型を表す`Class`オブジェクトの配列を返します。
`Type[]`	`getGenericExceptionTypes()`	このexecutableオブジェクトによってスローされることが宣言されている例外を表す`Type`オブジェクトの配列を返します。
`Type[]`	`getGenericParameterTypes()`	このオブジェクトによって表される実行可能要素の仮パラメータ型を宣言順で表す`Type`オブジェクトの配列を返します。
`int`	`getModifiers()`	このオブジェクトによって表される実行可能要素のJava言語修飾子を返します。
`String`	`getName()`	このコンストラクタの名前を文字列として返します。
`Annotation[][]`	`getParameterAnnotations()`	このオブジェクトによって表される`Executable`の仮パラメータの注釈を表す`Annotation`の配列の配列を、宣言順に返します。
`int`	`getParameterCount()`	このオブジェクトによって表される実行可能要素の仮パラメータ(明示的に宣言されているか、暗黙的に宣言されているか、そのいずれでもないかに関係なく)の数を返します。
`Class<?>[]`	`getParameterTypes()`	このオブジェクトによって表される実行可能ファイルの仮パラメータ型を宣言順で表す`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.Executableから継承されたメソッド
getAnnotatedExceptionTypes, getAnnotatedParameterTypes, getAnnotationsByType, getParameters

クラス java.lang.reflect.AccessibleObjectから継承されるメソッド
getAnnotations, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAccessible, isAnnotationPresent, setAccessible, setAccessible

クラス java.lang.Objectから継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェースjava.lang.reflect.AnnotatedElementから継承されたメソッド
getAnnotations, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAnnotationPresent

- メソッドの詳細
  - getDeclaringClass
```
public Class<T> getDeclaringClass()
```
    このオブジェクトによって表される実行可能ファイルを宣言するクラスまたはインタフェースを表すClassオブジェクトを返します。
    
    定義:
    
    getDeclaringClass、インタフェースMember
    
    定義:
    
    getDeclaringClass、クラスExecutable
    
    戻り値:
    
    基本となるメンバーの宣言クラスを表すオブジェクト
  - getName
```
public String getName()
```
    このコンストラクタの名前を文字列として返します。これは、コンストラクタを宣言したクラスのバイナリ名です。
    
    定義:
    
    getName、インタフェースMember
    
    定義:
    
    getName、クラスExecutable
    
    戻り値:
    
    基本となるメンバーの単純名
  - getModifiers
```
public int getModifiers()
```
    このオブジェクトによって表される実行可能要素のJava言語修飾子を返します。
    
    定義:
    
    getModifiers、インタフェースMember
    
    定義:
    
    getModifiers、クラスExecutable
    
    戻り値:
    
    基本となるメンバーのJava言語修飾子
    
    関連項目:
    
    Modifier
  - getTypeParameters
```
public TypeVariable<Constructor<T>>[] getTypeParameters()
```
    GenericDeclarationオブジェクトによって表されるジェネリック宣言で宣言された型変数を表すTypeVariableオブジェクトの配列を宣言順に返します。基になるジェネリック宣言で型変数が宣言されていない場合は、長さ0の配列が返されます。
    
    定義:
    
    getTypeParameters、インタフェースGenericDeclaration
    
    定義:
    
    getTypeParameters、クラスExecutable
    
    戻り値:
    
    このジェネリック宣言で宣言された型変数を表すTypeVariableオブジェクトの配列
    
    例外:
    
    GenericSignatureFormatError - このジェネリック宣言のジェネリック・シグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合
    
    導入されたバージョン:
    
    1.5
  - getParameterTypes
```
public Class<?>[] getParameterTypes()
```
    このオブジェクトによって表される実行可能ファイルの仮パラメータ型を宣言順で表すClassオブジェクトの配列を返します。基礎となる実行可能要素にパラメータが設定されていない場合には、長さ0の配列が返されます。
    
    定義:
    
    getParameterTypes、クラスExecutable
    
    戻り値:
    
    このオブジェクトが表す実行可能要素のパラメータ型
  - getParameterCount
```
public int getParameterCount()
```
    このオブジェクトによって表される実行可能要素の仮パラメータ(明示的に宣言されているか、暗黙的に宣言されているか、そのいずれでもないかに関係なく)の数を返します。
    
    オーバーライド:
    
    getParameterCount、クラスExecutable
    
    戻り値:
    
    このオブジェクトが表す実行可能要素の仮パラメータの数
    
    導入されたバージョン:
    
    1.8
  - getGenericParameterTypes
```
public Type[] getGenericParameterTypes()
```
    このオブジェクトによって表される実行可能要素の仮パラメータ型を宣言順で表すTypeオブジェクトの配列を返します。基礎となる実行可能要素にパラメータが設定されていない場合には、長さ0の配列が返されます。
    仮パラメータ型が、パラメータ化された型の場合、返されるTypeオブジェクトは、ソース・コードで使用される実際の型パラメータを正確に反映しなければいけません。
    仮パラメータ型が、型変数またはパラメータ化された型の場合、仮パラメータ型は作成されます。そうでない場合、例外タイプは解決されます。
    
    オーバーライド:
    
    getGenericParameterTypes、クラスExecutable
    
    戻り値:
    
    基礎となる実行可能要素の仮パラメータ型を表す、宣言順のTypeの配列
    
    例外:
    
    GenericSignatureFormatError - ジェネリック・メソッドのシグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合
    
    TypeNotPresentException - 基礎となる実行可能要素のパラメータ型のいずれかが、存在しない型宣言を参照する場合
    
    MalformedParameterizedTypeException - 基礎となる実行可能要素のパラメータ型のいずれかが、なんらかの理由によりインスタンス化できないパラメータ化された型を参照する場合
    
    導入されたバージョン:
    
    1.5
  - getExceptionTypes
```
public Class<?>[] getExceptionTypes()
```
    このオブジェクトで表される基礎となる実行可能ファイルによってスローされるように宣言されている例外の型を表すClassオブジェクトの配列を返します。実行可能要素がthrows節で例外を宣言していない場合は、長さ0の配列を返します。
    
    定義:
    
    getExceptionTypes、クラスExecutable
    
    戻り値:
    
    宣言される例外タイプ。このオブジェクトが表す実行可能要素によりスローされる
  - getGenericExceptionTypes
```
public Type[] getGenericExceptionTypes()
```
    このexecutableオブジェクトによってスローされることが宣言されている例外を表すTypeオブジェクトの配列を返します。基礎となる実行可能要素がthrows節で例外を宣言していない場合は、長さ0の配列を返します。
    例外タイプが、型変数またはパラメータ化された型の場合、例外タイプは作成されます。そうでない場合、例外タイプは解決されます。
    
    オーバーライド:
    
    getGenericExceptionTypes、クラスExecutable
    
    戻り値:
    
    基礎となる実行可能要素によりスローされた例外タイプを表すTypeの配列
    
    例外:
    
    GenericSignatureFormatError - ジェネリック・メソッドのシグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合
    
    TypeNotPresentException - 基礎となる実行可能要素のthrows節が存在しない型宣言を参照する場合
    
    MalformedParameterizedTypeException - 基礎となる実行可能要素のthrows節が、なんらかの理由によりインスタンス化できないパラメータ化された型を参照する場合
    
    導入されたバージョン:
    
    1.5
  - equals
```
public boolean equals(Object obj)
```
    このConstructorを指定されたオブジェクトと比較します。オブジェクトが同じ場合にはtrueを返します。 2つのConstructorオブジェクトは、同じクラスで宣言され、同じ仮パラメータ型が設定されている場合には同じです。
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    obj - 比較対象の参照オブジェクト。
    
    戻り値:
    
    このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合は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だけです。指定できる修飾子は1つだけです。デフォルト(package)アクセスを持つコンストラクタでは、1つも指定しません。
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    このConstructorを記述する文字列
    
    『Java™言語仕様』を参照してください。
    
    8.8.3. コンストラクタ修飾子
  - toGenericString
```
public String toGenericString()
```
    型パラメータを含む、このConstructorを記述する文字列を返します。この文字列の書式は、(存在する場合には)コンストラクタのアクセス修飾子、山カッコで囲まれたカンマ区切りのコンストラクタの型パラメータ・リスト、宣言クラスの完全指定名、カッコで囲まれたカンマ区切りのコンストラクタのジェネリック仮パラメータ型のリストが順番に続きます。このコンストラクタが可変数の引数を取るように宣言されていた場合は、最後のパラメータが"Type[]"として示されるのではなく、"Type..."として示されます。アクセス修飾子同士、およびアクセス修飾子と型パラメータや戻り値との区切りには空白文字が使用されます。型パラメータがない場合、型パラメータのリストは省略されます。型パラメータのリストが存在する場合、リストとクラス名は空白文字で区切られます。コンストラクタが例外をスローするように宣言されている場合、パラメータのリストのあとに空白、「throws」という文字列、カンマ区切りのスローされる例外型が順番に続きます。
    コンストラクタに指定できる修飾子は、アクセス修飾子のpublic、protectedまたはprivateだけです。指定できる修飾子は1つだけです。デフォルト(package)アクセスを持つコンストラクタでは、1つも指定しません。
    
    定義:
    
    toGenericString、クラスExecutable
    
    戻り値:
    
    型パラメータを含む、このConstructorを記述する文字列
    
    導入されたバージョン:
    
    1.5
    
    『Java™言語仕様』を参照してください。
    
    8.8.3. コンストラクタ修飾子
  - newInstance
```
public T newInstance(Object... initargs)
              throws InstantiationException,
                     IllegalAccessException,
                     IllegalArgumentException,
                     InvocationTargetException
```
    指定された初期化パラメータで、このコンストラクタの宣言クラスの新しいインスタンスを作成および初期化する場合は、このConstructorオブジェクトによって表されるコンストラクタを使用します。個別のパラメータは、プリミティブ仮パラメータと一致させるために自動的にラップ解除され、プリミティブおよび参照パラメータは両方とも必要に応じてメソッド呼出し変換の対象になります。
    基本となるコンストラクタによって要求される仮パラメータ数が0の場合、指定されたinitargs配列は長さ0またはnullになります。
    コンストラクタの宣言クラスが非staticコンテキスト内の内部クラスである場合、コンストラクタへの最初の引数は囲むインスタンスである必要があります。『Java™言語仕様』のセクション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を返します。
    
    定義:
    
    isSynthetic、インタフェースMember
    
    オーバーライド:
    
    isSynthetic、クラスExecutable
    
    戻り値:
    
    この実行可能要素が、『Java™言語仕様』で定義されている合成構造である場合に限り、true。
    
    導入されたバージョン:
    
    1.5
    
    『Java™言語仕様』を参照してください。
    
    13.1 バイナリの形式
  - getAnnotation
```
public <T extends Annotation> T getAnnotation(Class<T> annotationClass)
```
    存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
    
    定義:
    
    getAnnotation、インタフェースAnnotatedElement
    
    オーバーライド:
    
    getAnnotation、クラスExecutable
    
    型パラメータ:
    
    T - 照会し、存在する場合に返す注釈の型。
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.5
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    この要素に直接存在する注釈を返します。このメソッドは継承された注釈を無視します。この要素に直接存在する注釈がない場合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
    
    定義:
    
    getDeclaredAnnotations、インタフェースAnnotatedElement
    
    オーバーライド:
    
    getDeclaredAnnotations、クラスExecutable
    
    戻り値:
    
    この要素に直接存在する注釈
    
    導入されたバージョン:
    
    1.5
  - getParameterAnnotations
```
public Annotation[][] getParameterAnnotations()
```
    このオブジェクトによって表されるExecutableの仮パラメータの注釈を表すAnnotationの配列の配列を、宣言順に返します。返される配列では、内部クラス・コンストラクタに対する外部のthisパラメータなど、合成および必須パラメータ(次の説明を参照)が表されます。実行可能要素がパラメータを持たない(つまり、仮パラメータも合成パラメータも必須パラメータも持たない)場合は、長さ0の配列が返されます。 実行可能要素に1つ以上のパラメータがある場合、注釈を含まないパラメータごとに長さゼロの入れ子の配列を返します。返された配列に含まれる注釈オブジェクトは直列化できます。このメソッドの呼出し元は、返された配列を自由に変更できます。この変更は、ほかの呼出し元に返された配列に影響を及ぼしません。コンパイラによって、ソースで暗黙的に宣言されている追加のパラメータ("必須")、およびソースで暗黙的にも明示的にも宣言されていないパラメータ("合成")がメソッドのパラメータ・リストに追加されることがあります。詳細は、Parameterを参照してください。
    
    定義:
    
    getParameterAnnotations、クラスExecutable
    
    戻り値:
    
    このオブジェクトにより表された実行可能要素の仮パラメータおよび暗黙的なパラメータの注釈を表す宣言順の配列の配列
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    Parameter, Parameter.getAnnotations()
  - getAnnotatedReturnType
```
public AnnotatedType getAnnotatedReturnType()
```
    このExecutableによって表されるメソッドまたはコンストラクタの戻り型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。このExecutableオブジェクトがコンストラクタを表す場合、AnnotatedTypeオブジェクトは構築されるオブジェクトの型を表します。このExecutableオブジェクトがメソッドを表す場合、AnnotatedTypeオブジェクトはメソッドの戻り型を指定する型の使用を表します。
    
    定義:
    
    getAnnotatedReturnType、クラスExecutable
    
    戻り値:
    
    このExecutableが表すメソッドまたはコンストラクタの戻り型を表すオブジェクト
    
    導入されたバージョン:
    
    1.8
  - getAnnotatedReceiverType
```
public AnnotatedType getAnnotatedReceiverType()
```
    このExecutableオブジェクトによって表されるメソッドまたはコンストラクタのレシーバの型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。メソッドまたはコンストラクタのレシーバの型は、メソッドまたはコンストラクタがレシーバ・パラメータ(JLS 8.4.1)を持つ場合にのみ使用できます。このExecutableオブジェクトが、レシーバ・パラメータを持たない、または型に注釈が付けられていないレシーバ・パラメータを持つコンストラクタまたはインスタンス・メソッドを表す場合、戻り値は注釈が付けられていない要素を表すAnnotatedTypeオブジェクトです。このExecutableオブジェクトがstaticメソッドを表す場合、戻り値はnullです。
    
    オーバーライド:
    
    getAnnotatedReceiverType、クラスExecutable
    
    戻り値:
    
    このExecutableが表すメソッドまたはコンストラクタのレシーバの型を表すオブジェクト
    
    導入されたバージョン:
    
    1.8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスConstructor<T>

フィールドのサマリー

インタフェース java.lang.reflect.Memberから継承されたフィールド

メソッドのサマリー

クラスjava.lang.reflect.Executableから継承されたメソッド

クラス java.lang.reflect.AccessibleObjectから継承されるメソッド

クラス java.lang.Objectから継承されたメソッド

インタフェース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