jdk/src/share/classes/javax/management/namespace/JMXNamespaceMBean.java
changeset 4159 9e3aae7675f1
parent 4158 0b4d21bc8b5c
parent 4156 acaa49a2768a
child 4160 bda0a85afcb7
--- a/jdk/src/share/classes/javax/management/namespace/JMXNamespaceMBean.java	Wed Oct 21 15:47:09 2009 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,96 +0,0 @@
-/*
- * Copyright 2008 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.
- */
-
-package javax.management.namespace;
-
-import java.io.IOException;
-import java.util.UUID;
-
-/**
- * A {@link JMXNamespace} is an MBean that handles a name space in the
- * MBeanServer hierarchical name space.
- * @see JMXNamespace
- * @since 1.7
- */
-public interface JMXNamespaceMBean {
-
-    // Note: since getDomains(), getDefaultDomain(), and getMBeanCount()
-    // don't take any ObjectName parameters, the only efficient way
-    // to get these data is to call the corresponding method on the
-    // JMXNamespaceMBean that handles the name space.
-    //
-    // We need these methods to implement 'cd' (JMXNamespaces.narrowToNamespace)
-    // correctly.
-    //
-
-    /**
-     * Returns the list of domains currently implemented in the name space
-     * handled by this {@link JMXNamespace}.
-     * @throws IOException if the domain list cannot be obtained due to
-     *         I/O problems (communication failures etc...).
-     * @return the list of domains currently implemented in the name space
-     * handled by this {@link JMXNamespace}.
-     * @see javax.management.MBeanServerConnection#getDomains
-     *      MBeanServerConnection.getDomains
-     **/
-    public String[] getDomains() throws IOException;
-
-    /**
-     * Returns the default domain for the name space handled by
-     * this {@link JMXNamespace}.
-     * @throws IOException if the default domain cannot be obtained due to
-     *         I/O problems (communication failures etc...).
-     * @return the default domain for the name space handled by
-     * this {@link JMXNamespace}.
-     * @see javax.management.MBeanServerConnection#getDefaultDomain
-     *      MBeanServerConnection.getDefaultDomain
-     **/
-    public String   getDefaultDomain() throws IOException;
-
-    /**
-     * Returns the number of MBeans registered in the  name space handled by
-     *         this  {@link JMXNamespace}.
-     *
-     * @return the number of MBeans registered in the  name space handled by
-     *         this  {@link JMXNamespace}.
-     *
-     * @throws IOException if the MBean count cannot be obtained due to
-     *         I/O problems (communication failures etc...).
-     * @see javax.management.MBeanServerConnection#getMBeanCount
-     *      MBeanServerConnection.getMBeanCount
-     */
-    public Integer  getMBeanCount() throws IOException;
-
-    /**
-     * Returns a {@link java.util.UUID UUID string} which uniquely identifies
-     * this {@linkplain JMXNamespace} MBean.
-     * This information can be used to detect loops in the JMX name space graph.
-     * @return A unique ID identifying this MBean.
-     * @throws IOException if the MBean UUID cannot be obtained due to
-     *         I/O problems (communication failures etc...).
-     */
-    public String getUUID() throws IOException;
-
-}