1. /*

  2.  * @(#)SunJmxMBeanServer.java	1.28 03/12/19

  3.  * 

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package com.sun.jmx.mbeanserver;

  9. 

  10. import javax.management.MBeanServer;

  11. import javax.management.MBeanServerDelegate;

  12. 

  13. import com.sun.jmx.interceptor.MBeanServerInterceptor;

  14. 

  15. /**

  16.  * Extends the MBeanServer and MBeanServerInterceptor interface to 

  17.  * provide methods for getting the MetaData and MBeanServerInstantiator 

  18.  * objects associated with an MBeanServer.

  19.  *

  20.  * @since 1.5

  21.  * @since.unbundled JMX RI 1.2

  22.  */

  23. public interface SunJmxMBeanServer 

  24.     extends MBeanServerInterceptor, MBeanServer {

  25. 

  26.     /**

  27.      * Return the MBeanInstantiator associated to this MBeanServer.

  28.      * @exception UnsupportedOperationException if 

  29.      *            {@link MBeanServerInterceptor}s

  30.      *            are not enabled on this object.

  31.      * @see #interceptorsEnabled

  32.      */

  33.     public MBeanInstantiator getMBeanInstantiator();

  34. 

  35. 

  36.     /**

  37.      * Return the MetaData associated to this MBeanServer.

  38.      */

  39.     public MetaData getMetaData();

  40. 

  41.     /**

  42.      * Tell whether {@link MBeanServerInterceptor}s are enabled on this

  43.      * object.

  44.      * @return <code>true</code> if {@link MBeanServerInterceptor}s are

  45.      *         enabled.

  46.      * @see #getMBeanServerInterceptor

  47.      * @see #setMBeanServerInterceptor

  48.      * @see #getMBeanInstantiator

  49.      * @see com.sun.jmx.mbeanserver.JmxMBeanServerBuilder

  50.      **/

  51.     public boolean interceptorsEnabled();

  52. 

  53.     /**

  54.      * Return the MBeanServerInterceptor.

  55.      * @exception UnsupportedOperationException if 

  56.      *            {@link MBeanServerInterceptor}s

  57.      *            are not enabled on this object.

  58.      * @see #interceptorsEnabled

  59.      **/

  60.     public MBeanServerInterceptor getMBeanServerInterceptor();

  61. 

  62.     /**

  63.      * Set the MBeanServerInterceptor.

  64.      * @exception UnsupportedOperationException if 

  65.      *            {@link MBeanServerInterceptor}s

  66.      *            are not enabled on this object.

  67.      * @see #interceptorsEnabled

  68.      **/

  69.     public void setMBeanServerInterceptor(MBeanServerInterceptor interceptor);

  70. 

  71.     /**

  72.      * <p>Return the MBeanServerDelegate representing the MBeanServer.

  73.      * Notifications can be sent from the MBean server delegate using

  74.      * the method {@link MBeanServerDelegate#sendNotification}

  75.      * in the returned object.</p>

  76.      *

  77.      * @since.unbundled JMX RI 1.2

  78.      */

  79.     public MBeanServerDelegate getMBeanServerDelegate();

  80. 

  81. }