モジュール java.base
パッケージ java.lang.reflect

クラスConstructor<T>

型パラメータ:
T - コンストラクタが宣言されているクラス
すべての実装されたインタフェース:
AnnotatedElement, GenericDeclaration, Member

public final class Constructor<T> extends Executable
Constructorは、クラスの単一コンストラクタについての情報と単一コンストラクタへのアクセスを提供します。

Constructorは、基になるコンストラクタの仮パラメータと、newInstance()への実パラメータを一致させる場合に、拡張変換が発生することを許可しますが、縮小変換が発生する場合はIllegalArgumentExceptionをスローします。

導入されたバージョン:
1.1
関連項目:
Member, Class, Class.getConstructors(), Class.getConstructor(Class[]), Class.getDeclaredConstructors()
  • フィールドのサマリー

    インタフェース java.lang.reflect.Memberで宣言されたフィールド

    DECLARED, PUBLIC
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    equals​(Object obj)
    このConstructorを指定されたオブジェクトと比較します。
    このExecutableオブジェクトによって表されるメソッド/コンストラクタのレシーバ型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。
    このExecutableによって表されるメソッドまたはコンストラクタの戻り型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。
    <T extends Annotation>
    T
    getAnnotation​(Class<T> annotationClass)
    存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
    この要素に直接存在する注釈を返します。
    このオブジェクトが表すコンストラクタを宣言するクラスを表すClassオブジェクトを返します。
    Class<?>[]
    このオブジェクトで表される基礎となる実行可能ファイルによってスローされるように宣言されている例外の型を表すClassオブジェクトの配列を返します。
    このexecutableオブジェクトによってスローされることが宣言されている例外を表すTypeオブジェクトの配列を返します。
    このオブジェクトによって表される実行可能要素の仮パラメータ型を宣言順で表すTypeオブジェクトの配列を返します。
    int
    このオブジェクトによって表される実行可能要素のJava言語修飾子を返します。
    このコンストラクタの名前を文字列として返します。
    このオブジェクトによって表されるExecutableの仮パラメータの注釈を表すAnnotationの配列の配列を、宣言順に返します。
    int
    このオブジェクトによって表される実行可能要素の仮パラメータ(明示的に宣言されているか、暗黙的に宣言されているか、そのいずれでもないかに関係なく)の数を返します。
    Class<?>[]
    このオブジェクトによって表される実行可能ファイルの仮パラメータ型を宣言順で表すClassオブジェクトの配列を返します。
    GenericDeclarationオブジェクトによって表されるジェネリック宣言で宣言された型変数を表すTypeVariableオブジェクトの配列を宣言順に返します。
    int
    このConstructorのハッシュ・コードを返します。
    boolean
    この実行可能要素が合成構造である場合はtrueを返し、そうでない場合はfalseを返します。
    boolean
    この実行可能要素が可変数の引数を取るように宣言されていた場合はtrueを返し、そうでない場合はfalseを返します。
    newInstance​(Object... initargs)
    指定された初期化パラメータで、このコンストラクタの宣言クラスの新しいインスタンスを作成および初期化する場合は、このConstructorオブジェクトによって表されるコンストラクタを使用します。
    void
    setAccessible​(boolean flag)
    このリフレクトされたオブジェクトのaccessibleフラグを、指定されたブール値に設定します。
    型パラメータを含む、このConstructorを記述する文字列を返します。
    このConstructorを記述する文字列を返します。

    クラス java.lang.reflect.Executableで宣言されたメソッド

    getAnnotatedExceptionTypes, getAnnotatedParameterTypes, getAnnotationsByType, getParameters

    クラス java.lang.Objectで宣言されたメソッド

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

    インタフェース java.lang.reflect.AnnotatedElementで宣言されたメソッド

    getAnnotations, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAnnotationPresent
  • メソッドの詳細

    • setAccessible

      public void setAccessible(boolean flag)
      このリフレクトされたオブジェクトのaccessibleフラグを、指定されたブール値に設定します。 trueの値は、リフレクトされたオブジェクトが使用されたときに、Java言語のアクセス制御のチェックを抑制すべきであることを示します。 falseの値は、リフレクトされたオブジェクトが、使用時にJava言語のアクセス制御をチェックし、クラスの説明に記載されているバリエーションを適用する必要があることを示します。

      このメソッドは、Cクラスの呼び出し側がdeclaring class Dmemberへのアクセスを可能にするために使用されます:

      • CDは同じモジュールにあります。
      • メンバーはpublicであり、Dはパッケージ内のpublicであり、D exportsを含むモジュールは少なくともCを含むモジュールに含まれます。
      • メンバーはprotected staticDはパッケージ内のpublicであり、Dを含むモジュールは少なくともCを含むモジュールにエクスポートし、CDのサブクラスです。
      • Dは、少なくともCを含むモジュールにD opensを含むモジュールがパッケージされています。 名前のないモジュールとオープン・モジュールのすべてのパッケージはすべてのモジュールに対してオープンであるため、このメソッドは、Dが名前のないモジュールまたはオープン・モジュールにあるときには常に成功します。

      このメソッドは、宣言クラスが呼び出し元とは異なるモジュールにあり、宣言クラスを含むパッケージが呼び出し元に対して開かれていない場合に、privateメンバー、デフォルト(package)アクセスを持つメンバー、保護されたインスタンス・メンバー、または保護されたコンストラクタ・モジュール。

      このメソッドを使用して、non-modifiable最終フィールドへのwriteアクセスを有効にすることはできません。 次のフィールドは変更できません:

      • 任意のクラスまたはインタフェースで宣言されたstatic finalフィールド
      • 「非表示クラス」で宣言された最終フィールド
      • 「レコード」で宣言された最終フィールド

      trueがJava言語アクセス制御チェックを抑制して、これらの変更不可能な最終フィールドへのreadアクセスのみを有効にする場合のaccessibleフラグ。

      セキュリティ・マネージャがある場合、そのcheckPermissionメソッドは最初にReflectPermission("suppressAccessChecks")パーミッションで呼び出されます。

      このオブジェクトがClassクラスのConstructorオブジェクトであり、flagがtrueの場合、SecurityExceptionもスローされます。

      オーバーライド:
      クラスAccessibleObjectsetAccessible
      パラメータ:
      flag - accessibleフラグの新しい値
      例外:
      InaccessibleObjectException - アクセスを有効にできない場合
      SecurityException - リクエストがセキュリティ・マネージャによって拒否された場合、またはこれがjava.lang.Classのコンストラクタである場合
      関連項目:
      AccessibleObject.trySetAccessible(), MethodHandles.privateLookupIn(java.lang.Class<?>, java.lang.invoke.MethodHandles.Lookup)
    • 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 Virtual Machine仕様」で指定された形式に準拠していない場合
      導入されたバージョン:
      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 Virtual Machine仕様」で指定された形式に準拠していない場合
      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 Virtual Machine仕様」で指定された形式に準拠していない場合
      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)
       

      コンストラクタが例外をスローするように宣言されている場合、パラメータのリストのあとに空白、「throws」という文字列、カンマ区切りのスローされる例外型が順番に続きます。

      コンストラクタに指定できる修飾子は、アクセス修飾子のpublicprotectedまたはprivateだけです。 指定できる修飾子は1つだけです。デフォルト(package)アクセスを持つコンストラクタでは、1つも指定しません。

      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      このConstructorを記述する文字列
      Java言語仕様を参照してください:
      8.8.3 コンストラクタの修飾子
      8.9.2列挙型本文宣言
    • toGenericString

      public String toGenericString()
      型パラメータを含む、このConstructorを記述する文字列を返します。 その文字列は、コンストラクタ・アクセス修飾子として書式設定されます。そのあとに、コンストラクタ・タイプのパラメータの空白区切りのカンマ区切りのリストがある場合は、そのパラメータの情報境界を含む任意の場合は、宣言されたクラスの完全修飾名が後に続き、その次にコンストラクタ汎用仮パラメータ・タイプの親で区切られたカンマ区切りのリストが続きます。 このコンストラクタが可変数の引数を取るように宣言されていた場合は、最後のパラメータが"Type[]"として示されるのではなく、"Type..."として示されます。 スペースは、アクセス修飾子を互いに、型パラメータまたはクラス名から分離するために使用されます。 型パラメータがない場合、型パラメータのリストは省略されます。型パラメータのリストが存在する場合、リストとクラス名は空白文字で区切られます。 例外をスローするようにコンストラクタが宣言されている場合は、パラメータ・リストの後にスペースが続き、その後に"throws"という単語が続き、スローされたジェネリックな例外型のカンマ区切りリストが続きます。

      コンストラクタに指定できる修飾子は、アクセス修飾子のpublicprotectedまたはprivateだけです。 指定できる修飾子は1つだけです。デフォルト(package)アクセスを持つコンストラクタでは、1つも指定しません。

      定義:
      toGenericString、クラス: Executable
      戻り値:
      型パラメータを含む、このConstructorを記述する文字列
      Java言語仕様を参照してください:
      8.8.3 コンストラクタの修飾子
      8.9.2列挙型本文宣言
      導入されたバージョン:
      1.5
    • newInstance

      指定された初期化パラメータで、このコンストラクタの宣言クラスの新しいインスタンスを作成および初期化する場合は、この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。
      Java言語仕様を参照してください:
      13.1 バイナリの形式
      導入されたバージョン:
      1.5
    • 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、クラス: AccessibleObject
      戻り値:
      この要素に直接存在する注釈
      導入されたバージョン:
      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オブジェクト「インスタンス・メソッドを表すか、内部メンバー・クラスのコンストラクタを表します。」とメソッド/コンストラクタeitherに受信側パラメータがない場合、または型に注釈のない受信側パラメータがある場合、戻り値は注釈のない要素を表すAnnotatedTypeオブジェクトです。 このExecutableオブジェクトが静的メソッドを表している場合、または最上位、静的メンバー、ローカル、または匿名クラスのコンストラクタを表す場合、戻り値はnullです。
      オーバーライド:
      getAnnotatedReceiverType、クラス: Executable
      戻り値:
      このExecutableが受信機パラメータを持つことができない場合、このExecutableまたはnullによって表されるメソッドまたはコンストラクタのレシーバ型を表すオブジェクト
      導入されたバージョン:
      1.8