--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/share/classes/javax/management/PersistentMBean.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,92 @@
+/*
+ * Portions Copyright 2000-2005 Sun Microsystems, Inc.  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.  Sun designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.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;
+
+}