JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。