インタフェース・メソッド

すべてのスーパー・インタフェース:
Accessible, Comparable<Method>, Locatable, Mirror, TypeComponent
public interface Method extends TypeComponent, Locatable, Comparable<Method>
ターゲットVM内のstaticメソッドまたはインスタンス・メソッドです。 FieldおよびMethodのミラーに関する一般的な情報については、TypeComponentを参照してください。
導入されたバージョン:
1.3
関連項目:

  • メソッドの詳細

    • returnTypeName

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

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

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

    • returnType

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

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

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

    • 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 - 適切なクラス・ローダーによる型のロードがまだ行われていない場合。
      関連項目:

    • isAbstract

      boolean isAbstract()
      このメソッドがabstractかどうかを判定します。
      戻り値:
      メソッドが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。

    • isObsolete

      boolean isObsolete()
      メソッドがもう使用されていないものかどうかを判別します。
      戻り値:
      このメソッドがVirtualMachine.redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)操作により廃止されている場合はtrue。
      導入されたバージョン:
      1.4

    • 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(int lineNumber) throws AbsentInformationException
      指定された行番号にマッピングされたすべてのLocationオブジェクトを含むリストを返します。

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

      パラメータ:
      lineNumber - 行番号
      戻り値:
      指定された行番号にマッピングされたLocationオブジェクトのリスト。
      例外:
      AbsentInformationException - このメソッド用の行番号情報が存在しない場合。

    • 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。
      関連項目:

    • hashCode

      int hashCode()
      このメソッド用のハッシュ・コード値を返します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      整数のハッシュ・コード
      関連項目: