インタフェースReferenceType

すべてのスーパー・インタフェース:
Accessible, Comparable<ReferenceType>, Mirror, Type
既知のすべてのサブインタフェース:
ArrayType, ClassType, InterfaceType
public interface ReferenceType extends Type, Comparable<ReferenceType>, Accessible
ターゲットVM内の任意のオブジェクトの型を表します。 ReferenceTypeには、「Java言語仕様」で定義されているクラス、インタフェースおよび配列型が含まれます。 すべてのReferenceTypeオブジェクトは、クラスのClassType、インタフェースのInterfaceType、配列のArrayTypeのいずれかのサブインタフェースに属します。 プリミティブ・クラス(Integer.TYPEのreflected typeなど)は、ClassTypeとして表されることに注意してください。 VMはこれら3つの型のどの場合もClassオブジェクトを生成するため、VMから見ると、各ReferenceTypeは個別のClassオブジェクトにマッピングされます。

ReferenceTypeを取得するには、特定のObjectReferenceにその型を照会するか、VirtualMachineからすべての参照型のリストを取得します。

ReferenceTypeを使用して、メソッドやフィールドなどの静的な型の情報、または対応するClassオブジェクトやクラス・ローダーなどの動的な型の情報にアクセスすることができます。

ターゲットVMが切断された場合、ReferenceTypeを直接的または間接的にパラメータとして取るReferenceType上の任意のメソッドは、VMDisconnectedExceptionをスローし、VMDisconnectEventがEventQueueから読出せるようになります。

ReferenceTypeを直接的または間接的にパラメータとして取るReferenceType上の任意のメソッドは、ターゲットVMのメモリーが不足するとVMOutOfMemoryExceptionをスローします。

ReferenceTypeを直接的または間接的にパラメータに取るReferenceType上の任意のメソッドは、ミラーされた型がアンロードされた場合にObjectCollectedExceptionをスローします。

導入されたバージョン:
1.3
関連項目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    List<Field>
    allFields()
    この型、そのスーパー・クラス、実装インタフェース、およびスーパー・インタフェース、またはそのいずれかで宣言された各Fieldを含むリストを返します。
    List<Location>
    allLineLocations()
    この参照型内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。
    List<Location>
    allLineLocations(String stratum, String sourceName)
    この参照型内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。
    List<Method>
    allMethods()
    この型、そのスーパー・クラス、実装インタフェース、およびスーパー・インタフェース、またはそのいずれかで宣言された各Methodを含むリストを返します。
    List<String>
    availableStrata()
    この参照型で利用可能な層を返します。
    ClassLoaderReference
    classLoader()
    この型に対応するクラスをロードしたクラス・ローダーのオブジェクトを取得します。
    ClassObjectReference
    classObject()
    ターゲットVM内でこの型に対応するクラス・オブジェクトを返します。
    byte[]
    constantPool()
    「Java仮想マシン仕様」のクラス・ファイル形式の説明に記載されているconstant_pool項目の形式で、定数プールのrawバイト数を返します。
    int
    constantPoolCount()
    定数プール内のエントリ数に1を加えた値を返します。
    String
    defaultStratum()
    この参照型のデフォルト層を返します。
    boolean
    equals(Object obj)
    指定されたObjectとこのReferenceTypeが等しいかどうかを比較します。
    boolean
    failedToInitialize()
    このクラスの初期化が失敗したかどうかを判定します。
    Field
    fieldByName(String fieldName)
    指定されたあいまいでない名前で、可視Fieldを検索します。
    List<Field>
    fields()
    この型で宣言された各Fieldを含むリストを返します。
    String
    genericSignature()
    存在する場合は、この型のジェネリック・シグニチャを取得します。
    Value
    getValue(Field field)
    この型の指定のstatic FieldのValueを取得します。
    Map<Field,Value>
    getValues(List<? extends Field> fields)
    指定のリストにある各static FieldのValueを含むマップを返します。
    int
    hashCode()
    このObjectReferenceのハッシュ・コード値を返します。
    List<ObjectReference>
    instances(long maxInstances)
    このReferenceTypeのインスタンスを返します。
    boolean
    isAbstract()
    この型がabstractとして宣言されたかどうかを判定します。
    boolean
    isFinal()
    この型がfinalとして宣言されたかどうかを判定します。
    boolean
    isInitialized()
    この型が初期化されているかどうかを判定します。
    boolean
    isPrepared()
    この型が準備されているかどうかを判定します。
    boolean
    isStatic()
    この型がstaticとして宣言されたかどうかを判定します。
    boolean
    isVerified()
    この型が検証されているかどうかを判定します。
    List<Location>
    locationsOfLine(int lineNumber)
    指定された行番号にマッピングされたすべてのLocationオブジェクトを含むリストを返します。
    List<Location>
    locationsOfLine(String stratum, String sourceName, int lineNumber)
    指定された行番号にマッピングされたすべてのLocationオブジェクトを含むリストを返します。
    int
    majorVersion()
    「Java仮想マシン仕様」のクラス・ファイル形式の説明に定義されているように、クラスのメジャー・バージョン番号を返します。
    List<Method>
    methods()
    この型で直接宣言された各Methodを含むリストを返します。
    List<Method>
    methodsByName(String name)
    指定された名前を持つ各可視Methodを含むリストを返します。
    List<Method>
    methodsByName(String name, String signature)
    指定された名前とシグニチャを持つ各可視Methodを含むリストを返します。
    int
    minorVersion()
    「Java仮想マシン仕様」のクラス・ファイル形式の説明に定義されているように、クラスのマイナー・バージョン番号を返します。
    default ModuleReference
    module()
    この型に対応するクラスを含むモジュール・オブジェクトを取得します。
    String
    name()
    このReferenceTypeオブジェクトの名前を返します。
    List<ReferenceType>
    nestedTypes()
    この型内に宣言され、現在仮想マシンにロードされているReferenceTypeオブジェクトを含むリストを返します。
    String
    sourceDebugExtension()
    この型のソース・デバッグ拡張機能を取得します。
    String
    sourceName()
    この型の宣言に対応するソースの識別名を取得します。
    List<String>
    sourceNames(String stratum)
    この型の宣言に対応するすべてのソースの識別名を取得します。
    List<String>
    sourcePaths(String stratum)
    この型の宣言に対応するすべてのソースのパスを取得します。
    List<Field>
    visibleFields()
    この型内の非表示でなくあいまいでない各Fieldを含むリストを返します。
    List<Method>
    visibleMethods()
    この型によって宣言された、またはこの型に継承された各Methodを含むリストを返します。

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

    isPackagePrivate, isPrivate, isProtected, isPublic, modifiers

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

    compareTo

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

    toString, virtualMachine

    インタフェースcom.sun.jdi.Typeで宣言されたメソッド

    signature

  • メソッドの詳細

    • name

      String name()
      このReferenceTypeオブジェクトの名前を返します。 返される名前の形式は、Class.getName()によって返される名前と同じです。
      定義:
      name、インタフェースType
      戻り値:
      型名を含む文字列。
      関連項目:

    • genericSignature

      String genericSignature()
      存在する場合は、この型のジェネリック・シグニチャを取得します。 汎用シグネチャは、「Java Virtual Machine仕様」で説明されています。
      戻り値:
      ジェネリック・シグニチャを含む文字列、またはジェネリック・シグニチャが存在しない場合はnull。
      導入されたバージョン:
      1.5

    • classLoader

      ClassLoaderReference classLoader()
      この型に対応するクラスをロードしたクラス・ローダーのオブジェクトを取得します。
      戻り値:
      クラス・ローダーをミラー化するClassLoaderReference。クラスがブートストラップ・クラス・ローダーによってロードされた場合はnull。

    • module

      default ModuleReference module()
      この型に対応するクラスを含むモジュール・オブジェクトを取得します。 この操作は、ターゲット仮想マシンでサポートされていないことがあります。 VirtualMachine.canGetModuleInfo()を使用して、操作がサポートされているかどうかを確認します。
      実装要件:
      デフォルト実装はUnsupportedOperationExceptionをスローします。
      戻り値:
      ターゲットVM内のモジュールをミラー化するModuleReference。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合。
      導入されたバージョン:
      9

    • sourceName

      String sourceName() throws AbsentInformationException
      この型の宣言に対応するソースの識別名を取得します。 この文字列は、ソース・リポジトリ・メカニズムで解釈されます。

      戻り値のソース名は、VMのデフォルト層(VirtualMachine.getDefaultStratum())に応じて変わります。 リファレンス実装では、基底層を使用する場合、この型の宣言が含まれているソース・ファイルの非修飾名が文字列として返されます。 その他の層の場合、その層の1番目のソース名が返されます。 その他の言語では、1つの参照型に対して複数のソース・ファイルが存在する可能性があるため、Location.sourceName()またはsourceNames(String)を使用することをお勧めします。

      配列(ArrayType)およびプリミティブ・クラスの場合、常にAbsentInformationExceptionがスローされます。

      戻り値:
      文字列型のソース・ファイル名
      例外:
      AbsentInformationException - ソース名が不明の場合

    • sourceNames

      List<String> sourceNames(String stratum) throws AbsentInformationException
      この型の宣言に対応するすべてのソースの識別名を取得します。 この名前は、ソース・リポジトリ・メカニズムで解釈されます。

      返される名前は、指定された層の名前です。層の詳細は、Locationを参照してください。 リファレンス実装では、Javaプログラミング言語層を使用する場合、返されるListに含まれる要素は、String要素(この型の宣言が含まれているソース・ファイルの非修飾名)だけになります。 その他の層を使用する場合、その層で定義されているすべてのソース名が返されます。

      パラメータ:
      stratum - 情報取得元の層。宣言する型のデフォルト層を使用する場合はnull。
      戻り値:
      ソース名を表すStringオブジェクトのList
      例外:
      AbsentInformationException - ソース名が不明の場合。

      配列(ArrayType)およびプリミティブ・クラスの場合、常にAbsentInformationExceptionがスローされます。

      導入されたバージョン:
      1.4

    • sourcePaths

      List<String> sourcePaths(String stratum) throws AbsentInformationException
      この型の宣言に対応するすべてのソースのパスを取得します。 このパスは、ソース・リポジトリ・メカニズムで解釈されます。

      返されるパスは、指定された層のパスです。層の詳細は、Locationを参照してください。 リファレンス実装では、Javaプログラミング言語層のようにソース・パスを明示的に指定しない層の場合、ReferenceTypeのパッケージ名をプラットフォーム固有のパス名に変換した結果にsourceNames(String)を付加した文字列が返されます。 たとえば、Windowsプラットフォームの場合、java.lang.Threadは1つの要素"java\lang\Thread.java"を含むListを返します。

      パラメータ:
      stratum - 情報取得元の層。宣言する型のデフォルト層を使用する場合はnull。
      戻り値:
      ソース・パスを表すStringオブジェクトのList
      例外:
      AbsentInformationException - ソース名が不明の場合。

      配列(ArrayType)およびプリミティブ・クラスの場合、常にAbsentInformationExceptionがスローされます。

      導入されたバージョン:
      1.4

    • sourceDebugExtension

      String sourceDebugExtension() throws AbsentInformationException
      この型のソース・デバッグ拡張機能を取得します。

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

      戻り値:
      ソース・デバッグ拡張機能の属性の文字列
      例外:
      AbsentInformationException - 拡張が指定されていない場合
      UnsupportedOperationException - ターゲット仮想マシンでこの操作がサポートされていない場合。canGetSourceDebugExtension()を参照

    • isStatic

      boolean isStatic()
      この型がstaticとして宣言されたかどうかを判定します。 型を入れ子にしないとstaticとして宣言できないため、パッケージ・レベルの型、配列型、またはプリミティブ・クラスの場合はfalseが返されます。
      戻り値:
      この型がstaticの場合はtrue、それ以外の場合はfalse。

    • isAbstract

      boolean isAbstract()
      この型がabstractとして宣言されたかどうかを判定します。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は未定義です。

      戻り値:
      この型がabstractの場合はtrue、それ以外の場合はfalse。

    • isFinal

      boolean isFinal()
      この型がfinalとして宣言されたかどうかを判定します。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は常にtrueです。

      戻り値:
      この型がfinalの場合はtrue、それ以外の場合はfalse。

    • isPrepared

      boolean isPrepared()
      この型が準備されているかどうかを判定します。 クラス準備の定義については、JVM仕様を参照。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は未定義です。

      戻り値:
      この型が準備されている場合はtrue、それ以外の場合はfalse。

    • isVerified

      boolean isVerified()
      この型が検証されているかどうかを判定します。 クラスの検証の定義については、JVM仕様を参照してください。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は未定義です。

      戻り値:
      この型が検証されている場合はtrue、それ以外の場合はfalse。

    • isInitialized

      boolean isInitialized()
      この型が初期化されているかどうかを判定します。 クラスの検証の定義については、JVM仕様を参照してください。 InterfaceTypeの場合、このメソッドは常にisPrepared()と同じ値を返します。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は未定義です。

      戻り値:
      この型が初期化されている場合はtrue、それ以外の場合はfalse。

    • failedToInitialize

      boolean failedToInitialize()
      このクラスの初期化が失敗したかどうかを判定します。 クラスの初期化については、JVM仕様を参照してください。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は未定義です。

      戻り値:
      初期化を試行したが失敗した場合はtrue、それ以外の場合はfalse。

    • fields

      List<Field> fields()
      この型で宣言された各Fieldを含むリストを返します。 継承したフィールドは含まれません。 コンパイラによって作成された合成フィールドがある場合は、そのフィールドもこのリストに含まれます。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      FieldオブジェクトのList。フィールドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • visibleFields

      List<Field> visibleFields()
      この型内の非表示でなくあいまいでない各Fieldを含むリストを返します。 このクラスまたはそのインスタンスから、単純名でアクセスできる各フィールドが含まれます。 あいまいに多重継承されたフィールド、つまり後で継承されたクラスの同じ名前のフィールドによって隠されたフィールドには、単純名でアクセスすることはできません。このようなフィールドは、返されるリストにも含まれません。 その他の継承されたフィールドは、すべてこのリストに含まれます。 詳細は、JLSのセクション8.3を参照してください。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      FieldオブジェクトのList。可視フィールドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • allFields

      List<Field> allFields()
      この型、そのスーパー・クラス、実装インタフェース、およびスーパー・インタフェース、またはそのいずれかで宣言された各Fieldを含むリストを返します。 隠しフィールドおよび多重継承されたフィールドを含め、宣言されたフィールドおよび継承されたフィールドをすべて返します。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      FieldオブジェクトのList。フィールドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • fieldByName

      Field fieldByName(String fieldName)
      指定されたあいまいでない名前で、可視Fieldを検索します。 このメソッドは、JLS (8.3.3)に指定された継承規則に従って可視性を判断します。

      配列(ArrayType)およびプリミティブ・クラスの場合、戻り値は常にnullです。

      パラメータ:
      fieldName - 目的のフィールドの名前を含む文字列。
      戻り値:
      見つかったフィールドをミラー化するFieldオブジェクト。指定の名前のフィールドがない場合、または指定の名前があいまいな場合はnull。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • methods

      List<Method> methods()
      この型で直接宣言された各Methodを含むリストを返します。 継承されたメソッドは、含まれません。 このリストには、コンストラクタ、初期化メソッド(ある場合)、およびコンパイラによって作成された合成メソッドが含まれます。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      Methodオブジェクトのリスト。メソッドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • visibleMethods

      List<Method> visibleMethods()
      この型によって宣言された、またはこの型に継承された各Methodを含むリストを返します。 非表示またはオーバーライドされたスーパークラスまたはスーパー・インタフェースからのメソッドは含まれません。

      ただし返されるリストには、同じシグニチャを持つ多重継承メソッドが含まれることがありますが、ClassTypeのメンバーが複数含まれることはありません。 詳細は、「JLSを参照」セクションの8.4.8を参照してください。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      MethodオブジェクトのList。可視メソッドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • allMethods

      List<Method> allMethods()
      この型、そのスーパー・クラス、実装インタフェース、およびスーパー・インタフェース、またはそのいずれかで宣言された各Methodを含むリストを返します。 隠しメソッドおよびオーバーライドされたメソッドを含め、宣言されたメソッドおよび継承されたメソッドをすべて返します。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      Methodオブジェクトのリスト。メソッドが存在しない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • methodsByName

      List<Method> methodsByName(String name)
      指定された名前を持つ各可視Methodを含むリストを返します。 オーバーロードされたメソッドを検索するときによく使用します。

      オーバーライドされたメソッドおよび隠されたメソッドは、含まれません。 詳細は、JLS (8.4.8)を参照してください。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      パラメータ:
      name - 検索対象のメソッドの名前。
      戻り値:
      指定の名前に一致するMethodオブジェクトのList。一致するメソッドが見つからない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • methodsByName

      List<Method> methodsByName(String name, String signature)
      指定された名前とシグニチャを持つ各可視Methodを含むリストを返します。 シグニチャ文字列は、ターゲット・メソッドのJNIシグニチャです。
      • ()V
      • ([Ljava/lang/String;)V
      • (IIII)Z
      このメソッドは、JLS (8.4.8)に明記された継承規則に従って可視性を判断します。

      このリストには、ClassTypeの構成要素である具象メソッドが複数含まれることはありません。このリスト内のその他のメソッドは、抽象メソッドです。 一致する具象メソッドだけを取得するには、ClassType.concreteMethodByName(java.lang.String, java.lang.String)を使用します。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      パラメータ:
      name - 検索対象のメソッドの名前。
      signature - 検索対象のメソッドのシグニチャ
      戻り値:
      指定の名前およびシグニチャに一致するMethodオブジェクトのList。一致するメソッドが見つからない場合は、リストの長さはゼロになる。
      例外:
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • nestedTypes

      List<ReferenceType> nestedTypes()
      この型内に宣言され、現在仮想マシンにロードされているReferenceTypeオブジェクトを含むリストを返します。 静的な入れ子になった型と、静的でない入れ子になった型(つまり、内部型)の両方が含まれます。 この参照型内のコード・ブロックに宣言されたローカル内部型も、返されるリストに含まれます。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。

      戻り値:
      入れ子になったReferenceTypeオブジェクトのList。入れ子になった型がない場合は、リストの長さはゼロになる。

    • getValue

      Value getValue(Field field)
      この型の指定のstatic FieldのValueを取得します。 Fieldは、この型に対して有効である必要があります。つまり、Fieldは、この型、スーパー・クラス、スーパー・インタフェース、または実装インタフェースで宣言されている必要があります。
      パラメータ:
      field - 要求された値を含むフィールド
      戻り値:
      インスタンス・フィールドのValue。
      例外:
      IllegalArgumentException - フィールドがこのオブジェクトのクラスにとって有効でない場合。

    • getValues

      Map<Field,Value> getValues(List<? extends Field> fields)
      指定のリストにある各static FieldのValueを含むマップを返します。 Fieldは、この型に対して有効である必要があります。つまり、Fieldは、この型、スーパー・クラス、スーパー・インタフェース、または実装インタフェースで宣言されている必要があります。
      パラメータ:
      fields - 要求された値を含むFieldオブジェクトのリスト。
      戻り値:
      Valueを含む、要求されたFieldオブジェクトのマップ。
      例外:
      IllegalArgumentException - このオブジェクトのクラスにとって無効なフィールドがある場合。
      VMMismatchException - Mirror引数とこのミラーが同じVirtualMachineに属さない場合。

    • classObject

      ClassObjectReference classObject()
      ターゲットVM内でこの型に対応するクラス・オブジェクトを返します。 VMは、すべての種類のReferenceType (クラス、インタフェース、および配列型)のクラス・オブジェクトを生成します。
      戻り値:
      ターゲットVM内のこの参照型のClassObjectReference。

    • allLineLocations

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

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

      例外:
      AbsentInformationException - このクラスに対する行番号情報がなく、かつこのクラスの実行可能メンバーとして非nativeで非abstractなものが含まれる場合。
      ClassNotPreparedException - このクラスがまだ準備されていない場合。

    • allLineLocations

      List<Location> allLineLocations(String stratum, String sourceName) throws AbsentInformationException
      この参照型内の各実行可能ソース行のLocationオブジェクトを含むリストを返します。 各位置では、特定のソース行がコード・インデックスの特定の範囲にマップされています。 この範囲の開始点は、Location.codeIndex()によって調べることができます。 返されるリストには、特定の行番号に対して複数の位置が含まれる可能性がありますが、これは、コンパイラやVMが特定の行を、連続していない複数のコード・インデックス範囲へマッピングする場合があるからです。 同じソース行が、複数のメソッド間で、異なるコード・インデックスの範囲にマップされていることがあります。

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。 インタフェース(InterfaceType)の場合、返されるリストが空にならないのは、そのインタフェースのクラス初期化に実行可能コードが含まれている場合だけです。

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

      パラメータ:
      stratum - 情報取得元の層。defaultStratum()を使う場合はnull。
      sourceName - 特定のソース・ファイル内の位置だけを取得する場合はそのファイル名、そうでない場合はnull。
      戻り値:
      すべてのソース行のLocationオブジェクトのリスト。
      例外:
      AbsentInformationException - このクラスに対する行番号情報がなく、かつこのクラスの実行可能メンバーとして非nativeで非abstractなものが含まれる場合。 またはsourceNameがnullでないのにソース名情報が存在しない場合。
      ClassNotPreparedException - このクラスがまだ準備されていない場合。
      導入されたバージョン:
      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 - このクラスに対する行番号情報がない場合。
      ClassNotPreparedException - このクラスがまだ準備されていない場合。
      関連項目:

    • locationsOfLine

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

      配列(ArrayType)およびプリミティブ・クラスの場合、常に空のリストが返されます。 インタフェース(InterfaceType)の場合、返されるリストが空にならないのは、そのインタフェースのクラス初期化時、指定の行番号に実行可能コードが含まれている場合だけです。 指定された行番号の位置に実行可能コードが存在しない場合は、空のリストが返されます。

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

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

    • availableStrata

      List<String> availableStrata()
      この参照型で利用可能な層を返します。

      層については、Locationを参照してください。

      戻り値:
      層を表すjava.lang.StringのList
      導入されたバージョン:
      1.4

    • defaultStratum

      String defaultStratum()
      この参照型のデフォルト層を返します。 これはクラス・ファイル内で指定され、ユーザーが変更することはできません。 クラス・ファイルにデフォルト層が指定されていない場合は、基底層("Java")が返されます。

      層については、Locationを参照してください。

      導入されたバージョン:
      1.4

    • instances

      List<ObjectReference> instances(long maxInstances)
      このReferenceTypeのインスタンスを返します。 ガベージ・コレクト目的で到達可能なインスタンスだけが返されます。

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

      パラメータ:
      maxInstances - 返されるインスタンスの最大数。 負でない数値。 ゼロの場合、すべてのインスタンスが返される。
      戻り値:
      ObjectReferenceオブジェクトのリスト。 このReferenceTypeのインスタンスが存在しない場合は、長さゼロのリストを返す。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合(次を参照)。canGetInstanceInfo()
      IllegalArgumentException - maxInstancesがゼロ未満の場合。
      導入されたバージョン:
      1.6
      関連項目:

    • equals

      boolean equals(Object obj)
      指定されたObjectとこのReferenceTypeが等しいかどうかを比較します。
      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - 比較対象の参照オブジェクト。
      戻り値:
      ObjectがReferenceTypeである場合、両方のReferenceTypeが同じVMに属している場合、およびそのVMのjava.lang.Classの同じインスタンスに対応するクラスがReferenceTypeによってミラー化されている場合はtrue。
      関連項目:

    • hashCode

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

    • majorVersion

      int majorVersion()
      「Java仮想マシン仕様」のクラス・ファイル形式の説明に定義されているように、クラスのメジャー・バージョン番号を返します。 配列(ArrayType)およびプリミティブ・クラスの場合、返されるメジャー・バージョン番号はゼロです。 この操作は、ターゲット仮想マシンでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canGetClassFileVersion()を使用します。
      戻り値:
      クラスのメジャー・バージョン番号。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合(次を参照)。canGetClassFileVersion()
      導入されたバージョン:
      1.6

    • minorVersion

      int minorVersion()
      「Java仮想マシン仕様」のクラス・ファイル形式の説明に定義されているように、クラスのマイナー・バージョン番号を返します。 配列(ArrayType)およびプリミティブ・クラスの場合、返されるマイナー・バージョン番号はゼロです。 この操作は、ターゲット仮想マシンでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canGetClassFileVersion()を使用します。
      戻り値:
      クラスのマイナー・バージョン番号。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合(次を参照)。canGetClassFileVersion()
      導入されたバージョン:
      1.6

    • constantPoolCount

      int constantPoolCount()
      定数プール内のエントリ数に1を加えた値を返します。 これは、「Java仮想マシン仕様」のクラス・ファイル形式の説明に記載されている、constant_pool_count項目と一致します。 配列(ArrayType)およびプリミティブ・クラスの場合、返される定数プール数の値はゼロです。 この操作は、ターゲット仮想マシンでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canGetConstantPool()を使用します。
      戻り値:
      クラスの定数プール・エントリ数に1を加えた合計の値。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合(次を参照)。canGetConstantPool()
      導入されたバージョン:
      1.6
      関連項目:

    • constantPool

      byte[] constantPool()
      「Java仮想マシン仕様」のクラス・ファイル形式の説明に記載されているconstant_pool項目の形式で、定数プールのrawバイト数を返します。 定数プールの形式は、クラス・ファイル形式のバージョンによって異なる可能性があるので、クラスのメジャー・バージョン番号、マイナー・バージョン番号に互換性があることを確認するようにしてください。 配列(ArrayType)およびプリミティブ・クラスの場合、長さがゼロのバイト配列が返されます。 この操作は、ターゲット仮想マシンでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canGetConstantPool()を使用します。
      戻り値:
      定数プールのrawバイト数。
      例外:
      UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合(次を参照)。canGetConstantPool()
      導入されたバージョン:
      1.6
      関連項目: