モジュール jdk.jdi
パッケージ com.sun.jdi

インタフェースMethod

    • メソッドの詳細

      • returnTypeName

        String returnTypeName​()
        このメソッドの宣言で指定された戻り値の型のテキスト表現を返します。

        この型名は、型がまだ作成またはロードされていない場合でも利用可能です。

        戻り値:
        戻り値の型名を含むString。

      • returnType

        Type returnType​()
         throws ClassNotLoadedException
        このメソッドの宣言で指定された戻り値の型を返します。

        注: このメソッドの戻り値の型が参照型(クラス、インタフェース、または配列)であり、宣言する型のクラス・ローダー(declaringType() .classLoader())によって作成またはロードされていない場合、ClassNotLoadedExceptionがスローされます。 また、参照型がロードされていても準備が整っていない場合があります。この場合、型は返されますが、返された型に対してfields()などの操作を実行しようとすると、ClassNotPreparedExceptionがスローされます。 参照型の準備ができているかどうかを確認するには、ReferenceType.isPrepared()を使用します。

        戻り値:
        このメソッドの戻り値のType。
        例外:
        ClassNotLoadedException - 型が、適切なクラス・ローダーを使ってロードまたは作成されていない場合。
        関連項目:
        Type, Field.type() - for usage examples

      • argumentTypeNames

        List<String> argumentTypeNames​()
        このメソッドの各仮パラメータ型のテキスト表現を含むリストを返します。

        このリストは、型がまだ作成またはロードされていない場合でも利用可能です。

        戻り値:
        StringのList。このメソッドのパラメータ1個につきList要素1個。 各要素はコンパイル時に指定された仮パラメータの型を表す。 仮パラメータの宣言で省略記号が使われている場合は、型の配列として省略記号の前に置かれる。

      • argumentTypes

        List<Type> argumentTypes​()
                  throws ClassNotLoadedException
        このメソッドの各仮パラメータの型を含むリストを返します。

        注: 参照型(クラス、インタフェース、または配列)のパラメータが存在し、このパラメータが宣言する型のクラス・ローダー(declaringType() .classLoader())によって作成またはロードされていない場合、ClassNotLoadedExceptionがスローされます。 また、参照型の場合、ロードされていても準備が整っていない場合があります。この場合、リストは返されますが、その型に対してfields()などの操作を実行しようとすると、ClassNotPreparedExceptionがスローされます。 参照型の準備ができているかどうかを確認するには、ReferenceType.isPrepared()を使用します。

        戻り値:
        TypeのList。このメソッドのパラメータ1個につきList要素1個を返す。 各要素はコンパイル時に指定された仮パラメータの型を表す。 仮パラメータの宣言で省略記号が使われている場合は、型の配列として省略記号の前に置かれる。
        例外:
        ClassNotLoadedException - 適切なクラス・ローダーによる型のロードがまだ行われていない場合。
        関連項目:
        Type

      • isAbstract

        boolean isAbstract​()
        このメソッドがabstractかどうかを判定します。
        戻り値:
        メソッドが抽象宣言されている場合はtrue; それ以外の場合はfalse。

      • isDefault

        default boolean isDefault​()
        このメソッドがデフォルト・メソッドであるかどうかを判定します
        戻り値:
        メソッドがデフォルトと宣言されている場合はtrue; それ以外の場合はfalse。
        導入されたバージョン:
        1.8

      • isSynchronized

        boolean isSynchronized​()
        このメソッドがsynchronizedかどうかを判定します。
        戻り値:
        メソッドが同期宣言されている場合はtrue; それ以外の場合はfalse。

      • isNative

        boolean isNative​()
        このメソッドがnativeかどうかを判定します。
        戻り値:
        メソッドがネイティブ宣言されている場合true; それ以外の場合はfalse。

      • isVarArgs

        boolean isVarArgs​()
        このメソッドが引数の可変数を受け入れるかどうかを判定します。
        戻り値:
        メソッドが可変数の引数を受け入れる場合はtrue、それ以外の場合はfalse。
        導入されたバージョン:
        1.5

      • isBridge

        boolean isBridge​()
        このメソッドがブリッジ・メソッドであるかどうかを判定します。 ブリッジ・メソッドについては、「Java™言語仕様」を参照してください。
        戻り値:
        メソッドがブリッジ・メソッドの場合はtrue、そうでない場合はfalse。
        導入されたバージョン:
        1.5

      • isConstructor

        boolean isConstructor​()
        このメソッドがコンストラクタかどうかを判定します。
        戻り値:
        メソッドがコンストラクタである場合はtrue; それ以外の場合はfalse。

      • isStaticInitializer

        boolean isStaticInitializer​()
        このメソッドがstatic初期化子かどうかを判定します。
        戻り値:
        メソッドが静的初期化子の場合はtrue; それ以外の場合はfalse。

      • allLineLocations

        List<Location> allLineLocations​()
                         throws AbsentInformationException
        このメソッド内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。

        このメソッドは、allLineLocations(vm.getDefaultStratum(),null)と同等です(詳細はallLineLocations(String,String)を参照)。

        戻り値:
        すべてのソース行のLocationオブジェクトのリスト。
        例外:
        AbsentInformationException - この(非nativeで非abstract)メソッドに対する行番号情報が存在しない場合。

      • allLineLocations

        List<Location> allLineLocations​(String stratum,
                                String sourceName)
                         throws AbsentInformationException
        このメソッド内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。

        各位置では、特定のソース行がコード・インデックスの特定の範囲にマップされています。 この範囲の開始点は、Location.codeIndex()によって調べることができます。 返されるリスト内の要素は、コード・インデックスの昇順に格納されます。

        返されるリストには、特定の行番号に対して複数の位置が含まれる可能性がありますが、これは、コンパイラやVMが特定の行を、連続していない複数のコード・インデックス範囲へマッピングする場合があるからです。

        メソッドがnativeまたはabstractの場合、空リストが返されます。

        返されるリストは、指定された層のリストです。層の詳細は、Locationを参照してください。

        パラメータ:
        stratum - 情報取得元の層。ReferenceType.defaultStratum()を使う場合はnull
        sourceName - 特定のソース・ファイル内の位置だけを取得する場合はそのファイル名、そうでない場合はnull。
        戻り値:
        すべてのソース行のLocationオブジェクトのリスト。
        例外:
        AbsentInformationException - この(非nativeで非abstract)メソッドに対する行番号情報が存在しない場合。 またはsourceNameがnullでないのにソース名情報が存在しない場合。
        導入されたバージョン:
        1.4

      • locationsOfLine

        List<Location> locationsOfLine​(String stratum,
                               String sourceName,
                               int lineNumber)
                        throws AbsentInformationException
        指定された行番号とソース名にマッピングされたすべてのLocationオブジェクトを含むリストを返します。

        指定された行番号にマッピングされたLocationを含むリストを返します。 返されるリストには、コンパイラとVMのいずれかまたは両方により指定の行に割り当てられた個別のコード・インデックス範囲の位置が含まれます。 返される各位置は、この範囲の先頭に対応します。 指定された行番号に実行可能コードが存在しない場合は、空のリストが返されます。特に、ネイティブおよび抽象メソッドは常に空のリストを返します。

        返されるリストは、指定された層のリストです。層の詳細は、Locationを参照してください。

        パラメータ:
        stratum - 行番号とソース名の比較に使用する層。デフォルトの層を使用する場合はnull
        sourceName - 行番号を含むソース名。すべてのソース名に一致させる場合はnull
        lineNumber - 行番号
        戻り値:
        指定された行番号にマッピングされたLocationオブジェクトのリスト。
        例外:
        AbsentInformationException - このメソッド用の行番号情報が存在しない場合。 またはsourceNameがnullでないのにソース名情報が存在しない場合。
        導入されたバージョン:
        1.4

      • locationOfCodeIndex

        Location locationOfCodeIndex​(long codeIndex)
        指定されたコード・インデックスに対応するLocationを返します。
        戻り値:
        指定されたコード・インデックスに対応するLocation。指定されたコード・インデックスがこのメソッドに対して有効なコード・インデックスでない場合はnull (nativeおよびabstractメソッドは常にnullを返す)。

      • variables

        List<LocalVariable> variables​()
                       throws AbsentInformationException
        このメソッドで宣言された各LocalVariableを含むリストを返します。 リストには、メソッドの各スコープ内で宣言されたすべての変数が含まれます。 リストには、別個のスコープ内で宣言された、同じ名前を持つ複数の変数が含まれることがあります。 引数はローカル変数と見なされ、返されるリスト内に配置されます。 ローカル変数の情報が得られない場合、呼び出されるメソッドの実際の引数の値は、StackFrame.getArgumentValues()メソッドを使って取得できます。
        戻り値:
        ターゲットVMのこのメソッド内で宣言されたローカル変数をミラー化するLocalVariableオブジェクトのリスト。 ローカル変数が存在しない場合は、長さゼロのリストを返す。
        例外:
        AbsentInformationException - このメソッドの変数の情報がない場合。 通常、nativeまたはabstractメソッドではローカル変数の情報は得られない(引数名の情報は得られない)ので、これらのメソッドはこの例外を返す。

      • variablesByName

        List<LocalVariable> variablesByName​(String name)
                             throws AbsentInformationException
        このメソッドで指定された名前の各LocalVariableを含むリストを返します。 メソッド内の別個のスコープで同じ変数名が使用される場合、複数の変数が返されることがあります。
        戻り値:
        指定された名前のLocalVariableオブジェクトのリスト。 一致するローカル変数が存在しない場合は、長さゼロのリストを返す。
        例外:
        AbsentInformationException - このメソッドの変数の情報がない場合。 通常、nativeまたはabstractメソッドではローカル変数の情報は得られない(引数名の情報は得られない)ので、これらのメソッドはこの例外を返す。

      • arguments

        List<LocalVariable> arguments​()
                       throws AbsentInformationException
        このメソッドの引数として宣言される各LocalVariableを含むリストを返します。 ローカル変数の情報が得られない場合、呼び出されるメソッドの実際の引数の値は、StackFrame.getArgumentValues()メソッドを使って取得できます。
        戻り値:
        LocalVariable引数のリスト。 引数が存在しない場合は、長さゼロのリストを返す。
        例外:
        AbsentInformationException - このメソッドの変数の情報がない場合。 通常、nativeまたはabstractメソッドではローカル変数の情報は得られない(引数名の情報は得られない)ので、これらのメソッドはこの例外を返す。

      • bytecodes

        byte[] bytecodes​()
        このメソッド用のバイト・コードを含む配列を返します。

        この操作は、ターゲット仮想マシンでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canGetBytecodes()を使用します。

        戻り値:
        バイト・コードの配列。abstractおよびnativeメソッドは長さゼロの配列を返す。
        例外:
        UnsupportedOperationException - ターゲットVirtual Machineがバイト・コードの取得をサポートしない場合。

      • location

        Location location​()
        このメソッドに関連した実行可能コードが存在する場合、このメソッドのLocationを返します。
        定義:
        location 、インタフェース: Locatable
        戻り値:
        このミラーのLocation。このメソッドがabstractメソッドの場合はnull。nativeメソッドはcodeIndexが -1のLocationオブジェクトを返す。

      • equals

        boolean equals​(Object obj)
        指定されたObjectがこのメソッドと等しいかどうか比較します。
        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        obj - 比較対象の参照オブジェクト。
        戻り値:
        オブジェクトがメソッドである場合、および両方が(同じVM内の同じクラスまたはインタフェース内で宣言された)同じメソッドをミラー化する場合はtrue。
        関連項目:
        Object.hashCode()、HashMap