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 TypeMethodDescriptionnewJMXConnector(JMXServiceURL serviceURL, Map<String, ?> environment) Creates a new connector client that is ready to connect to the connector server at the given address.
-
Method Details
-
newJMXConnector
JMXConnector newJMXConnector(JMXServiceURL serviceURL, Map<String, ?> environment) throws IOExceptionCreates 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
JMXConnectorobject.- 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.
-