モジュール 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()

    • メソッドの詳細

      • setAccessible

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

        このメソッドは、次のいずれかに当てはまる場合に、クラスCのコール元がmemberのdeclaring class Dへのアクセスを有効にするために使用できます。

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

        このメソッドは、宣言クラスがコール元とは異なるモジュールにあり、宣言クラスを含むパッケージがコール元のモジュールに対して開かれていない場合に、プライベート・メンバー、デフォルト(パッケージ)アクセスを持つメンバー、保護されたインスタンス・メンバーまたは保護されたコンストラクタへのアクセスを有効にするために使用できません。

        セキュリティ・マネージャが存在する場合は、最初にそのcheckPermissionメソッドがReflectPermission("suppressAccessChecks")権限でコールされます。

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

        オーバーライド:
        setAccessible、クラスAccessibleObject
        パラメータ:
        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
        戻り値:
        基本となるメンバーの単純名

      • getTypeParameters

        public TypeVariable<Constructor<T>>[] getTypeParameters()
        GenericDeclarationオブジェクトによって表されるジェネリック宣言で宣言された型変数を表すTypeVariableオブジェクトの配列を宣言順に返します。 基になるジェネリック宣言で型変数が宣言されていない場合は、長さ0の配列が返されます。
        定義:
        getTypeParameters、インタフェースGenericDeclaration
        定義:
        getTypeParameters、クラスExecutable
        戻り値:
        このジェネリック宣言で宣言された型変数を表すTypeVariableオブジェクトの配列
        例外:
        GenericSignatureFormatError - このジェネリック宣言のジェネリック・シグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合
        導入されたバージョン:
        1.5

      • getParameterCount

        public int getParameterCount()
        このオブジェクトによって表される実行可能要素の仮パラメータ(明示的に宣言されているか、暗黙的に宣言されているか、そのいずれでもないかに関係なく)の数を返します。
        オーバーライド:
        getParameterCount、クラスExecutable
        戻り値:
        このオブジェクトが表す実行可能要素の仮パラメータの数
        導入されたバージョン:
        1.8

      • getGenericParameterTypes

        public Type[] getGenericParameterTypes()
        このオブジェクトによって表される実行可能要素の仮パラメータ型を宣言順で表すTypeオブジェクトの配列を返します。 基礎となる実行可能要素にパラメータが設定されていない場合には、長さ0の配列が返されます。

        仮パラメータ型が、パラメータ化された型の場合、返されるTypeオブジェクトは、ソース・コードで使用される実際の型パラメータを正確に反映しなければいけません。

        仮パラメータ型が、型変数またはパラメータ化された型の場合、仮パラメータ型は作成されます。 そうでない場合、例外タイプは解決されます。

        オーバーライド:
        getGenericParameterTypes、クラスExecutable
        戻り値:
        基礎となる実行可能要素の仮パラメータ型を表す、宣言順のTypeの配列
        例外:
        GenericSignatureFormatError - ジェネリック・メソッドのシグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合
        TypeNotPresentException - 基礎となる実行可能要素のパラメータ型のいずれかが、存在しない型宣言を参照する場合
        MalformedParameterizedTypeException - 基礎となる実行可能要素のパラメータ型のいずれかが、なんらかの理由によりインスタンス化できないパラメータ化された型を参照する場合
        導入されたバージョン:
        1.5

      • 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)

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

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

        オーバーライド:
        toString、クラスObject
        戻り値:
        このConstructorを記述する文字列
        The Java™Language Specificationを参照してください。
        8.8.3 コンストラクタ修飾子、8.9.2 Enum Body Declarations

      • toGenericString

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

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

        定義:
        toGenericString、クラスExecutable
        戻り値:
        型パラメータを含む、このConstructorを記述する文字列
        導入されたバージョン:
        1.5
        The Java™Language Specificationを参照してください。
        8.8.3 コンストラクタ修飾子、8.9.2 Enum Body Declarations

      • 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
        The Java™Language Specificationを参照してください。
        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、クラスAccessibleObject
        戻り値:
        この要素に直接存在する注釈
        導入されたバージョン:
        1.5

      • getParameterAnnotations

        public Annotation[][] getParameterAnnotations()
        このオブジェクトによって表されるExecutableの仮パラメータの注釈を表すAnnotationの配列の配列を、宣言順に返します。 返される配列では、内部クラス・コンストラクタに対する外部のthisパラメータなど、合成および必須パラメータ(次の説明を参照)が表されます。 実行可能要素がパラメータを持たない(つまり、仮パラメータも合成パラメータも必須パラメータも持たない)場合は、長さ0の配列が返されます。 実行可能要素に1つ以上のパラメータがある場合、注釈を含まないパラメータごとに長さゼロの入れ子の配列を返します。 返された配列に含まれる注釈オブジェクトは直列化できます。 このメソッドの呼出し元は、返された配列を自由に変更できます。この変更は、ほかの呼出し元に返された配列に影響を及ぼしません。 コンパイラによって、ソースで暗黙的に宣言されている追加のパラメータ("必須")、およびソースで暗黙的にも明示的にも宣言されていないパラメータ("合成")がメソッドのパラメータ・リストに追加されることがあります。 詳細は、Parameterを参照してください。
        定義:
        getParameterAnnotations、クラスExecutable
        戻り値:
        このオブジェクトにより表された実行可能要素の仮パラメータおよび暗黙的なパラメータの注釈を表す宣言順の配列の配列
        導入されたバージョン:
        1.5
        関連項目:
        Parameter, AnnotatedElement.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オブジェクトが静的メソッドを表す場合、またはトップ・レベル、静的メンバー、ローカルまたは匿名クラスのコンストラクタを表す場合、戻り値はnullになります。
        オーバーライド:
        getAnnotatedReceiverType、クラスExecutable
        戻り値:
        このExecutableが受信パラメータを持てない場合は、このExecutableまたはnullによって表されるメソッドまたはコンストラクタの受信者タイプを表すオブジェクト
        導入されたバージョン:
        1.8