/*
* @(#)file PersistentMBean.java
* @(#)author IBM Corp.
* @(#)version 1.22
* @(#)lastedit 05/11/17
*
*
* Copyright IBM Corp. 1999-2000. All rights reserved.
*
* The program is provided "as is" without any warranty express or implied,
* including the warranty of non-infringement and the implied warranties of
* merchantibility and fitness for a particular purpose. IBM will not be
* liable for any damages suffered by you or any third party claim against
* you regarding the Program.
*
* Copyright 2006 Sun Microsystems, Inc. All rights reserved.
* This software is the proprietary information of Sun Microsystems, Inc.
* Use is subject to license terms.
*
* Copyright 2006 Sun Microsystems, Inc. Tous droits reserves.
* Ce logiciel est propriete de Sun Microsystems, Inc.
* Distribue par des licences qui en restreignent l'utilisation.
*
*/
package javax.management;
import javax.management.MBeanException;
import javax.management.RuntimeOperationsException;
import javax.management.InstanceNotFoundException;
/**
* This class is the interface to be implemented by MBeans that are meant to be
* persistent. MBeans supporting this interface should call the load method during
* construction in order to prime the MBean from the persistent store.
* In the case of a ModelMBean, the store method should be called by the MBeanServer based on the descriptors in
* the ModelMBean or by the MBean itself during normal processing of the ModelMBean.
*
* @since 1.5
*/
public interface PersistentMBean {
/**
* Instantiates thisMBean instance with the data found for
* the MBean in the persistent store. The data loaded could include
* attribute and operation values.
*
* This method should be called during construction or initialization of this instance,
* and before the MBean is registered with the MBeanServer.
*
* @exception MBeanException Wraps another exception or persistence is not supported
* @exception RuntimeOperationsException Wraps exceptions from the persistence mechanism
* @exception InstanceNotFoundException Could not find or load this MBean from persistent
* storage
*/
public void load()
throws MBeanException, RuntimeOperationsException, InstanceNotFoundException;
/**
* Captures the current state of this MBean instance and
* writes it out to the persistent store. The state stored could include
* attribute and operation values. If one of these methods of persistence is
* not supported a "serviceNotFound" exception will be thrown.
* <P>
* Persistence policy from the MBean and attribute descriptor is used to guide execution
* of this method. The MBean should be stored if 'persistPolicy' field is:
* <PRE> != "never"
* = "always"
* = "onTimer" and now > 'lastPersistTime' + 'persistPeriod'
* = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod'
* = "onUnregister"
* <P>
* Do not store the MBean if 'persistPolicy' field is:
* = "never"
* = "onUpdate"
* = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
* <P></PRE>
*
* @exception MBeanException Wraps another exception or persistence is not supported
* @exception RuntimeOperationsException Wraps exceptions from the persistence mechanism
* @exception InstanceNotFoundException Could not find/access the persistent store
*/
public void store()
throws MBeanException, RuntimeOperationsException, InstanceNotFoundException;
}