/* * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. *//* * @author    IBM Corp. * * Copyright IBM Corp. 1999-2000.  All rights reserved. */ 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; }