java.lang.management
クラス MemoryNotificationInfo

java.lang.Object
  java.lang.management.MemoryNotificationInfo

public class MemoryNotificationInfo
extends Object

メモリ通知に関する情報です。

メモリプールのメモリ使用量がしきい値を超えていることを Java 仮想マシンが検出すると、MemoryMXBean によりメモリ通知が発行されます。発行された通知には、検出された条件に関する以下のメモリ通知情報が含まれています。

• メモリプールの名前
• 通知が構築されたときのメモリプールのメモリ使用量
• 通知が構築されたときに、メモリ使用量がしきい値を超えた回数。使用量しきい値通知の場合、このカウントは、使用量しきい値カウントになる。コレクションしきい値通知の場合、このカウントは、コレクション使用量しきい値カウントになる

MemoryNotificationInfo オブジェクトを表す CompositeData は、通知のユーザデータに格納されます。from メソッドは、CompositeData から MemoryNotificationInfo オブジェクトへの変換を行います。以下に例を示します。

 Notification notif;
 // receive the notification emitted by MemoryMXBean and set to notif ...             String notifType = notif.getType(); if (notifType.equals(MemoryNotificationInfo.MEMORY_THRESHOLD_EXCEEDED) || notifType.equals(MemoryNotificationInfo.MEMORY_COLLECTION_THRESHOLD_EXCEEDED)) { // retrieve the memory notification information CompositeData cd = (CompositeData) notif.getUserData(); MemoryNotificationInfo info = MemoryNotificationInfo.from(cd); .... }   

MemoryMXBean が発行する通知の型は以下のとおりです。

• 使用量しきい値超過通知
  この通知は、メモリプールのメモリ使用量が増加し、使用量しきい値に達したか超えたときに発行される。それ以降に使用量しきい値を超えても、メモリ使用量が使用量しきい値未満に戻るまで、通知は発行されない

• コレクション使用量しきい値超過通知
  Java 仮想マシンがメモリプールで使用しないオブジェクトのリサイクルに最善を尽くしたあと、メモリプールのメモリ使用量がコレクション使用量しきい値以上であるときに発行される

導入されたバージョン:

1.5

フィールドの概要

static String	MEMORY_COLLECTION_THRESHOLD_EXCEEDED Java 仮想マシンがメモリプールで使用しないオブジェクトのリサイクルに最善を尽くしたあと、メモリプールのメモリ使用量がコレクション使用量しきい値以上であることを表す通知の型です。
static String	MEMORY_THRESHOLD_EXCEEDED メモリプールのメモリ使用量が使用量しきい値に達したか超えたことを表す通知の型。

コンストラクタの概要

MemoryNotificationInfo(String poolName, MemoryUsage usage, long count)
MemoryNotificationInfo オブジェクトを構築します。

メソッドの概要

static MemoryNotificationInfo	from(CompositeData cd) 指定された CompositeData によって表される MemoryNotificationInfo オブジェクトを返します。
long	getCount() 通知が構築されたときに、メモリ使用量がしきい値を超えた回数を返します。
String	getPoolName() この通知をトリガするメモリプールの名前を返します。
MemoryUsage	getUsage() 通知が構築されたときのメモリプールのメモリ使用量を返します。

クラス java.lang.Object から継承されたメソッド

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

フィールドの詳細

MEMORY_THRESHOLD_EXCEEDED

public static final String MEMORY_THRESHOLD_EXCEEDED

メモリプールのメモリ使用量が使用量しきい値に達したか超えたことを表す通知の型。この通知は、MemoryMXBean により発行されます。以降、使用量しきい値を超えても、メモリ使用量が使用量しきい値未満に戻るまで、通知は発行されません。この通知の型の値は java.management.memory.threshold.exceeded です。

関連項目:

定数フィールド値

MEMORY_COLLECTION_THRESHOLD_EXCEEDED

public static final String MEMORY_COLLECTION_THRESHOLD_EXCEEDED

Java 仮想マシンがメモリプールで使用しないオブジェクトのリサイクルに最善を尽くしたあと、メモリプールのメモリ使用量がコレクション使用量しきい値以上であることを表す通知の型です。この通知は、MemoryMXBean により発行されます。この通知の型の値は、java.management.memory.collection.threshold.exceeded です。

関連項目:

定数フィールド値

コンストラクタの詳細

MemoryNotificationInfo

public MemoryNotificationInfo(String poolName,
                              MemoryUsage usage,
                              long count)

MemoryNotificationInfo オブジェクトを構築します。

パラメータ:

poolName - この通知をトリガするメモリプールの名前

usage - メモリプールのメモリ使用量

count - しきい値超過回数

メソッドの詳細

getPoolName

public String getPoolName()

この通知をトリガするメモリプールの名前を返します。メモリプールの使用量はしきい値を超えました。

戻り値:

この通知をトリガするメモリプールの名前

getUsage

public MemoryUsage getUsage()

通知が構築されたときのメモリプールのメモリ使用量を返します。

戻り値:

通知が構築されたときのメモリプールのメモリ使用量

getCount

public long getCount()

通知が構築されたときに、メモリ使用量がしきい値を超えた回数を返します。使用量しきい値通知の場合、このカウントは、しきい値カウントです。コレクションしきい値通知の場合、このカウントは、コレクション使用量しきい値カウントです。

戻り値:

通知が構築されたときにメモリ使用量がしきい値を超えた回数

from

public static MemoryNotificationInfo from(CompositeData cd)

指定された CompositeData によって表される MemoryNotificationInfo オブジェクトを返します。指定された CompositeData は、次の属性を含む必要があります。

属性名	型
poolName	java.lang.String
usage	javax.management.openmbean.CompositeData
count	java.lang.Long

パラメータ:

cd - MemoryNotificationInfo を表す CompositeData

戻り値:

cd が null でない場合は、cd により表される MemoryNotificationInfo オブジェクト。そうでない場合は null

例外:

IllegalArgumentException - cd が MemoryNotificationInfo オブジェクトを表さない場合