モジュール 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つのガベージ・コレクションに関する次の情報が含まれています。

• 開始時間
• 終了時間
• 期間
• コレクションが始まる前のメモリー使用状況
• コレクションが終了したあとのメモリー使用状況

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)	指定されたobjパラメータとこのCompositeDataインスタンスが等しいかどうかを比較します。
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インスタンスのハッシュ・コード値を返します。
CompositeData	toCompositeData(CompositeType ct)	GC固有の属性を含む、このGcInfoのCompositeData表現を返します。
String	toString()	このCompositeDataインスタンスの文字列表現を返します。
Collection<?>	values()	このCompositeDataインスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。

クラス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が開始された時点の全メモリー・プールのメモリー使用状況を返します。 このメソッドは、メモリー・プールの名前のMapを、GC開始前の対応するメモリー・プールのメモリー使用量に返します。

戻り値:

GC起動前のメモリー・プールのメモリー使用量に対するメモリー・プール名のMap。

getMemoryUsageAfterGc

public Map<String,MemoryUsage> getMemoryUsageAfterGc()

このGCが終了した時点の全メモリー・プールのメモリー使用状況を返します。 このメソッドは、メモリー・プールの名前のMapを、GCの終了時に対応するメモリー・プールのメモリー使用量に返します。

戻り値:

GC終了時のメモリー・プールのメモリー使用量に対するメモリー・プール名のMap。

from

public static GcInfo from(CompositeData cd)

指定されたCompositeDataで表されるGcInfoオブジェクトを返します。 指定されたCompositeDataには、次のすべての属性が含まれている必要があります:

description

属性名	型
索引	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または空の文字列の場合、このメソッドは単に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)

インタフェース: CompositeDataからコピーされた説明

指定されたobjパラメータとこのCompositeDataインスタンスが等しいかどうかを比較します。

次のすべての条件が満たされている場合に限り、trueを返します。

• objがnullでない
• objがCompositeDataインタフェースも実装している
• 複合型が等しい
• 内容、すなわち名前と値のペアが等しい。 内容に含まれる値が配列である場合、オブジェクト参照型の配列に対してdeepEqualsメソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.equals(e1,e2)の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます

これにより、このequalsメソッドは、CompositeDataインタフェースの異なる実装であるobjパラメータに対して正しく機能し、java.util.Collectionインタフェースのequalsメソッドに示されている制限があります。

定義:

equals、インタフェースCompositeData

オーバーライド:

equals、クラスObject

パラメータ:

obj - このCompositeDataインスタンスと等しいかどうかを比較するオブジェクト

戻り値:

指定されたオブジェクトがこのCompositeDataインスタンスと等しい場合はtrue

関連項目:

• 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()

インタフェース: CompositeDataからコピーされた説明

このCompositeDataインスタンスのハッシュ・コード値を返します。

CompositeDataインスタンスのハッシュ・コードは、equalsの比較で使用されるすべての情報要素(複合型およびすべての項目値)のハッシュ・コードの合計です。

これにより、Object.hashCode()メソッドの一般規約によって要求される、任意の2つのCompositeDataインスタンスt1とt2で、t1.equals(t2)であればt1.hashCode()==t2.hashCode()となることが保証されます。

各項目値のハッシュ・コードは、返されたハッシュ・コードに追加されます。 項目値が配列である場合、オブジェクト参照型の配列に対してdeepHashCodeメソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.hashCode(e)の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。

定義:

hashCode、インタフェースCompositeData

オーバーライド:

hashCode、クラスObject

戻り値:

このCompositeDataインスタンスのハッシュ・コード値

関連項目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

toString

public String toString()

インタフェース: CompositeDataからコピーされた説明

このCompositeDataインスタンスの文字列表現を返します。

この文字列表現は、実装クラスの名前、このインタフェースの複合型の文字列表現、および内容(itemName=itemValueのマッピングのリスト)の文字列表現で構成されます。

定義:

toString、インタフェースCompositeData

オーバーライド:

toString、クラスObject

戻り値:

このCompositeDataインスタンスの文字列表現

values

public Collection<?> values()

インタフェース: CompositeDataからコピーされた説明

このCompositeDataインスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。 返されたコレクションのイテレータは、対応する項目名の値をアルファベットの昇順で返します。

定義:

values、インタフェースCompositeData

戻り値:

値

toCompositeData

public CompositeData toCompositeData(CompositeType ct)

GC固有の属性を含む、このGcInfoのCompositeData表現を返します。 戻り値には、少なくともfromメソッドに記述されたすべての属性と、任意でその他の属性が含まれます。

定義:

toCompositeData、インタフェースCompositeDataView

パラメータ:

ct - 呼出し側が予想するCompositeType。 このパラメータは無視される。nullにすることができる。

戻り値:

CompositeData表現。