<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>MX4J English Documentation</title><link href="styles.css" type="text/css" rel="stylesheet"><meta content="DocBook XSL Stylesheets V1.78.1" name="generator"><link rel="home" href="index.html" title="MX4J English Documentation"><link rel="next" href="ch01.html" title="Chapter 1. MX4J and JMX Overview"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">MX4J English Documentation</th></tr><tr><td align="left" width="20%"> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="N10001"></a>MX4J English Documentation</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="ch01.html">1. MX4J and JMX Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#N10008">Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#N1000B">MX4J</a></span></dt><dt><span class="section"><a href="ch01.html#N1002D">What is JMX ?</a></span></dt><dt><span class="section"><a href="ch01.html#N10034">For what can you use JMX ?</a></span></dt><dt><span class="section"><a href="ch01.html#N10043">MX4J's JMX implementation</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">License</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch02.html">2. JMX 1.2 Explained</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#N10085">
<code class="classname">javax.management.ObjectName</code> changes
</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#N1008B">The
<code class="classname">getInstance()</code> methods
</a></span></dt><dt><span class="section"><a href="ch02.html#N100D1">The
<code class="classname">quote()</code> and
<code class="classname">unquote()</code> methods
</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Support for remote API</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#N100F9">Overview</a></span></dt><dt><span class="section"><a href="ch02s02.html#N10105">The
<code class="classname">javax.management.MBeanServer</code> class inherits from
<code class="classname">javax.management.MBeanServerConnection</code>
</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s03.html">The
<code class="classname">javax.management.MBeanServerBuilder</code> class
</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s03.html#N10122">Introduction</a></span></dt><dt><span class="section"><a href="ch02s03.html#N1014C">How to use MX4J's
<code class="classname">MBeanServer</code> implementation with Sun's JMX Reference Implementation.
</a></span></dt><dt><span class="section"><a href="ch02s03.html#N10163">How to "decorate"
<code class="classname">MBeanServer</code> methods.
</a></span></dt><dt><span class="section"><a href="ch02s03.html#N10249">More complex
<code class="classname">MBeanServer</code> "decorations".
</a></span></dt><dt><span class="section"><a href="ch02s03.html#N1026F">Possible usages of MBeanServer "decorators"</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s04.html">The
<code class="classname">javax.management.MBeanServerInvocationHandler</code> class
</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s04.html#N1028D">Introduction</a></span></dt><dt><span class="section"><a href="ch02s04.html#N102B9">MBeanServerInvocationHandler usage</a></span></dt><dt><span class="section"><a href="ch02s04.html#N102FD">Porting examples for
<code class="classname">mx4j.util.StandardMBeanProxy</code>
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">3. JSR 160 (JMX Remoting) Explained</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#N10324">What is JSR 160 ?</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#N10327">Introduction</a></span></dt><dt><span class="section"><a href="ch03.html#N1033C">MX4J's JSR 160 implementation</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">How to use JSR 160</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s02.html#N10373">Introduction</a></span></dt><dt><span class="section"><a href="ch03s02.html#N1037A">JMXServiceURLs</a></span></dt><dt><span class="section"><a href="ch03s02.html#N103A9">Creating a JMXConnectorServer</a></span></dt><dt><span class="section"><a href="ch03s02.html#N103DD">Creating a JMXConnector</a></span></dt><dt><span class="section"><a href="ch03s02.html#N10409">Remote Notifications</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s03.html">JSR 160 Security</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s03.html#N10463">Requiring user authentication to connect to a JMXConnectorServer</a></span></dt><dt><span class="section"><a href="ch03s03.html#N104B7">Running under SecurityManager and Subject Delegation</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s04.html">Advanced JSR 160</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s04.html#N10534">Intercepting calls between the JSR 160 JMXConnectorServer and the MBeanServer</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s05.html">Standard JSR 160 JMXConnectors and JMXConnectorServers</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s05.html#N10559">Overview of RMIConnector and RMIConnectorServer</a></span></dt><dt><span class="section"><a href="ch03s05.html#N1056C">Connecting to the RMIConnectorServer</a></span></dt><dt><span class="section"><a href="ch03s05.html#N105BB">ORB properties for JMXConnector and JMXConnectorServer over IIOP</a></span></dt><dt><span class="section"><a href="ch03s05.html#N105C8">RMI socket factories (over SSL) for the RMIConnectorServer over JRMP</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s06.html">MX4J's JSR 160 JMXConnectors and JMXConnectorServers</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s06.html#N105F7">The SOAP JSR 160 connector</a></span></dt><dt><span class="section"><a href="ch03s06.html#N10657">The HESSIAN and BURLAP JSR 160 connectors</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s07.html">Using HTTP-based connectors over HTTPS</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s07.html#N106A3">Configuration of the web container</a></span></dt><dt><span class="section"><a href="ch03s07.html#N106C4">Configuration of the keystore</a></span></dt><dt><span class="section"><a href="ch03s07.html#N106DE">Code examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s08.html">Porting old MX4J remoting code to JSR 160</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s08.html#N106F3">Introduction</a></span></dt><dt><span class="section"><a href="ch03s08.html#N106FA">Porting Examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s09.html">MX4J Remote Tools and Utilities</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s09.html#N10756">Remote MBean Proxying</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch04.html">4. MX4J Extensions and utilities</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#N1078A">Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#N10791">Standard MBean descriptions</a></span></dt></dl></dd><dt><span class="section"><a href="ch04s02.html">Interacting with the MX4J implementation</a></span></dt><dd><dl><dt><span class="section"><a href="ch04s02.html#N107D6">Internal logging redirection</a></span></dt><dt><span class="section"><a href="ch04s02.html#N1083B">MBeanServerInterceptor configuration</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch05.html">5. MX4J HTTP Adaptor</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#N1087B">HttpAdaptor</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#N1087E">Introduction</a></span></dt><dt><span class="section"><a href="ch05.html#N1089A">Parameters and operations</a></span></dt><dt><span class="section"><a href="ch05.html#N10925">Security</a></span></dt><dt><span class="section"><a href="ch05.html#N1097A">Usage</a></span></dt><dt><span class="section"><a href="ch05.html#N1098E">Available requests</a></span></dt></dl></dd><dt><span class="section"><a href="ch05s02.html">XSLTProcessor</a></span></dt><dd><dl><dt><span class="section"><a href="ch05s02.html#N10AFD">Introduction</a></span></dt><dt><span class="section"><a href="ch05s02.html#N10B2D">Compatibility</a></span></dt><dt><span class="section"><a href="ch05s02.html#N10B45">Attributes</a></span></dt><dt><span class="section"><a href="ch05s02.html#N10B83">XSL Development</a></span></dt><dt><span class="section"><a href="ch05s02.html#N10B99">Internationalization</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch06.html">6. MX4J Tools</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#N10BA3">XML Configuration Loader</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#N10BA6">Loading and starting MBeans using XML files</a></span></dt></dl></dd><dt><span class="section"><a href="ch06s02.html">Dynamic MBeans</a></span></dt><dd><dl><dt><span class="section"><a href="ch06s02.html#N10C48">AbstractDynamicMBean base class for DynamicMBean implementation</a></span></dt></dl></dd><dt><span class="section"><a href="ch06s03.html">Naming MBeans</a></span></dt><dd><dl><dt><span class="section"><a href="ch06s03.html#N10CE4">The NamingService MBean</a></span></dt><dt><span class="section"><a href="ch06s03.html#N10D2B">The CosNamingService MBean</a></span></dt></dl></dd><dt><span class="section"><a href="ch06s04.html">Mailer MBean</a></span></dt><dd><dl><dt><span class="section"><a href="ch06s04.html#N10D67">Introduction</a></span></dt><dt><span class="section"><a href="ch06s04.html#N10D7B">Configuration</a></span></dt><dt><span class="section"><a href="ch06s04.html#N10DAA">Keyword expanding</a></span></dt></dl></dd><dt><span class="section"><a href="ch06s05.html">Jython MBean</a></span></dt><dd><dl><dt><span class="section"><a href="ch06s05.html#N10DDE">Introduction</a></span></dt><dt><span class="section"><a href="ch06s05.html#N10E02">Configuration</a></span></dt><dt><span class="section"><a href="ch06s05.html#N10E07">Built-in functions</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch07.html">7. MX4J Examples</a></span></dt><dd><dl><dt><span class="section"><a href="ch07.html#N10E32">Services</a></span></dt><dd><dl><dt><span class="section"><a href="ch07.html#N10E35">The Relation Service example</a></span></dt></dl></dd><dt><span class="section"><a href="ch07s02.html">MBeans</a></span></dt><dd><dl><dt><span class="section"><a href="ch07s02.html#N10EEA">RMI MBean example</a></span></dt></dl></dd><dt><span class="section"><a href="ch07s03.html">Tools</a></span></dt><dd><dl><dt><span class="section"><a href="ch07s03.html#N11001">Using XDoclet</a></span></dt><dt><span class="section"><a href="ch07s03.html#N1106A">FilePersister example</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch08.html">8. FAQ</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#N110AA">MX4J Frequently Asked Questions</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch09.html">9. MX4J Developer's guide</a></span></dt><dd><dl><dt><span class="section"><a href="ch09.html#N110D7">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="ch09.html#N110DC">Coding conventions</a></span></dt><dt><span class="section"><a href="ch09.html#N110EF">Using logging</a></span></dt><dt><span class="section"><a href="ch09.html#N11209">Writing documentation</a></span></dt><dt><span class="section"><a href="ch09.html#N11218">Releasing MX4J</a></span></dt><dt><span class="section"><a href="ch09.html#N1123B">MX4J Implementation Architecture</a></span></dt></dl></dd></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>7.1. <a href="ch07s03.html#N1103A">List of Javadoc tags</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>2.1. <a href="ch02s03.html#N10156"></a></dt><dt>2.2. <a href="ch02s03.html#N101B9">A "decorating"
<code class="classname">MBeanServer</code> that logs method calls.
</a></dt><dt>2.3. <a href="ch02s03.html#N101D8">A "decorating"
<code class="classname">MBeanServerBuilder</code>
</a></dt><dt>2.4. <a href="ch02s03.html#N101FD">The
<code class="classname">MBeanServerBuilder</code> and
<code class="classname">MBeanServer</code> chains
</a></dt><dt>2.5. <a href="ch02s03.html#N10232">A "decorating"
<code class="classname">MBeanServerBuilder</code>
</a></dt><dt>2.6. <a href="ch02s03.html#N1025D">A More complex
<code class="classname">MBeanServerBuilder</code> and
<code class="classname">MBeanServer</code> chains
</a></dt><dt>2.7. <a href="ch02s04.html#N102D6">Standard JMX invocation</a></dt><dt>2.8. <a href="ch02s04.html#N102DF">JMX invocation with MBeanServerInvocationHandler</a></dt><dt>2.9. <a href="ch02s04.html#N102F1">Remote JMX invocation with MBeanServerInvocationHandler</a></dt><dt>2.10. <a href="ch02s04.html#N10311">Old MX4J 1.x proxy API</a></dt><dt>2.11. <a href="ch02s04.html#N1031A">Standard JMX 1.2 proxy API</a></dt><dt>3.1. <a href="ch03s02.html#N103C3">Creating and starting a standalone JMXConnectorServer</a></dt><dt>3.2. <a href="ch03s02.html#N103D2">Creating and starting an MBean JMXConnectorServer</a></dt><dt>3.3. <a href="ch03s02.html#N103F3">Connecting a JMXConnector</a></dt><dt>3.4. <a href="ch03s02.html#N10402">Creating and connecting a JMXConnector</a></dt><dt>3.5. <a href="ch03s02.html#N10459">Registering a NotificationListener to a remote MBean</a></dt><dt>3.6. <a href="ch03s03.html#N10497">Using JMXAuthenticator in a JMXConnectorServer</a></dt><dt>3.7. <a href="ch03s03.html#N104A6">Passing credentials using a JMXConnector</a></dt><dt>3.8. <a href="ch03s03.html#N104DD">The server.policy file</a></dt><dt>3.9. <a href="ch03s03.html#N104F6">Starting the secured server</a></dt><dt>3.10. <a href="ch03s03.html#N1050B">The principal-specific permissions</a></dt><dt>3.11. <a href="ch03s04.html#N10544">Simple subject interceptor skeleton</a></dt><dt>3.12. <a href="ch03s04.html#N1054F">Setting up the interception on the JMXConnectorServer</a></dt><dt>3.13. <a href="ch03s05.html#N10587">Examples of encoded form JMXServiceURLs</a></dt><dt>3.14. <a href="ch03s05.html#N105A1">Examples of JNDI URL form JMXServiceURLs</a></dt><dt>3.15. <a href="ch03s05.html#N105B4">Examples of JNDI short form JMXServiceURLs</a></dt><dt>3.16. <a href="ch03s05.html#N105ED">How to specify the RMI socket factories</a></dt><dt>3.17. <a href="ch03s06.html#N10632">Starting the SOAPConnectorServer</a></dt><dt>3.18. <a href="ch03s06.html#N1063B">Connecting to the SOAPConnectorServer</a></dt><dt>3.19. <a href="ch03s06.html#N10678">Starting the HessianConnectorServer</a></dt><dt>3.20. <a href="ch03s06.html#N10681">Connecting to the HessianConnectorServer</a></dt><dt>3.21. <a href="ch03s07.html#N106B5">Example Jetty configuration file to run JMXConnectorServers over HTTPS</a></dt><dt>3.22. <a href="ch03s07.html#N106E8">Starting and connecting to the Hessian connector server over HTTPS</a></dt><dt>3.23. <a href="ch03s08.html#N10701">Old MX4J 1.x remoting code, server side</a></dt><dt>3.24. <a href="ch03s08.html#N1070A">JSR 160 remoting code, server side</a></dt><dt>3.25. <a href="ch03s08.html#N10725">Old MX4J 1.x remoting code, client side</a></dt><dt>3.26. <a href="ch03s08.html#N1072E">JSR 160 remoting code, client side</a></dt><dt>3.27. <a href="ch03s09.html#N10779">Remote MBean proxying</a></dt><dt>4.1. <a href="ch04.html#N107C8">Specifying description for standard MBeans</a></dt><dt>4.2. <a href="ch04s02.html#N1080F">Logging redirection to Log4J</a></dt><dt>4.3. <a href="ch04s02.html#N10825">Logging redirection to the broadcaster MBean</a></dt><dt>4.4. <a href="ch04s02.html#N10871">Using the interceptor configurator API</a></dt><dt>5.1. <a href="ch05.html#N1097F">Instantiating the HttpAdaptor</a></dt><dt>5.2. <a href="ch05.html#N10987">Installing a non-default Processor</a></dt><dt>6.1. <a href="ch06.html#N10BBE">Main class for configuration loading</a></dt><dt>6.2. <a href="ch06.html#N10BCB">XML file for configuration of MX4J's HttpAdaptor</a></dt><dt>6.3. <a href="ch06.html#N10BF4">XML file for configuration of a JSR 160 connector server</a></dt><dt>6.4. <a href="ch06.html#N10C2A">Simple XML file that specifies the command port</a></dt><dt>6.5. <a href="ch06.html#N10C33">Simple Java class that invokes "shutdown" to execute the shutdown section</a></dt><dt>6.6. <a href="ch06.html#N10C3E">XML configuration DTD</a></dt><dt>6.7. <a href="ch06s02.html#N10C9C">Subclassing
<code class="classname">AbstractDynamicMBean</code>
</a></dt><dt>6.8. <a href="ch06s02.html#N10CBF">Delegating to
<code class="classname">AbstractDynamicMBean</code> subclass
</a></dt><dt>6.9. <a href="ch06s02.html#N10CD3">Subclassing
<code class="classname">AbstractDynamicMBean</code>
</a></dt><dt>6.10. <a href="ch06s03.html#N10CF7">Deploying the NamingService MBean</a></dt><dt>6.11. <a href="ch06s03.html#N10D0C">Starting and stopping the NamingService MBean</a></dt><dt>6.12. <a href="ch06s03.html#N10D17">Changing the default port</a></dt><dt>6.13. <a href="ch06s03.html#N10D24">Changing the port at runtime</a></dt><dt>7.1. <a href="ch07.html#N10E7C">Creating the RelationService</a></dt><dt>7.2. <a href="ch07.html#N10E8A">Adding a RelationType</a></dt><dt>7.3. <a href="ch07.html#N10E92">Building Roles</a></dt><dt>7.4. <a href="ch07s02.html#N10F5A">The
<code class="classname">Server</code> class
</a></dt><dt>7.5. <a href="ch07s02.html#N10F8D">The
<code class="classname">MyRemoteServiceObject</code> class
</a></dt><dt>7.6. <a href="ch07s03.html#N11018">Defining the xdoclet classpath and Ant task.</a></dt><dt>7.7. <a href="ch07s03.html#N1102F"></a></dt><dt>7.8. <a href="ch07s03.html#N11077">MBeanOne implementation</a></dt><dt>7.9. <a href="ch07s03.html#N1107F">MBeanTwo implementation</a></dt><dt>7.10. <a href="ch07s03.html#N1108A">The FilePersisterAgent</a></dt><dt>7.11. <a href="ch07s03.html#N11095"></a></dt><dt>9.1. <a href="ch09.html#N110E8">One-line one-brace style</a></dt><dt>9.2. <a href="ch09.html#N11166">Saving run-time cost of <code class="classname">String</code> concatenation</a></dt><dt>9.3. <a href="ch09.html#N11179">Saving run-time cost of <code class="classname">String</code> concatenation with <code class="classname">StringBuffer</code></a></dt><dt>9.4. <a href="ch09.html#N11191">Retrieving a Logger instance</a></dt><dt>9.5. <a href="ch09.html#N111E3">Logs with error priority</a></dt><dt>9.6. <a href="ch09.html#N111F9">Logs with fatal priority</a></dt></dl></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td valign="top" align="left" width="40%"> </td><td align="center" width="20%"> </td><td valign="top" align="right" width="40%"> Chapter 1. MX4J and JMX Overview</td></tr></table></div></body></html>
