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 インスタンスの現在の状態を取り込み、永続ストアに書き出します。

メソッドの詳細

ロード

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"
 

 Do not store the MBean if 'persistPolicy' field is:
    = "never"
    = "onUpdate"
    = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
 

例外:

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

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

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