JavaTM 2 Platform
Standard Ed. 5.0

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 が発行する通知の型は以下のとおりです。

導入されたバージョン:
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
戻り値:
cdnull でない場合は、cd により表される MemoryNotificationInfo オブジェクト。そうでない場合は null
例外:
IllegalArgumentException - cdMemoryNotificationInfo オブジェクトを表さない場合

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。