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 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
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
JMXConnector
representing the new connector client. Each successful call to this method produces a different object. - Throws:
NullPointerException
- ifserviceURL
orenvironment
is null.IOException
- It is recommended for a provider implementation to throwMalformedURLException
if the protocol in theserviceURL
is not recognized by this provider,JMXProviderException
if this is a provider for the protocol inserviceURL
but it cannot be used for some reason or any otherIOException
if the connection cannot be made because of a communication problem.
-