compact3

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 - 永続ストアが見つからない場合、またはアクセスできない場合