StandardMBeanDelegate


1   /*
2   * JBoss, Home of Professional Open Source
3   * Copyright 2005, JBoss Inc., and individual contributors as indicated
4   * by the @authors tag. See the copyright.txt in the distribution for a
5   * full listing of individual contributors.
6   *
7   * This is free software; you can redistribute it and/or modify it
8   * under the terms of the GNU Lesser General Public License as
9   * published by the Free Software Foundation; either version 2.1 of
10  * the License, or (at your option) any later version.
11  *
12  * This software is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this software; if not, write to the Free
19  * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20  * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21  */
22  package org.jboss.mx.standardmbean;
23  
24  import javax.management.DynamicMBean  ;
25  import javax.management.MBeanInfo  ;
26  import javax.management.NotCompliantMBeanException  ;
27  
28  /**
29   * A delegate standard mbean.
30   *
31   * @author <a HREF="mailto:adrian@jboss.com">Adrian Brock</a>
32   * @version $Revision: 37459 $
33   */
34  public interface StandardMBeanDelegate extends DynamicMBean  
35  {
36     /**
37      * Retrieve the implementation object
38      *
39      * @return the implementation
40      */
41     Object   getImplementation();
42  
43     /**
44      * Replace the implementation object
45      *
46      * @param implementation the new implementation
47      * @exception IllegalArgumentException for a null parameter
48      * @exception NotCompliantMBeanException if the new implementation
49      *            does not implement the interface supplied at
50      *            construction
51      */
52     void setImplementation(Object   implementation) throws NotCompliantMBeanException  ;
53  
54     /**
55      * Retrieve the management interface
56      *
57      * @return the management interface
58      */
59     Class   getMBeanInterface();
60  
61     /**
62      * Retrieve the cached mbean info
63      *
64      * @return the cached mbean info
65      */
66     MBeanInfo   getCachedMBeanInfo();
67  
68     /**
69      * Sets the cached mbean info
70      *
71      * @todo make this work after the mbean is registered
72      * @param info the mbeaninfo to cache, can be null to erase the cache
73      */
74     void cacheMBeanInfo(MBeanInfo   info);
75  
76     /**
77      * Builds a default MBeanInfo for this MBean, using the Management Interface specified for this MBean.
78      * 
79      * @return the default mbean info
80      * @throws NotCompliantMBeanException when the mbean is not a standardmbean
81      */
82     MBeanInfo   buildMBeanInfo() throws NotCompliantMBeanException  ;
83  }
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags