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

JMXConnectorServerProvider

public interface JMXConnectorServerProvider

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

since
1.5
since.unbundled
1.0

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

Creates a new connector server at the given address. Each successful call to this method produces a different JMXConnectorServer object.

param
serviceURL the address of the new connector server. The actual address of the new connector server, as returned by its {@link JMXConnectorServer#getAddress() getAddress} method, will not necessarily be exactly the same. For example, it might include a port number if the original address did not.
param
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.
param
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.
return
a JMXConnectorServer representing the new connector server. 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 connector server cannot be created.