W3cubDocs

/OpenJDK 21

Interface JMXConnectorServerProvider

public interface JMXConnectorServerProvider

A provider for creating JMX API connector servers using a given protocol. Instances of this interface are created by JMXConnectorServerFactory as part of its newJMXConnectorServer method.

Since:
1.5

Method Summary

Modifier and Type Method Description
JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL, Map<String,?> environment, MBeanServer mbeanServer)
Creates a new connector server at the given address.

Method Details

newJMXConnectorServer

JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL, Map<String,?> environment, MBeanServer mbeanServer) throws IOException

Creates a new connector server at the given address. Each successful call to this method produces a different JMXConnectorServer object.

Parameters:
serviceURL - the address of the new connector server. The actual address of the new connector server, as returned by its getAddress method, will not necessarily be exactly the same. For example, it might include a port number if the original address did not.
environment - a read-only Map containing named attributes to control the new connector server's behavior. Keys in this map must be Strings. The appropriate type of each associated value depends on the attribute.
mbeanServer - the MBean server that this connector server is attached to. Null if this connector server will be attached to an MBean server by being registered in it.
Returns:
a JMXConnectorServer representing the new connector server. Each successful call to this method produces a different object.
Throws:
NullPointerException - if serviceURL or environment is null.
IOException - It is recommended for a provider implementation to throw MalformedURLException if the protocol in the serviceURL is not recognized by this provider, JMXProviderException if this is a provider for the protocol in serviceURL but it cannot be used for some reason or any other IOException if the connector server cannot be created.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/remote/JMXConnectorServerProvider.html