| 1 | <html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Catalina Functional Specifications - Tomcat MBean Names</title><meta value="Craig McClanahan" name="author"><meta value="craigmcc@apache.org" name="email"><meta value="Amy Roh" name="author"><meta value="amyroh@apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="0" width="100%" border="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img border="0" alt=" | 
|---|
| 2 |       Catalina Functional Specifications | 
|---|
| 3 |     " align="right" src="../../../images/tomcat.gif"></a></td><td><font face="arial,helvetica,sanserif"><h1>Apache Tomcat 6.0</h1></font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img border="0" alt="Apache Logo" align="right" src="../../../images/asf-logo.gif"></a></td></tr></table><table cellspacing="4" width="100%" border="0"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table cellspacing="4" width="100%" border="0"><tr><td valign="top" align="left"><h1>Catalina Functional Specifications</h1><h2>Tomcat MBean Names</h2></td><td nowrap="true" valign="top" align="right"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../../images/void.gif"></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Background"><strong>Background</strong></a></font></td></tr><tr><td><blockquote> | 
|---|
| 4 |  | 
|---|
| 5 |     <p>We will be using <em>JMX MBeans</em> as the technology for | 
|---|
| 6 |     implementing manageability of Tomcat.</p> | 
|---|
| 7 |  | 
|---|
| 8 |     <p>One of the key concepts of JMX (and JSR-77) is that each management | 
|---|
| 9 |     bean has a unique name in the MBeanServer's registry, and that | 
|---|
| 10 |     management applications can utilize these names to retrieve the MBean | 
|---|
| 11 |     of interest to them for a particular management operation. | 
|---|
| 12 |     This document proposes a naming convention for MBeans that allows easy | 
|---|
| 13 |     calculation of the name for a particular MBean.  For background | 
|---|
| 14 |     information on JMX MBean names, see the <em>Java Management Extensions | 
|---|
| 15 |     Instrumentation and Agent Specification</em>, version 1.0, section 6. | 
|---|
| 16 |     In particular, we will be discussing the String Representation of | 
|---|
| 17 |     <code>ObjectName</code> instances.</p> | 
|---|
| 18 |  | 
|---|
| 19 | </blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Catalina Object Hierarchy"><strong>Catalina Object Hierarchy</strong></a></font></td></tr><tr><td><blockquote> | 
|---|
| 20 |  | 
|---|
| 21 | <p>Tomcat's servlet container implementation, called Catalina, can be | 
|---|
| 22 | represented as a hierarchy of objects that contain references to each other. | 
|---|
| 23 | The object hierarchy can be represented as a tree, or (isomorphically) based | 
|---|
| 24 | on the nesting of configuration elements in the <code>conf/server.xml</code> | 
|---|
| 25 | file that is traditionally used to configure Tomcat stand-alone.</p> | 
|---|
| 26 |  | 
|---|
| 27 | <p>The valid component nestings for Catalina are depicted in the following | 
|---|
| 28 | table, with columns that contain the following values:</p> | 
|---|
| 29 | <ul> | 
|---|
| 30 | <li><em>Pattern</em> - Nesting pattern of XML elements (in the | 
|---|
| 31 |     <code>conf/server.xml</code> file) used to configure this component.</li> | 
|---|
| 32 | <li><em>Cardinality</em> - Minimum and maximum number of occurrences of | 
|---|
| 33 |     this element at this nesting position, which also corresponds to the | 
|---|
| 34 |     minimum and maximum number of Catalina components.</li> | 
|---|
| 35 | <li><em>Identifier</em> - Name of the JavaBeans property of this component | 
|---|
| 36 |     that represents the unique identifier (within the nested hierarchy), | 
|---|
| 37 |     if any.</li> | 
|---|
| 38 | <li><em>MBean ObjectName</em> - The portion of the MBean object name that | 
|---|
| 39 |     appears <strong>after</strong> the domain name.  For now, it should be | 
|---|
| 40 |     assumed that all of these MBeans appear in the default JMX domain.</li> | 
|---|
| 41 | </ul> | 
|---|
| 42 |  | 
|---|
| 43 | <p>In the <em>MBean ObjectName</em> descriptions, several types of symbolic | 
|---|
| 44 | expressions are utilized to define variable text that is replaced by | 
|---|
| 45 | corresponding values:</p> | 
|---|
| 46 | <ul> | 
|---|
| 47 | <li><em>${GROUP}</em> - One of the standard MBean names of the specified | 
|---|
| 48 |     "group" category.  For example, the expression <code>${REALM}</code> | 
|---|
| 49 |     represents the values like <code>JDBCRealm</code> and <code>JAASRealm</code> | 
|---|
| 50 |     that identify the various MBeans for possible <code>Realm</code> components.</li> | 
|---|
| 51 | <li><em>${name}</em> - Replaced by the value of property <code>name</code> | 
|---|
| 52 |     from the current component.</li> | 
|---|
| 53 | <li><em>${parent.name}</em> - Replaced by the value of property | 
|---|
| 54 |     <code>name</code> from a parent of the current component, with the | 
|---|
| 55 |     parent's type identified by <em>parent</em>.</li> | 
|---|
| 56 | <li><em>${###}</em> - An arbitrary numeric identifier that preserves | 
|---|
| 57 |     order but has no other particular meaning.  In general, the server will | 
|---|
| 58 |     assign numeric values to existing instances with large gaps into which | 
|---|
| 59 |     new items can be configured if desired.</li> | 
|---|
| 60 | </ul> | 
|---|
| 61 |  | 
|---|
| 62 | <table border="1" cellpadding="5"> | 
|---|
| 63 |  | 
|---|
| 64 |   <tr> | 
|---|
| 65 |     <th align="center" bgcolor="aqua">Pattern</th> | 
|---|
| 66 |     <th align="center" bgcolor="aqua">Cardinality</th> | 
|---|
| 67 |     <th align="center" bgcolor="aqua">Identifier</th> | 
|---|
| 68 |     <th align="center" bgcolor="aqua">MBean ObjectName</th> | 
|---|
| 69 |   </tr> | 
|---|
| 70 |  | 
|---|
| 71 |   <tr> | 
|---|
| 72 |     <td>Server</td> | 
|---|
| 73 |     <td align="center">1..1</td> | 
|---|
| 74 |     <td align="center">(none)</td> | 
|---|
| 75 |     <td><code>type=${SERVER}</code></td> | 
|---|
| 76 |   </tr> | 
|---|
| 77 |  | 
|---|
| 78 |   <tr> | 
|---|
| 79 |     <td>Server / Listener</td> | 
|---|
| 80 |     <td align="center">0..n</td> | 
|---|
| 81 |     <td align="center">(none)</td> | 
|---|
| 82 |     <td><code>type=${LISTENER}, sequence=${###}</code></td> | 
|---|
| 83 |   </tr> | 
|---|
| 84 |  | 
|---|
| 85 |   <tr> | 
|---|
| 86 |     <td>Server / Service</td> | 
|---|
| 87 |     <td align="center">1..n</td> | 
|---|
| 88 |     <td align="center"><code>name</code></td> | 
|---|
| 89 |     <td><code>type=${SERVICE}, name=${name}</code></td> | 
|---|
| 90 |   </tr> | 
|---|
| 91 |  | 
|---|
| 92 |   <tr> | 
|---|
| 93 |     <td>Server / Service / Connector</td> | 
|---|
| 94 |     <td align="center">1..n</td> | 
|---|
| 95 |     <td align="center"><code>address, port</code></td> | 
|---|
| 96 |     <td><code>type=${CONNECTOR}, service=${service}, port=${port}, | 
|---|
| 97 |         address=${address}</code></td> | 
|---|
| 98 |   </tr> | 
|---|
| 99 |  | 
|---|
| 100 |   <tr> | 
|---|
| 101 |     <td>Server / Service / Connector / Factory</td> | 
|---|
| 102 |     <td align="center">0..1</td> | 
|---|
| 103 |     <td align="center">(none)</td> | 
|---|
| 104 |     <td>(Only defined explicitly for an SSL connector, but can be treated | 
|---|
| 105 |         as part of the connector component)</td> | 
|---|
| 106 |   </tr> | 
|---|
| 107 |  | 
|---|
| 108 |   <tr> | 
|---|
| 109 |     <td>Server / Service / Connector / Listener</td> | 
|---|
| 110 |     <td align="center">0..n</td> | 
|---|
| 111 |     <td align="center">(none)</td> | 
|---|
| 112 |     <td><code>type=${LISTENER}, sequence=${###}, service=${service}, | 
|---|
| 113 |         port=${connector.port}, address=${connector.address}</code></td> | 
|---|
| 114 |   </tr> | 
|---|
| 115 |  | 
|---|
| 116 |   <tr> | 
|---|
| 117 |     <td>Server / Service / Engine</td> | 
|---|
| 118 |     <td align="center">1..1</td> | 
|---|
| 119 |     <td align="center">(none)</td> | 
|---|
| 120 |     <td><code>type=${ENGINE}, service=${service.name}</code></td> | 
|---|
| 121 |   </tr> | 
|---|
| 122 |  | 
|---|
| 123 |   <tr> | 
|---|
| 124 |     <td>Server / Service / Engine / Host</td> | 
|---|
| 125 |     <td align="center">1..n</td> | 
|---|
| 126 |     <td align="center"><code>name</code></td> | 
|---|
| 127 |     <td><code>type=${HOST}, host=${name}, | 
|---|
| 128 |         service=${service.name}</code></td> | 
|---|
| 129 |   </tr> | 
|---|
| 130 |  | 
|---|
| 131 |   <tr> | 
|---|
| 132 |     <td>Server / Service / Engine / Host / Context</td> | 
|---|
| 133 |     <td align="center">1..n</td> | 
|---|
| 134 |     <td align="center"><code>path</code></td> | 
|---|
| 135 |     <td><code>type=${CONTEXT}, path=${path}, host=${host.name}, | 
|---|
| 136 |         service=${service.name}</code></td> | 
|---|
| 137 |   </tr> | 
|---|
| 138 |  | 
|---|
| 139 |   <tr> | 
|---|
| 140 |     <td>Server / Service / Engine / Host / Context / InstanceListener</td> | 
|---|
| 141 |     <td align="center">0..n</td> | 
|---|
| 142 |     <td align="center">(none)</td> | 
|---|
| 143 |     <td><code>type=${INSTANCE-LISTENER}, sequence=${###}, path=${context.path}, | 
|---|
| 144 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 145 |   </tr> | 
|---|
| 146 |  | 
|---|
| 147 |   <tr> | 
|---|
| 148 |     <td>Server / Service / Engine / Host / Context / Listener</td> | 
|---|
| 149 |     <td align="center">0..n</td> | 
|---|
| 150 |     <td align="center">(none)</td> | 
|---|
| 151 |     <td><code>type=${LISTENER}, sequence=${###}, path=${context.path}, | 
|---|
| 152 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 153 |   </tr> | 
|---|
| 154 |  | 
|---|
| 155 |   <tr> | 
|---|
| 156 |     <td>Server / Service / Engine / Host / Context / Loader</td> | 
|---|
| 157 |     <td align="center">0..1</td> | 
|---|
| 158 |     <td align="center">(none)</td> | 
|---|
| 159 |     <td><code>type=${LOADER}, path=${context.path}, host=${host.name}, | 
|---|
| 160 |         service=${service.name}</code></td> | 
|---|
| 161 |   </tr> | 
|---|
| 162 |  | 
|---|
| 163 |   <tr> | 
|---|
| 164 |     <td>Server / Service / Engine / Host / Context / Manager</td> | 
|---|
| 165 |     <td align="center">0..1</td> | 
|---|
| 166 |     <td align="center">(none)</td> | 
|---|
| 167 |     <td><code>type=${MANAGER}, path=${context.path}, host=${host.name}, | 
|---|
| 168 |         service=${service.name}</code></td> | 
|---|
| 169 |   </tr> | 
|---|
| 170 |  | 
|---|
| 171 |   <tr> | 
|---|
| 172 |     <td>Server / Service / Engine / Host / Context / Realm</td> | 
|---|
| 173 |     <td align="center">0..1</td> | 
|---|
| 174 |     <td align="center">(none)</td> | 
|---|
| 175 |     <td><code>type=${REALM}, path=${context.path}, host=${host.name}, | 
|---|
| 176 |         service=${service.name}</code></td> | 
|---|
| 177 |   </tr> | 
|---|
| 178 |  | 
|---|
| 179 |   <tr> | 
|---|
| 180 |     <td>Server / Service / Engine / Host / Context / Resources</td> | 
|---|
| 181 |     <td align="center">0..1</td> | 
|---|
| 182 |     <td align="center">(none)</td> | 
|---|
| 183 |     <td><code>type=${RESOURCES}, path=${context.path}, host=${host.name}, | 
|---|
| 184 |         service=${service.name}</code></td> | 
|---|
| 185 |   </tr> | 
|---|
| 186 |  | 
|---|
| 187 |   <tr> | 
|---|
| 188 |     <td>Server / Service / Engine / Host / Context / Valve</td> | 
|---|
| 189 |     <td align="center">0..n</td> | 
|---|
| 190 |     <td align="center">(none)</td> | 
|---|
| 191 |     <td><code>type=${VALVE}, sequence=${###}, path=${context.path}, | 
|---|
| 192 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 193 |   </tr> | 
|---|
| 194 |  | 
|---|
| 195 |   <tr> | 
|---|
| 196 |     <td>Server / Service / Engine / Host / Context / Wrapper</td> | 
|---|
| 197 |     <td align="center">0..n</td> | 
|---|
| 198 |     <td align="center">(none)</td> | 
|---|
| 199 |     <td><code>j2eeType=Servlet,name=${name}, | 
|---|
| 200 |         WebModule=//${host.name}/${context.name}, | 
|---|
| 201 |         J2EEApplication=${context.J2EEApplication}, | 
|---|
| 202 |         J2EEServer=${context.J2EEServer}</code></td> | 
|---|
| 203 |   </tr> | 
|---|
| 204 |  | 
|---|
| 205 |   <tr> | 
|---|
| 206 |     <td>Server / Service / Engine / Host / Context / WrapperLifecycle</td> | 
|---|
| 207 |     <td align="center">0..n</td> | 
|---|
| 208 |     <td align="center">(none)</td> | 
|---|
| 209 |     <td><code>type=${WRAPPER-LIFECYCLE}, sequence=${###}, path=${context.path}, | 
|---|
| 210 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 211 |   </tr> | 
|---|
| 212 |  | 
|---|
| 213 |   <tr> | 
|---|
| 214 |     <td>Server / Service / Engine / Host / Context / WrapperListener</td> | 
|---|
| 215 |     <td align="center">0..n</td> | 
|---|
| 216 |     <td align="center">(none)</td> | 
|---|
| 217 |     <td><code>type=${WRAPPER-LISTENER}, sequence=${###}, path=${context.path}, | 
|---|
| 218 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 219 |   </tr> | 
|---|
| 220 |  | 
|---|
| 221 |   <tr> | 
|---|
| 222 |     <td>Server / Service / Engine / Host / Listener</td> | 
|---|
| 223 |     <td align="center">0..n</td> | 
|---|
| 224 |     <td align="center">(none)</td> | 
|---|
| 225 |     <td><code>type=${LISTENER}, sequence=${###}, host=${host.name}, | 
|---|
| 226 |         service=${service.name}</code></td> | 
|---|
| 227 |   </tr> | 
|---|
| 228 |  | 
|---|
| 229 |   <tr> | 
|---|
| 230 |     <td>Server / Service / Engine / Host / Realm</td> | 
|---|
| 231 |     <td align="center">0..1</td> | 
|---|
| 232 |     <td align="center">(none)</td> | 
|---|
| 233 |     <td><code>type=${REALM}, host=${host.name}, | 
|---|
| 234 |         service=${service.name}</code></td> | 
|---|
| 235 |   </tr> | 
|---|
| 236 |  | 
|---|
| 237 |   <tr> | 
|---|
| 238 |     <td>Server / Service / Engine / Host / Valve</td> | 
|---|
| 239 |     <td align="center">0..n</td> | 
|---|
| 240 |     <td align="center">(none)</td> | 
|---|
| 241 |     <td><code>type=${VALVE}, sequence=${###}, | 
|---|
| 242 |         host=${host.name}, service=${service.name}</code></td> | 
|---|
| 243 |   </tr> | 
|---|
| 244 |  | 
|---|
| 245 |   <tr> | 
|---|
| 246 |     <td>Server / Service / Engine / Listener</td> | 
|---|
| 247 |     <td align="center">0..n</td> | 
|---|
| 248 |     <td align="center">(none)</td> | 
|---|
| 249 |     <td><code>type=${LISTENER}, sequence=${###}</code> | 
|---|
| 250 |         (<strong>FIXME</strong> - disambiguate from Server / Service / | 
|---|
| 251 |         Listener)</td> | 
|---|
| 252 |   </tr> | 
|---|
| 253 |  | 
|---|
| 254 |   <tr> | 
|---|
| 255 |     <td>Server / Service / Engine / Realm</td> | 
|---|
| 256 |     <td align="center">0..1</td> | 
|---|
| 257 |     <td align="center">(none)</td> | 
|---|
| 258 |     <td><code>type=${REALM}, service=${service.name}</code></td> | 
|---|
| 259 |   </tr> | 
|---|
| 260 |  | 
|---|
| 261 |   <tr> | 
|---|
| 262 |     <td>Server / Service / Engine / Valve</td> | 
|---|
| 263 |     <td align="center">0..n</td> | 
|---|
| 264 |     <td align="center">(none)</td> | 
|---|
| 265 |     <td><code>type=${VALVE}, sequence=${###}, | 
|---|
| 266 |         service=${service.name}</code></td> | 
|---|
| 267 |   </tr> | 
|---|
| 268 |  | 
|---|
| 269 |   <tr> | 
|---|
| 270 |     <td>Server / Service / Listener</td> | 
|---|
| 271 |     <td align="center">0..n</td> | 
|---|
| 272 |     <td align="center">(none)</td> | 
|---|
| 273 |     <td><code>type=${LISTENER}, sequence=${###}</code> | 
|---|
| 274 |         (<strong>FIXME</strong> - disambiguate from Server / Service / | 
|---|
| 275 |         Engine / Listener)</td> | 
|---|
| 276 |   </tr> | 
|---|
| 277 |  | 
|---|
| 278 | </table> | 
|---|
| 279 |  | 
|---|
| 280 | </blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="MBean Groups and Names"><strong>MBean Groups and Names</strong></a></font></td></tr><tr><td><blockquote> | 
|---|
| 281 |  | 
|---|
| 282 | <p>The following MBean names shall be defined in the resource file | 
|---|
| 283 | <code>/org/apache/catalina/mbeans/mbeans-descriptors.xml</code> (and | 
|---|
| 284 | therefore available for use within the Administration/Configuration | 
|---|
| 285 | web application for Tomcat):</p> | 
|---|
| 286 |  | 
|---|
| 287 | <table border="1" cellpadding="5"> | 
|---|
| 288 |  | 
|---|
| 289 |   <tr> | 
|---|
| 290 |     <th align="center" bgcolor="aqua">MBean Name</th> | 
|---|
| 291 |     <th align="center" bgcolor="aqua">Group Name</th> | 
|---|
| 292 |     <th align="center" bgcolor="aqua">Catalina Interface</th> | 
|---|
| 293 |     <th align="center" bgcolor="aqua">Implementation Class</th> | 
|---|
| 294 |   </tr> | 
|---|
| 295 |  | 
|---|
| 296 |   <tr> | 
|---|
| 297 |     <td><code>AccessLogValve</code></td> | 
|---|
| 298 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 299 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 300 |     <td><code>org.apache.catalina.valves.AccessLogValve</code></td> | 
|---|
| 301 |   </tr> | 
|---|
| 302 |  | 
|---|
| 303 |   <tr> | 
|---|
| 304 |     <td><code>BasicAuthenticator</code></td> | 
|---|
| 305 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 306 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 307 |     <td><code>org.apache.catalina.authenticator.BasicAuthenticator</code></td> | 
|---|
| 308 |   </tr> | 
|---|
| 309 |  | 
|---|
| 310 |   <tr> | 
|---|
| 311 |     <td><code>CertificatesValve</code></td> | 
|---|
| 312 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 313 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 314 |     <td><code>org.apache.catalina.valves.CertificatesValve</code></td> | 
|---|
| 315 |   </tr> | 
|---|
| 316 |  | 
|---|
| 317 |   <tr> | 
|---|
| 318 |     <td><code>ContextConfig</code></td> | 
|---|
| 319 |     <td align="center"><code>LISTENER</code></td> | 
|---|
| 320 |     <td><code>org.apache.catalina.LifecycleListener</code></td> | 
|---|
| 321 |     <td><code>org.apache.catalina.startup.ContextConfig</code></td> | 
|---|
| 322 |   </tr> | 
|---|
| 323 |  | 
|---|
| 324 |   <tr> | 
|---|
| 325 |     <td><code>ContextEnvironment</code></td> | 
|---|
| 326 |     <td align="center"><code>RESOURCES</code></td> | 
|---|
| 327 |     <td><code>org.apache.catalina.deploy.ContextEnvironment</code></td> | 
|---|
| 328 |     <td><code>org.apache.catalina.deploy.ContextEnvironment</code></td> | 
|---|
| 329 |   </tr> | 
|---|
| 330 |  | 
|---|
| 331 |   <tr> | 
|---|
| 332 |     <td><code>ContextResource</code></td> | 
|---|
| 333 |     <td align="center"><code>RESOURCES</code></td> | 
|---|
| 334 |     <td><code>org.apache.catalina.deploy.ContextResource</code></td> | 
|---|
| 335 |     <td><code>org.apache.catalina.deploy.ContextResource</code></td> | 
|---|
| 336 |   </tr> | 
|---|
| 337 |  | 
|---|
| 338 |   <tr> | 
|---|
| 339 |     <td><code>ContextResourceLink</code></td> | 
|---|
| 340 |     <td align="center"><code>RESOURCES</code></td> | 
|---|
| 341 |     <td><code>org.apache.catalina.deploy.ContextResourceLink</code></td> | 
|---|
| 342 |     <td><code>org.apache.catalina.deploy.ContextResourceLink</code></td> | 
|---|
| 343 |   </tr> | 
|---|
| 344 |  | 
|---|
| 345 |   <tr> | 
|---|
| 346 |     <td><code>CoyoteConnector</code></td> | 
|---|
| 347 |     <td align="center"><code>CONNECTOR</code></td> | 
|---|
| 348 |     <td><code>org.apache.catalina.Connector</code></td> | 
|---|
| 349 |     <td><code>org.apache.coyote.tomcat4.CoyoteConnector</code></td> | 
|---|
| 350 |   </tr> | 
|---|
| 351 |  | 
|---|
| 352 |   <tr> | 
|---|
| 353 |     <td><code>DigestAuthenticator</code></td> | 
|---|
| 354 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 355 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 356 |     <td><code>org.apache.catalina.authenticator.DigestAuthenticator</code></td> | 
|---|
| 357 |   </tr> | 
|---|
| 358 |  | 
|---|
| 359 |   <tr> | 
|---|
| 360 |     <td><code>EngineConfig</code></td> | 
|---|
| 361 |     <td align="center"><code>LISTENER</code></td> | 
|---|
| 362 |     <td><code>org.apache.catalina.LifecycleListener</code></td> | 
|---|
| 363 |     <td><code>org.apache.catalina.startup.EngineConfig</code></td> | 
|---|
| 364 |   </tr> | 
|---|
| 365 |  | 
|---|
| 366 |   <tr> | 
|---|
| 367 |     <td><code>ErrorReportValve</code></td> | 
|---|
| 368 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 369 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 370 |     <td><code>org.apache.catalina.valves.ErrorReportValve</code></td> | 
|---|
| 371 |   </tr> | 
|---|
| 372 |  | 
|---|
| 373 |   <tr> | 
|---|
| 374 |     <td><code>ErrorDispatcherValve</code></td> | 
|---|
| 375 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 376 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 377 |     <td><code>org.apache.catalina.valves.ErrorDispatcherValve</code></td> | 
|---|
| 378 |   </tr> | 
|---|
| 379 |  | 
|---|
| 380 |   <tr> | 
|---|
| 381 |     <td><code>FormAuthenticator</code></td> | 
|---|
| 382 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 383 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 384 |     <td><code>org.apache.catalina.authenticator.FormAuthenticator</code></td> | 
|---|
| 385 |   </tr> | 
|---|
| 386 |  | 
|---|
| 387 |   <tr> | 
|---|
| 388 |     <td><code>Group</code></td> | 
|---|
| 389 |     <td align="center"><code>GROUP</code></td> | 
|---|
| 390 |     <td><code>org.apache.catalina.Group</code></td> | 
|---|
| 391 |     <td><code>org.apache.catalina.Group</code></td> | 
|---|
| 392 |   </tr> | 
|---|
| 393 |  | 
|---|
| 394 |   <tr> | 
|---|
| 395 |     <td><code>HostConfig</code></td> | 
|---|
| 396 |     <td align="center"><code>LISTENER</code></td> | 
|---|
| 397 |     <td><code>org.apache.catalina.LifecycleListener</code></td> | 
|---|
| 398 |     <td><code>org.apache.catalina.startup.HostConfig</code></td> | 
|---|
| 399 |   </tr> | 
|---|
| 400 |  | 
|---|
| 401 |   <tr> | 
|---|
| 402 |     <td><code>HttpConnector10</code></td> | 
|---|
| 403 |     <td align="center"><code>CONNECTOR</code></td> | 
|---|
| 404 |     <td><code>org.apache.catalina.Connector</code></td> | 
|---|
| 405 |     <td><code>org.apache.catalina.connector.http10.HttpConnector</code></td> | 
|---|
| 406 |   </tr> | 
|---|
| 407 |  | 
|---|
| 408 |   <tr> | 
|---|
| 409 |     <td><code>HttpConnector11</code></td> | 
|---|
| 410 |     <td align="center"><code>CONNECTOR</code></td> | 
|---|
| 411 |     <td><code>org.apache.catalina.Connector</code></td> | 
|---|
| 412 |     <td><code>org.apache.catalina.connector.http.HttpConnector</code></td> | 
|---|
| 413 |   </tr> | 
|---|
| 414 |  | 
|---|
| 415 |   <tr> | 
|---|
| 416 |     <td><code>JAASRealm</code></td> | 
|---|
| 417 |     <td align="center"><code>REALM</code></td> | 
|---|
| 418 |     <td><code>org.apache.catalina.Realm</code></td> | 
|---|
| 419 |     <td><code>org.apache.catalina.realm.JAASRealm</code></td> | 
|---|
| 420 |   </tr> | 
|---|
| 421 |  | 
|---|
| 422 |   <tr> | 
|---|
| 423 |     <td><code>JDBCRealm</code></td> | 
|---|
| 424 |     <td align="center"><code>REALM</code></td> | 
|---|
| 425 |     <td><code>org.apache.catalina.Realm</code></td> | 
|---|
| 426 |     <td><code>org.apache.catalina.realm.JDBCRealm</code></td> | 
|---|
| 427 |   </tr> | 
|---|
| 428 |  | 
|---|
| 429 |   <tr> | 
|---|
| 430 |     <td><code>JDBCUserDatabase</code></td> | 
|---|
| 431 |     <td align="center"><code>USERDATABASE</code></td> | 
|---|
| 432 |     <td><code>org.apache.catalina.users.JDBCUserDatabase</code></td> | 
|---|
| 433 |     <td><code>org.apache.catalina.users.JDBCUserDatabase</code></td> | 
|---|
| 434 |   </tr> | 
|---|
| 435 |  | 
|---|
| 436 |   <tr> | 
|---|
| 437 |     <td><code>JNDIRealm</code></td> | 
|---|
| 438 |     <td align="center"><code>REALM</code></td> | 
|---|
| 439 |     <td><code>org.apache.catalina.Realm</code></td> | 
|---|
| 440 |     <td><code>org.apache.catalina.realm.JNDIRealm</code></td> | 
|---|
| 441 |   </tr> | 
|---|
| 442 |  | 
|---|
| 443 |   <tr> | 
|---|
| 444 |     <td><code>MBeanFactory</code></td> | 
|---|
| 445 |     <td align="center"><code></code></td> | 
|---|
| 446 |     <td><code></code></td> | 
|---|
| 447 |     <td><code>org.apache.catalina.mbeans.MBeanFactory</code></td> | 
|---|
| 448 |   </tr> | 
|---|
| 449 |  | 
|---|
| 450 |   <tr> | 
|---|
| 451 |     <td><code>MemoryRealm</code></td> | 
|---|
| 452 |     <td align="center"><code>REALM</code></td> | 
|---|
| 453 |     <td><code>org.apache.catalina.Realm</code></td> | 
|---|
| 454 |     <td><code>org.apache.catalina.realm.MemoryRealm</code></td> | 
|---|
| 455 |   </tr> | 
|---|
| 456 |  | 
|---|
| 457 |   <tr> | 
|---|
| 458 |     <td><code>MemoryUserDatabase</code></td> | 
|---|
| 459 |     <td align="center"><code>USERDATABASE</code></td> | 
|---|
| 460 |     <td><code>org.apache.catalina.users.MemoryUserDatabase</code></td> | 
|---|
| 461 |     <td><code>org.apache.catalina.users.MemoryUserDatabase</code></td> | 
|---|
| 462 |   </tr> | 
|---|
| 463 |  | 
|---|
| 464 |   <tr> | 
|---|
| 465 |     <td><code>NamingContextListener</code></td> | 
|---|
| 466 |     <td align="center"><code>LISTENER</code></td> | 
|---|
| 467 |     <td><code>org.apache.catalina.LifecycleListener</code></td> | 
|---|
| 468 |     <td><code>org.apache.catalina.core.NamingContextListener</code></td> | 
|---|
| 469 |   </tr> | 
|---|
| 470 |  | 
|---|
| 471 |   <tr> | 
|---|
| 472 |     <td><code>NamingResources</code></td> | 
|---|
| 473 |     <td align="center"><code>RESOURCES</code></td> | 
|---|
| 474 |     <td><code>org.apache.catalina.deploy.NamingResources</code></td> | 
|---|
| 475 |     <td><code>org.apache.catalina.deploy.NamingResources</code></td> | 
|---|
| 476 |   </tr> | 
|---|
| 477 |  | 
|---|
| 478 |   <tr> | 
|---|
| 479 |     <td><code>NonLoginAuthenticator</code></td> | 
|---|
| 480 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 481 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 482 |     <td><code>org.apache.catalina.authenticator.NonLoginAuthenticator</code></td> | 
|---|
| 483 |   </tr> | 
|---|
| 484 |  | 
|---|
| 485 |   <tr> | 
|---|
| 486 |     <td><code>PersistentManager</code></td> | 
|---|
| 487 |     <td align="center"><code>MANAGER</code></td> | 
|---|
| 488 |     <td><code>org.apache.catalina.Manager</code></td> | 
|---|
| 489 |     <td><code>org.apache.catalina.session.PersistentManager</code></td> | 
|---|
| 490 |   </tr> | 
|---|
| 491 |  | 
|---|
| 492 |   <tr> | 
|---|
| 493 |     <td><code>RemoteAddrValve</code></td> | 
|---|
| 494 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 495 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 496 |     <td><code>org.apache.catalina.valves.RemoteAddrValve</code></td> | 
|---|
| 497 |   </tr> | 
|---|
| 498 |  | 
|---|
| 499 |   <tr> | 
|---|
| 500 |     <td><code>RemoteHostValve</code></td> | 
|---|
| 501 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 502 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 503 |     <td><code>org.apache.catalina.valves.RemoteHostValve</code></td> | 
|---|
| 504 |   </tr> | 
|---|
| 505 |  | 
|---|
| 506 |   <tr> | 
|---|
| 507 |     <td><code>RequestDumperValve</code></td> | 
|---|
| 508 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 509 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 510 |     <td><code>org.apache.catalina.valves.RequestDumperValve</code></td> | 
|---|
| 511 |   </tr> | 
|---|
| 512 |  | 
|---|
| 513 |   <tr> | 
|---|
| 514 |     <td><code>Role</code></td> | 
|---|
| 515 |     <td align="center"><code>ROLE</code></td> | 
|---|
| 516 |     <td><code>org.apache.catalina.Role</code></td> | 
|---|
| 517 |     <td><code>org.apache.catalina.Role</code></td> | 
|---|
| 518 |   </tr> | 
|---|
| 519 |  | 
|---|
| 520 |   <tr> | 
|---|
| 521 |     <td><code>SingleSignOn</code></td> | 
|---|
| 522 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 523 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 524 |     <td><code>org.apache.catalina.valves.SingleSignOn</code></td> | 
|---|
| 525 |   </tr> | 
|---|
| 526 |  | 
|---|
| 527 |   <tr> | 
|---|
| 528 |     <td><code>SSLAuthenticator</code></td> | 
|---|
| 529 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 530 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 531 |     <td><code>org.apache.catalina.authenticator.SSLAuthenticator</code></td> | 
|---|
| 532 |   </tr> | 
|---|
| 533 |  | 
|---|
| 534 |   <tr> | 
|---|
| 535 |     <td><code>StandardContext</code></td> | 
|---|
| 536 |     <td align="center"><code>CONTEXT</code></td> | 
|---|
| 537 |     <td><code>org.apache.catalina.Context</code></td> | 
|---|
| 538 |     <td><code>org.apache.catalina.core.StandardContext</code></td> | 
|---|
| 539 |   </tr> | 
|---|
| 540 |  | 
|---|
| 541 |   <tr> | 
|---|
| 542 |     <td><code>StandardContextValve</code></td> | 
|---|
| 543 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 544 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 545 |     <td><code>org.apache.catalina.core.StandardContextValve</code></td> | 
|---|
| 546 |   </tr> | 
|---|
| 547 |  | 
|---|
| 548 |   <tr> | 
|---|
| 549 |     <td><code>StandardEngine</code></td> | 
|---|
| 550 |     <td align="center"><code>ENGINE</code></td> | 
|---|
| 551 |     <td><code>org.apache.catalina.Engine</code></td> | 
|---|
| 552 |     <td><code>org.apache.catalina.core.StandardEngine</code></td> | 
|---|
| 553 |   </tr> | 
|---|
| 554 |  | 
|---|
| 555 |   <tr> | 
|---|
| 556 |     <td><code>StandardEngineValve</code></td> | 
|---|
| 557 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 558 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 559 |     <td><code>org.apache.catalina.core.StandardEngineValve</code></td> | 
|---|
| 560 |   </tr> | 
|---|
| 561 |  | 
|---|
| 562 |   <tr> | 
|---|
| 563 |     <td><code>StandardHost</code></td> | 
|---|
| 564 |     <td align="center"><code>HOST</code></td> | 
|---|
| 565 |     <td><code>org.apache.catalina.Host</code></td> | 
|---|
| 566 |     <td><code>org.apache.catalina.core.StandardHost</code></td> | 
|---|
| 567 |   </tr> | 
|---|
| 568 |  | 
|---|
| 569 |   <tr> | 
|---|
| 570 |     <td><code>StandardHostValve</code></td> | 
|---|
| 571 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 572 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 573 |     <td><code>org.apache.catalina.core.StandardHostValve</code></td> | 
|---|
| 574 |   </tr> | 
|---|
| 575 |  | 
|---|
| 576 |   <tr> | 
|---|
| 577 |     <td><code>StandardManager</code></td> | 
|---|
| 578 |     <td align="center"><code>MANAGER</code></td> | 
|---|
| 579 |     <td><code>org.apache.catalina.Manager</code></td> | 
|---|
| 580 |     <td><code>org.apache.catalina.session.StandardManager</code></td> | 
|---|
| 581 |   </tr> | 
|---|
| 582 |  | 
|---|
| 583 |   <tr> | 
|---|
| 584 |     <td><code>StandardServer</code></td> | 
|---|
| 585 |     <td align="center"><code>SERVER</code></td> | 
|---|
| 586 |     <td><code>org.apache.catalina.Server</code></td> | 
|---|
| 587 |     <td><code>org.apache.catalina.core.StandardServer</code></td> | 
|---|
| 588 |   </tr> | 
|---|
| 589 |  | 
|---|
| 590 |   <tr> | 
|---|
| 591 |     <td><code>StandardService</code></td> | 
|---|
| 592 |     <td align="center"><code>SERVICE</code></td> | 
|---|
| 593 |     <td><code>org.apache.catalina.Service</code></td> | 
|---|
| 594 |     <td><code>org.apache.catalina.core.StandardService</code></td> | 
|---|
| 595 |   </tr> | 
|---|
| 596 |  | 
|---|
| 597 |   <tr> | 
|---|
| 598 |     <td><code>StandardWrapper</code></td> | 
|---|
| 599 |     <td align="center"><code>WRAPPER</code></td> | 
|---|
| 600 |     <td><code>org.apache.catalina.Wrapper</code></td> | 
|---|
| 601 |     <td><code>org.apache.catalina.core.StandardWrapper</code></td> | 
|---|
| 602 |   </tr> | 
|---|
| 603 |  | 
|---|
| 604 |   <tr> | 
|---|
| 605 |     <td><code>StandardWrapperValve</code></td> | 
|---|
| 606 |     <td align="center"><code>VALVE</code></td> | 
|---|
| 607 |     <td><code>org.apache.catalina.Valve</code></td> | 
|---|
| 608 |     <td><code>org.apache.catalina.core.StandardWrapperValve</code></td> | 
|---|
| 609 |   </tr> | 
|---|
| 610 |  | 
|---|
| 611 |   <tr> | 
|---|
| 612 |     <td><code>User</code></td> | 
|---|
| 613 |     <td align="center"><code>USER</code></td> | 
|---|
| 614 |     <td><code>org.apache.catalina.User</code></td> | 
|---|
| 615 |     <td><code>org.apache.catalina.User</code></td> | 
|---|
| 616 |   </tr> | 
|---|
| 617 |  | 
|---|
| 618 |   <tr> | 
|---|
| 619 |     <td><code>UserDatabaseRealm</code></td> | 
|---|
| 620 |     <td align="center"><code>REALM</code></td> | 
|---|
| 621 |     <td><code>org.apache.catalina.Realm</code></td> | 
|---|
| 622 |     <td><code>org.apache.catalina.realm.UserDatabaseRealm</code></td> | 
|---|
| 623 |   </tr> | 
|---|
| 624 |  | 
|---|
| 625 |   <tr> | 
|---|
| 626 |     <td><code>WebappLoader</code></td> | 
|---|
| 627 |     <td align="center"><code>LOADER</code></td> | 
|---|
| 628 |     <td><code>org.apache.catalina.Loader</code></td> | 
|---|
| 629 |     <td><code>org.apache.catalina.loader.WebappLoader</code></td> | 
|---|
| 630 |   </tr> | 
|---|
| 631 |  | 
|---|
| 632 | </table> | 
|---|
| 633 |  | 
|---|
| 634 | </blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="JSR-77 Cross Reference"><strong>JSR-77 Cross Reference</strong></a></font></td></tr><tr><td><blockquote> | 
|---|
| 635 |  | 
|---|
| 636 | <p>The managed objects in the JSR-77 object hierarchy correspond | 
|---|
| 637 | to the specified MBean names or groups as follows:</p> | 
|---|
| 638 |  | 
|---|
| 639 | <table border="1" cellpadding="5"> | 
|---|
| 640 |  | 
|---|
| 641 |   <tr> | 
|---|
| 642 |     <th align="center" bgcolor="aqua">JSR-77 Managed Object</th> | 
|---|
| 643 |     <th align="center" bgcolor="aqua">MBean Name or Group</th> | 
|---|
| 644 |     <th align="center" bgcolor="aqua">Comments</th> | 
|---|
| 645 |   </tr> | 
|---|
| 646 |  | 
|---|
| 647 |   <tr> | 
|---|
| 648 |     <td><code>J2EEServer</code></td> | 
|---|
| 649 |     <td><code>${SERVICE}</code></td> | 
|---|
| 650 |     <td></td> | 
|---|
| 651 |   </tr> | 
|---|
| 652 |  | 
|---|
| 653 |   <tr> | 
|---|
| 654 |     <td><code>Node</code></td> | 
|---|
| 655 |     <td><code>${SERVICE}</code></td> | 
|---|
| 656 |     <td>Tomcat supports a single node only.</td> | 
|---|
| 657 |   </tr> | 
|---|
| 658 |  | 
|---|
| 659 |   <tr> | 
|---|
| 660 |     <td><code>Port</code></td> | 
|---|
| 661 |     <td><code>${CONNECTOR}</code></td> | 
|---|
| 662 |     <td></td> | 
|---|
| 663 |   </tr> | 
|---|
| 664 |  | 
|---|
| 665 |   <tr> | 
|---|
| 666 |     <td><code>Servlet</code></td> | 
|---|
| 667 |     <td><code>${WRAPPER}</code></td> | 
|---|
| 668 |     <td></td> | 
|---|
| 669 |   </tr> | 
|---|
| 670 |  | 
|---|
| 671 |   <tr> | 
|---|
| 672 |     <td><code>WebModule</code></td> | 
|---|
| 673 |     <td><code>${CONTEXT}</code></td> | 
|---|
| 674 |     <td></td> | 
|---|
| 675 |   </tr> | 
|---|
| 676 |  | 
|---|
| 677 | </table> | 
|---|
| 678 |  | 
|---|
| 679 | </blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="JSR-88 Cross Reference"><strong>JSR-88 Cross Reference</strong></a></font></td></tr><tr><td><blockquote> | 
|---|
| 680 |  | 
|---|
| 681 | <p>The deployment objects in the JSR-88 API object hierarchy correspond | 
|---|
| 682 | to the specified MBean names or groups as follows:</p> | 
|---|
| 683 |  | 
|---|
| 684 | <table border="1" cellpadding="5"> | 
|---|
| 685 |  | 
|---|
| 686 |   <tr> | 
|---|
| 687 |     <th align="center" bgcolor="aqua">JSR-88 API Object</th> | 
|---|
| 688 |     <th align="center" bgcolor="aqua">MBean Name or Group</th> | 
|---|
| 689 |     <th align="center" bgcolor="aqua">Comments</th> | 
|---|
| 690 |   </tr> | 
|---|
| 691 |  | 
|---|
| 692 |   <tr> | 
|---|
| 693 |     <td><code>DeployableObject</code></td> | 
|---|
| 694 |     <td><code>${CONTEXT}</code></td> | 
|---|
| 695 |     <td>Context deployment info plus the corresponding WAR file</td> | 
|---|
| 696 |   </tr> | 
|---|
| 697 |  | 
|---|
| 698 |   <tr> | 
|---|
| 699 |     <td><code>Target</code></td> | 
|---|
| 700 |     <td><code>${HOST}</code></td> | 
|---|
| 701 |     <td></td> | 
|---|
| 702 |   </tr> | 
|---|
| 703 |  | 
|---|
| 704 | </table> | 
|---|
| 705 |  | 
|---|
| 706 | </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em> | 
|---|
| 707 |         Copyright © 1999-2008, Apache Software Foundation | 
|---|
| 708 |         </em></font></div></td></tr></table></body></html> | 
|---|