FileDocCategorySizeDatePackage
JMXConnectorProvider.javaAPI DocJava SE 6 API2097Tue Jun 10 00:26:18 BST 2008javax.management.remote

JMXConnectorProvider

public interface JMXConnectorProvider

A provider for creating JMX API connector clients using a given protocol. Instances of this interface are created by {@link JMXConnectorFactory} as part of its {@link JMXConnectorFactory#newJMXConnector(JMXServiceURL, Map) newJMXConnector} method.

since
1.5
since.unbundled
1.0

Fields Summary
Constructors Summary
Methods Summary
public javax.management.remote.JMXConnectornewJMXConnector(javax.management.remote.JMXServiceURL serviceURL, java.util.Map environment)

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.

param
serviceURL the address of the connector server to connect to.
param
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.

return
a JMXConnector representing the new connector client. Each successful call to this method produces a different object.
exception
NullPointerException if serviceURL or environment is null.
exception
IOException It is recommended for a provider implementation to throw {@code MalformedURLException} if the protocol in the {@code serviceURL} is not recognized by this provider, {@code JMXProviderException} if this is a provider for the protocol in {@code serviceURL} but it cannot be used for some reason or any other {@code IOException} if the connection cannot be made because of a communication problem.