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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    List<Location>
    allLineLocations()
    このメソッド内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。
    List<Location>
    allLineLocations(String stratum, String sourceName)
    このメソッド内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。
    List<LocalVariable>
    arguments()
    このメソッドの引数として宣言される各LocalVariableを含むリストを返します。
    List<String>
    argumentTypeNames()
    このメソッドの各仮パラメータ型のテキスト表現を含むリストを返します。
    List<Type>
    argumentTypes()
    このメソッドの各仮パラメータの型を含むリストを返します。
    byte[]
    bytecodes()
    このメソッド用のバイト・コードを含む配列を返します。
    boolean
    equals(Object obj)
    指定されたObjectがこのメソッドと等しいかどうか比較します。
    int
    hashCode()
    このメソッド用のハッシュ・コード値を返します。
    boolean
    isAbstract()
    このメソッドがabstractかどうかを判定します。
    boolean
    isBridge()
    このメソッドがブリッジ・メソッドであるかどうかを判定します。
    boolean
    isConstructor()
    このメソッドがコンストラクタかどうかを判定します。
    default boolean
    isDefault()
    このメソッドがデフォルト・メソッドであるかどうかを判定します
    boolean
    isNative()
    このメソッドがnativeかどうかを判定します。
    boolean
    isObsolete()
    メソッドがもう使用されていないものかどうかを判別します。
    boolean
    isStaticInitializer()
    このメソッドがstatic初期化子かどうかを判定します。
    boolean
    isSynchronized()
    このメソッドがsynchronizedかどうかを判定します。
    boolean
    isVarArgs()
    このメソッドが引数の可変数を受け入れるかどうかを判定します。
    Location
    location()
    このメソッドに関連した実行可能コードが存在する場合、このメソッドのLocationを返します。
    Location
    locationOfCodeIndex(long codeIndex)
    指定されたコード・インデックスに対応するLocationを返します。
    List<Location>
    locationsOfLine(int lineNumber)
    指定された行番号にマッピングされたすべてのLocationオブジェクトを含むリストを返します。
    List<Location>
    locationsOfLine(String stratum, String sourceName, int lineNumber)
    指定された行番号とソース名にマッピングされたすべてのLocationオブジェクトを含むリストを返します。
    Type
    returnType()
    このメソッドの宣言で指定された戻り値の型を返します。
    String
    returnTypeName()
    このメソッドの宣言で指定された戻り値の型のテキスト表現を返します。
    List<LocalVariable>
    variables()
    このメソッドで宣言された各LocalVariableを含むリストを返します。
    List<LocalVariable>
    variablesByName(String name)
    このメソッドで指定された名前の各LocalVariableを含むリストを返します。

    インタフェースAccessibleで宣言されたメソッド

    isPackagePrivate, isPrivate, isProtected, isPublic, modifiers
    修飾子と型
    メソッド
    説明
    boolean
    isPackagePrivate()
    このオブジェクトがpackage private項目をミラー化するかどうかを判定します。
    boolean
    isPrivate()
    このオブジェクトがprivate項目をミラー化するかどうかを判定します。
    boolean
    isProtected()
    このオブジェクトがprotected項目をミラー化するかどうかを判定します。
    boolean
    isPublic()
    このオブジェクトがpublic項目をミラー化するかどうかを判定します。
    int
    modifiers()
    整数でエンコードされたJavaプログラミング言語修飾子を返します。

    インタフェースComparableで宣言されたメソッド

    compareTo
    修飾子と型
    メソッド
    説明
    int
    compareTo(Method o)
    このオブジェクトと指定されたオブジェクトの順序を比較します。

    インタフェースMirrorで宣言されたメソッド

    toString, virtualMachine
    修飾子と型
    メソッド
    説明
    String
    toString()
    このミラーについて説明する文字列を返します。
    VirtualMachine
    virtualMachine()
    このミラーが属するVirtualMachineを取得します。

    インタフェースで宣言されたメソッド TypeComponent

    declaringType, genericSignature, isFinal, isStatic, isSynthetic, name, signature
    修飾子と型
    メソッド
    説明
    ReferenceType
    declaringType()
    このコンポーネントが宣言された型を返します。
    String
    genericSignature()
    存在する場合はこのTypeComponentのジェネリック・シグニチャを取得します。
    boolean
    isFinal()
    このTypeComponentがfinalかどうかを特定します。
    boolean
    isStatic()
    このTypeComponentがstaticかどうかを判定します。
    boolean
    isSynthetic()
    このTypeComponentが合成かどうかを判定します。
    String
    name()
    この型コンポーネントの名前を取得します。
    String
    signature()
    このタイプ・コンポーネントの「型シグネチャ」を取得します。

  • メソッドの詳細

    • 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(Map)操作によって廃止された場合は、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
      戻り値:
      整数のハッシュ・コード
      関連項目: