JMXConnectorServerProvider (Java Platform SE 6)

This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.

Overview

Package

Class

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.management.remote
interface 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.

Method Summary
`JMXConnectorServer`	`newJMXConnectorServer(JMXServiceURL serviceURL, Map environment, MBeanServer mbeanServer)` Creates a new connector server at the given address.

Method Detail

newJMXConnectorServer

public JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL,
                                                Map environment,
                                                MBeanServer mbeanServer)
                                         throws IOException

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

Parameters:: 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.; 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.; 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.
Returns:: a JMXConnectorServer representing the new connector server. Each successful call to this method produces a different object.
Throws:: 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.