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