APIdia Launch Partner
Top Description Methods
javax.management.remote

public Interface JMXConnectorServerProvider

Imports
java.io.IOException, java.util.Map, javax.management.MBeanServer

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 TypeMethod and Description
public JMXConnectorServer

Returns:

a JMXConnectorServer representing the new connector server. Each successful call to this method produces a different object.
newJMXConnectorServer(JMXServiceURL
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.
serviceURL, Map<String, ?>
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.
environment, 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.
mbeanServer)

Creates a new connector server at the given address.

Method Detail

newJMXConnectorServerback to summary
public 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:JMXServiceURL

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:Map<String, ?>

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: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:JMXConnectorServer

a JMXConnectorServer representing the new connector server. Each successful call to this method produces a different object.

Exceptions
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.
NullPointerException:
if serviceURL or environment is null.