The Tomcat 5 Servlet/JSP Container - MBean Descriptor How To

Links Docs Home User Guide 1) Introduction 2) Setup 3) First webapp 4) Deployer 5) Manager 6) Realms and AAA 7) Security Manager 8) JNDI Resources 9) JDBC DataSources 10) Classloading 11) JSPs 12) SSL 13) SSI 14) CGI 15) Proxy Support 16) MBean Descriptor 17) Default Servlet 18) Clustering 19) Balancer Reference Release Notes Tomcat Configuration JK Documentation Servlet API Javadocs JSP API Javadocs Tomcat Development Building Changelog Status Developers Functional Specs. Tomcat Javadocs Jasper Javadocs |
# The Tomcat 5 Servlet/JSP Container ## MBean Descriptor How To | print-friendly version
Introduction
Tomcat 5 uses JMX MBeans as the technology for implementing manageability of Tomcat. The descriptions of JMX MBeans for Catalina are in the org.apache.catalina.mbeans.mbeans-descriptor.xml file. You will need to add MBean descriptions for your custom components in order to avoid a "ManagedBean is not found" exception.
Including your own mbean-descriptor files
> You may configure custom components (e.g. Valves/Realms) by including your own mbean-descriptor file(s), and setting the "descriptors" attribute to point to a ';' separated list of paths (in the ClassLoader sense) of files to add to the default list under ServerLifecycleListener definition in server.xml.
>     <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"
>               debug="0"
>               descriptors="/com/myfirm/mypackage/mbean-descriptor.xml"/>
Adding MBean description to Catalina's mbean-descriptors.xml
> You may also add MBean descriptions for custom components in org.apache.catalina.mbeans.mbeans-descriptor.xml file.
>       <mbean         name="LDAPRealm"
>                 className="org.apache.catalina.mbeans.ClassNameMBean"
>               description="Custom LDAPRealm"
>                    domain="Catalina"
>                     group="Realm"
>                      type="com.myfirm.mypackage.LDAPRealm">

>         <attribute   name="className"
>               description="Fully qualified class name of the managed object"
>                      type="java.lang.String"
>                 writeable="false"/>

>         <attribute   name="debug"
>               description="The debugging detail level for this component"
>                      type="int"/>
>         .
>         .
>         .

>       </mbean>
Copyright © 1999-2003, Apache Software Foundation