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

クラスGcInfo

java.lang.Object
com.sun.management.GcInfo
すべての実装されたインタフェース:
CompositeData, CompositeDataView
public class GcInfo extends Object implements CompositeData, CompositeDataView
ガベージ・コレクション情報。 この情報には、GC固有の属性と1つのガベージ・コレクションに関する次の情報が含まれています。
  • 開始時間
  • 終了時間
  • Duration
  • コレクションが始まる前のメモリー使用状況
  • コレクションが終了したあとのメモリー使用状況

GcInfoはCompositeDataです。GC固有の属性は、CompositeDataインタフェースを使って取得できます。 これは過去の名残りであり、他のクラスはこのパターンをコピーできません。 かわりにCompositeDataViewを使用してください。

MXBeanのマッピング

GcInfoは、fromメソッドで指定された属性を持つCompositeDataにマップされます。
導入されたバージョン:
1.5

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    containsKey​(String key)
    このCompositeDataインスタンスにkeyという名前の項目が含まれる場合に限り、trueを返します。
    boolean
    containsValue​(Object value)
    このCompositeDataインスタンスにvalueという値の項目が含まれる場合に限り、trueを返します。
    boolean
    equals​(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    static GcInfo
    from​(CompositeData cd)
    指定されたCompositeDataにより表されたGcInfoオブジェクトを返します。
    Object
    get​(String key)
    keyという名前の項目の値を返します。
    Object[]
    getAll​(String[] keys)
    keysによって、keysと同じ順番で名前を指定された項目の値から成る配列を返します。
    CompositeType
    getCompositeType()
    この複合データ・インスタンスの複合型を返します。
    long
    getDuration()
    このGCの経過時間をミリ秒単位で返します。
    long
    getEndTime()
    Java仮想マシンが起動してからのGCの終了時間をミリ秒単位で返します。
    long
    getId()
    このコレクタが実行したコレクション数のこのガベージ・コレクションの識別子を返します。
    Map<String,​MemoryUsage>
    getMemoryUsageAfterGc()
    このGCが終了した時点の全メモリー・プールのメモリー使用状況を返します。
    Map<String,​MemoryUsage>
    getMemoryUsageBeforeGc()
    このGCが開始された時点の全メモリー・プールのメモリー使用状況を返します。
    long
    getStartTime()
    Java仮想マシンが起動してからのGCの開始時間をミリ秒単位で返します。
    int
    hashCode()
    オブジェクトのハッシュ・コード値を返します。
    CompositeData
    toCompositeData​(CompositeType ct)
    GC固有の属性を含む、このGcInfoのCompositeData表現を返します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    Collection<?>
    values()
    このCompositeDataインスタンスに含まれる項目値の変更不能なCollectionビューを返します。

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • メソッドの詳細

    • getId

      public long getId()
      このコレクタが実行したコレクション数のこのガベージ・コレクションの識別子を返します。
      戻り値:
      ガベージ・コレクションの識別子(このコレクタが実行したコレクションの数)。

    • getStartTime

      public long getStartTime()
      Java仮想マシンが起動してからのGCの開始時間をミリ秒単位で返します。
      戻り値:
      GCの開始時間。

    • getEndTime

      public long getEndTime()
      Java仮想マシンが起動してからのGCの終了時間をミリ秒単位で返します。
      戻り値:
      GCの終了時間。

    • getDuration

      public long getDuration()
      このGCの経過時間をミリ秒単位で返します。
      戻り値:
      GCのミリ秒単位の経過時間。

    • getMemoryUsageBeforeGc

      public Map<String,​MemoryUsage> getMemoryUsageBeforeGc()
      このGCが開始された時点の全メモリー・プールのメモリー使用状況を返します。 このメソッドは、対応するメモリー・プールのGC開始前のメモリー使用状況に対する、メモリー・プールの名前のMapを返します。
      戻り値:
      メモリー・プールのGC開始前のメモリー使用状況に対する、メモリー・プールの名前のMap。

    • getMemoryUsageAfterGc

      public Map<String,​MemoryUsage> getMemoryUsageAfterGc()
      このGCが終了した時点の全メモリー・プールのメモリー使用状況を返します。 このメソッドは、対応するメモリー・プールのGC終了時点のメモリー使用状況に対する、メモリー・プールの名前のMapを返します。
      戻り値:
      メモリー・プールのGC終了時点のメモリー使用状況に対する、メモリー・プールの名前のMap。

    • from

      public static GcInfo from​(CompositeData cd)
      指定されたCompositeDataにより表されたGcInfoオブジェクトを返します。 指定されたCompositeDataは、次のすべての属性を含む必要があります。
      description
      属性名 型
      index java.lang.Long
      startTime java.lang.Long
      endTime java.lang.Long
      memoryUsageBeforeGc javax.management.openmbean.TabularData
      memoryUsageAfterGc javax.management.openmbean.TabularData
      戻り値:
      cdがnullでない場合はcdにより表されるGcInfoオブジェクト、そうでない場合はnull。
      例外:
      IllegalArgumentException - cdが上記属性を含むGcInfoオブジェクトを表さない場合。

    • containsKey

      public boolean containsKey​(String key)
      インタフェースからコピーされた説明:CompositeData
      このCompositeDataインスタンスにkeyという名前の項目が含まれる場合に限り、trueを返します。 keyがnullまたは空のStringの場合、このメソッドはfalseを返します。
      定義:
      containsKey 、インタフェース: CompositeData
      パラメータ:
      key - 判定されるキー。
      戻り値:
      このCompositeDataにキーが含まれる場合はtrue。

    • containsValue

      public boolean containsValue​(Object value)
      インタフェースからコピーされた説明:CompositeData
      このCompositeDataインスタンスにvalueという値の項目が含まれる場合に限り、trueを返します。
      定義:
      containsValue 、インタフェース: CompositeData
      パラメータ:
      value - 判定される値。
      戻り値:
      このCompositeDataに値が含まれる場合はtrue。

    • equals

      public boolean equals​(Object obj)
      次のクラスからコピーされた説明: Object
      このオブジェクトと他のオブジェクトが等しいかどうかを示します。

      equalsメソッドは、null以外のオブジェクト参照での同値関係を実装します。

      • 反射性(reflexive): null以外の参照値xについて、x.equals(x)はtrueを返します。
      • 対称性(symmetric): null以外の参照値xおよびyについて、y.equals(x)がtrueを返す場合に限り、x.equals(y)はtrueを返します。
      • 推移性(transitive): null以外の参照値x、y、およびzについて、x.equals(y)がtrueを返し、y.equals(z)がtrueを返す場合、x.equals(z)はtrueを返します。
      • 一貫性(consistent): null以外の参照値xおよびyについて、x.equals(y)の複数の呼出しは、このオブジェクトに対するequalsによる比較で使われた情報が変更されていなければ、一貫してtrueを返すか、一貫してfalseを返します。
      • null以外の参照値xについて、x.equals(null)はfalseを返します。

      Objectクラスのequalsメソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値xとyについて、このメソッドはxとyが同じオブジェクトを参照する(x == yがtrue)場合にだけtrueを返します。

      通常、このメソッドをオーバーライドする場合は、hashCodeメソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュ・コードを保持する必要がある」というhashCodeメソッドの汎用規約に従う必要があることに留意してください。

      定義:
      equals 、インタフェース: CompositeData
      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      obj - 比較対象の参照オブジェクト。
      戻り値:
      このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。
      関連項目:
      Object.hashCode()、HashMap

    • get

      public Object get​(String key)
      インタフェースからコピーされた説明:CompositeData
      keyという名前の項目の値を返します。
      定義:
      get 、インタフェース: CompositeData
      パラメータ:
      key - 項目の名前。
      戻り値:
      このキーに関連した値。

    • getAll

      public Object[] getAll​(String[] keys)
      インタフェースからコピーされた説明:CompositeData
      keysによって、keysと同じ順番で名前を指定された項目の値から成る配列を返します。
      定義:
      getAll 、インタフェース: CompositeData
      パラメータ:
      keys - 項目の名前。
      戻り値:
      キーに対応する値。

    • getCompositeType

      public CompositeType getCompositeType()
      インタフェースからコピーされた説明:CompositeData
      この複合データ・インスタンスの複合型を返します。
      定義:
      getCompositeType 、インタフェース: CompositeData
      戻り値:
      このCompositeDataの型。

    • hashCode

      public int hashCode()
      次のクラスからコピーされた説明: Object
      オブジェクトのハッシュ・コード値を返します。 このメソッドは、HashMapによって提供されるハッシュ表などの、ハッシュ表の利点のためにサポートされています。

      hashCodeの一般的な規則は次のとおりです。

      • Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対するequalsの比較で使用される情報が変更されていなければ、hashCodeメソッドは常に同じ整数を返す必要があります。 ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
      • equals(Object)メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって同じ整数の結果が生成される必要があります。
      • Object.equals(java.lang.Object)メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって異なる整数の結果が生成される必要はありません。 ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ表のパフォーマンスが向上する可能性があることに注意するようにしてください。

      定義:
      hashCode 、インタフェース: CompositeData
      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このオブジェクトのハッシュ・コード値。
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

    • toString

      public String toString()
      次のクラスからコピーされた説明: Object
      オブジェクトの文字列表現を返します。 一般に、toStringメソッドは、このオブジェクトを「テキストで表す」文字列を返します。 この結果は、人間が読める簡潔で有益な情報であるべきです。 すべてのサブクラスで、このメソッドをオーバーライドすることをお勧めします。

      クラスObjectのtoStringメソッドは、オブジェクトがインスタンスになっている元のクラスの名前、アットマーク文字「@」、およびオブジェクトのハッシュ・コードの符号なし16進数表現から構成される文字列を返します。 つまり、このメソッドは次の値と等しい文字列を返します。 

       getClass().getName() + '@' + Integer.toHexString(hashCode())

      定義:
      toString 、インタフェース: CompositeData
      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      このオブジェクトの文字列表現

    • values

      public Collection<?> values()
      インタフェースからコピーされた説明:CompositeData
      このCompositeDataインスタンスに含まれる項目値の変更不能なCollectionビューを返します。 返されたコレクションのイテレータは、対応する項目名の値をアルファベットの昇順で返します。
      定義:
      values 、インタフェース: CompositeData
      戻り値:
      値

    • toCompositeData

      public CompositeData toCompositeData​(CompositeType ct)
      GC固有の属性を含む、このGcInfoのCompositeData表現を返します。 戻り値には、少なくともfromメソッドに記述されたすべての属性と、任意でその他の属性が含まれます。
      定義:
      toCompositeData 、インタフェース: CompositeDataView
      パラメータ:
      ct - 呼出し側が予想するCompositeType。 このパラメータは無視される。nullにすることができる。
      戻り値:
      CompositeData表現。