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