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