src/share/classes/javax/management/remote/JMXConnectorServerFactory.java

Print this page




 108  * underlying exception, as follows:</p>
 109  *
 110  * <ul>
 111  *
 112  * <li>if the attempt to load the class produces an exception other
 113  * than <code>ClassNotFoundException</code>, that is the
 114  * <em>cause</em>;
 115  *
 116  * <li>if {@link Class#newInstance()} for the class produces an
 117  * exception, that is the <em>cause</em>.
 118  *
 119  * </ul>
 120  *
 121  * <p>If no provider is found by the above steps, including the
 122  * default case where there is no provider package list, then the
 123  * implementation will use its own provider for
 124  * <code><em>protocol</em></code>, or it will throw a
 125  * <code>MalformedURLException</code> if there is none.  An
 126  * implementation may choose to find providers by other means.  For
 127  * example, it may support the <a
 128  * href="{@docRoot}/../technotes/guides/jar/jar.html#Service Provider">
 129  * JAR conventions for service providers</a>, where the service
 130  * interface is <code>JMXConnectorServerProvider</code>.</p>
 131  *
 132  * <p>Every implementation must support the RMI connector protocol with
 133  * the default RMI transport, specified with string <code>rmi</code>.
 134  * An implementation may optionally support the RMI connector protocol
 135  * with the RMI/IIOP transport, specified with the string
 136  * <code>iiop</code>.</p>
 137  *
 138  * <p>Once a provider is found, the result of the
 139  * <code>newJMXConnectorServer</code> method is the result of calling
 140  * {@link
 141  * JMXConnectorServerProvider#newJMXConnectorServer(JMXServiceURL,
 142  * Map, MBeanServer) newJMXConnectorServer} on the provider.</p>
 143  *
 144  * <p>The <code>Map</code> parameter passed to the
 145  * <code>JMXConnectorServerProvider</code> is a new read-only
 146  * <code>Map</code> that contains all the entries that were in the
 147  * <code>environment</code> parameter to {@link
 148  * #newJMXConnectorServer(JMXServiceURL,Map,MBeanServer)




 108  * underlying exception, as follows:</p>
 109  *
 110  * <ul>
 111  *
 112  * <li>if the attempt to load the class produces an exception other
 113  * than <code>ClassNotFoundException</code>, that is the
 114  * <em>cause</em>;
 115  *
 116  * <li>if {@link Class#newInstance()} for the class produces an
 117  * exception, that is the <em>cause</em>.
 118  *
 119  * </ul>
 120  *
 121  * <p>If no provider is found by the above steps, including the
 122  * default case where there is no provider package list, then the
 123  * implementation will use its own provider for
 124  * <code><em>protocol</em></code>, or it will throw a
 125  * <code>MalformedURLException</code> if there is none.  An
 126  * implementation may choose to find providers by other means.  For
 127  * example, it may support the <a
 128  * href="{@docRoot}/../technotes/guides/jar/jar.html#Service%20Provider">
 129  * JAR conventions for service providers</a>, where the service
 130  * interface is <code>JMXConnectorServerProvider</code>.</p>
 131  *
 132  * <p>Every implementation must support the RMI connector protocol with
 133  * the default RMI transport, specified with string <code>rmi</code>.
 134  * An implementation may optionally support the RMI connector protocol
 135  * with the RMI/IIOP transport, specified with the string
 136  * <code>iiop</code>.</p>
 137  *
 138  * <p>Once a provider is found, the result of the
 139  * <code>newJMXConnectorServer</code> method is the result of calling
 140  * {@link
 141  * JMXConnectorServerProvider#newJMXConnectorServer(JMXServiceURL,
 142  * Map, MBeanServer) newJMXConnectorServer} on the provider.</p>
 143  *
 144  * <p>The <code>Map</code> parameter passed to the
 145  * <code>JMXConnectorServerProvider</code> is a new read-only
 146  * <code>Map</code> that contains all the entries that were in the
 147  * <code>environment</code> parameter to {@link
 148  * #newJMXConnectorServer(JMXServiceURL,Map,MBeanServer)