モジュール java.management

パッケージ javax.management

インタフェースPersistentMBean

既知のすべてのサブインタフェース:

ModelMBean

既知のすべての実装クラス:

RequiredModelMBean

public interface PersistentMBean

このクラスは、MBeanによって実装されるインタフェース(永続インタフェース)です。 永続ストアからMBeanを準備するため、このインタフェースをサポートするMBeanは、構築時にロード・メソッドを呼び出します。 ModelMBeanの場合、ModelMBeanの通常処理時にMBean自体によって、またはModelMBean内の記述子に従うMBeanServerによってストア・メソッドを呼び出す必要があります。

導入されたバージョン:

1.5

メソッドのサマリー

修飾子と型	メソッド	説明
void	load()	thisMBeanインスタンスを永続ストア内のMBean用データでインスタンス化します。
void	store()	このMBeanインスタンスの現在の状態を取り込み、永続ストアに書き出します。

メソッドの詳細

load

void load() throws MBeanException, RuntimeOperationsException, InstanceNotFoundException

thisMBeanインスタンスを永続ストア内のMBean用データでインスタンス化します。 データとして、属性とオペレーションの値をロードできます。 このメソッドは、このインスタンスの構築または初期化時、MBeanをMBeanServerに登録する前に呼び出します。

例外:

MBeanException - その他の例外をラップする場合、または永続性がサポートされない場合

RuntimeOperationsException - 永続メカニズムからの例外をラップする場合

InstanceNotFoundException - このMBeanが見つからない場合、または永続ストレージからロードできない場合

store

void store() throws MBeanException, RuntimeOperationsException, InstanceNotFoundException

このMBeanインスタンスの現在の状態を取り込み、永続ストアに書き出します。 属性やオペレーションの値が、状態として格納される場合もあります。 永続メソッドのいずれかがサポートされない場合、serviceNotFound例外がスローされます。

MBeanの永続性ポリシーおよび属性記述子を使って、このメソッドの実行を制御します。 persistPolicyフィールドが次の内容になっている場合、MBeanは格納されます。

 != "never"
   = "always"
   = "onTimer" and now > 'lastPersistTime' + 'persistPeriod'
   = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod'
   = "onUnregister"
 

persistPolicyフィールドが次の内容になっている場合、MBeanは格納されません。

    = "never"
    = "onUpdate"
    = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
 

例外:

MBeanException - その他の例外をラップする場合、または永続性がサポートされない場合

RuntimeOperationsException - 永続メカニズムからの例外をラップする場合

InstanceNotFoundException - 永続ストアが見つからない場合、またはアクセスできない場合