Module java.management
Package javax.management.remote

## 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 Detail

    - #### 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.