Interface JMXConnectorProvider
public interface JMXConnectorProvider
A provider for creating JMX API connector clients using a given protocol. Instances of this interface are created by JMXConnectorFactory as part of its newJMXConnector method.
- Since:
- 1.5
Method Summary
| Modifier and Type | Method | Description |
|---|---|---|
JMXConnector | newJMXConnector(JMXServiceURL serviceURL,
Map<String,?> environment) | Creates a new connector client that is ready to connect to the connector server at the given address. |
Method Detail
newJMXConnector
JMXConnector newJMXConnector(JMXServiceURL serviceURL,
Map<String,?> environment)
throws IOException Creates a new connector client that is ready to connect to the connector server at the given address. Each successful call to this method produces a different JMXConnector object.
- Parameters:
-
serviceURL- the address of the connector server to connect to. -
environment- a read-only Map containing named attributes to determine how the connection is made. Keys in this map must be Strings. The appropriate type of each associated value depends on the attribute. - Returns:
- a
JMXConnectorrepresenting the new connector client. Each successful call to this method produces a different object. - Throws:
-
NullPointerException- ifserviceURLorenvironmentis null. -
IOException- It is recommended for a provider implementation to throwMalformedURLExceptionif the protocol in theserviceURLis not recognized by this provider,JMXProviderExceptionif this is a provider for the protocol inserviceURLbut it cannot be used for some reason or any otherIOExceptionif the connection cannot be made because of a communication problem.