Factory to create JMX API connector servers. There are no instances of this class.
Each connector server is created by an instance of JMXConnectorServerProvider. This instance is found as follows. Suppose
the given JMXServiceURL looks like
"service:jmx:protocol:remainder".
Then the factory will attempt to find the appropriate JMXConnectorServerProvider for protocol. Each
occurrence of the character + or - in
protocol is replaced by . or
_, respectively.
A provider package list is searched for as follows:
environment parameter to newJMXConnectorServer contains the key
jmx.remote.protocol.provider.pkgs then the associated
value is the provider package list.
jmx.remote.protocol.provider.pkgs exists, then its value
is the provider package list.
The provider package list is a string that is interpreted as a
list of non-empty Java package names separated by vertical bars
(|). If the string is empty, then so is the provider
package list. If the provider package list is not a String, or if
it contains an element that is an empty string, a JMXProviderException is thrown.
If the provider package list exists and is not empty, then for
each element pkg of the list, the factory
will attempt to load the class
pkg.protocol.ServerProvider
If the environment parameter to newJMXConnectorServer contains the key
jmx.remote.protocol.provider.class.loader then the
associated value is the class loader to use to load the provider.
If the associated value is not an instance of java., an java. is thrown.
If the jmx.remote.protocol.provider.class.loader
key is not present in the environment parameter, the
calling thread's context class loader is used.
If the attempt to load this class produces a ClassNotFoundException, the search for a handler continues with
the next element of the list.
Otherwise, a problem with the provider found is signalled by a
JMXProviderException whose cause indicates the
underlying exception, as follows:
ClassNotFoundException, that is the
cause;
Class#newInstance() for the class produces an
exception, that is the cause.
If no provider is found by the above steps, including the
default case where there is no provider package list, then the
implementation will use its own provider for
protocol, or it will throw a
MalformedURLException if there is none. An
implementation may choose to find providers by other means. For
example, it may support service providers,
where the service interface is JMXConnectorServerProvider.
Every implementation must support the RMI connector protocol with
the default RMI transport, specified with string rmi.
Once a provider is found, the result of the
newJMXConnectorServer method is the result of calling
newJMXConnectorServer on the provider.
The Map parameter passed to the
JMXConnectorServerProvider is a new read-only
Map that contains all the entries that were in the
environment parameter to JMXConnectorServerFactory., if there was one.
Additionally, if the
jmx.remote.protocol.provider.class.loader key is not
present in the environment parameter, it is added to
the new read-only Map. The associated value is the
calling thread's context class loader.
| Modifier and Type | Field and Description |
|---|---|
| public static final String | DEFAULT_CLASS_LOADER
Name of the attribute that specifies the default class loader. |
| public static final String | DEFAULT_CLASS_LOADER_NAME
Name of the attribute that specifies the default class loader MBean name. |
| private static final ClassLogger | |
| public static final String | PROTOCOL_PROVIDER_CLASS_LOADER
Name of the attribute that specifies the class loader for loading protocol providers. |
| private static final String | |
| public static final String | PROTOCOL_PROVIDER_PACKAGES
Name of the attribute that specifies the provider packages that are consulted when looking for the handler for a protocol. |
| Access | Constructor and Description |
|---|---|
| private |
| Modifier and Type | Method and Description |
|---|---|
| private static JMXConnectorServer | getConnectorServerAsService(ClassLoader loader, JMXServiceURL url, Map<String, ?> map, MBeanServer mbs, Predicate<ServiceLoader.
|
| public static JMXConnectorServer | Returns: aJMXConnectorServer representing the new
connector server. Each successful call to this method produces
a different object.the address of the new connector server. The
actual address of the new connector server, as returned by its
serviceURL, Map<String, ?> getAddress method, will
not necessarily be exactly the same. For example, it might
include a port number if the original address did not.a set of attributes to control the new
connector server's behavior. This parameter can be null.
Keys in this map must be Strings. The appropriate type of each
associated value depends on the attribute. The contents of
environment, MBeanServer environment are not changed by this call.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. mbeanServer)Creates a connector server at the given address. |
| DEFAULT_CLASS_LOADER | back to summary |
|---|---|
| public static final String DEFAULT_CLASS_LOADER Name of the attribute that specifies the default class
loader. This class loader is used to deserialize objects in
requests received from the client, possibly after consulting an
MBean-specific class loader. The value associated with this
attribute is an instance of | |
| DEFAULT_CLASS_LOADER_NAME | back to summary |
|---|---|
| public static final String DEFAULT_CLASS_LOADER_NAME Name of the attribute that specifies the default class
loader MBean name. This class loader is used to deserialize objects in
requests received from the client, possibly after consulting an
MBean-specific class loader. The value associated with this
attribute is an instance of | |
| logger | back to summary |
|---|---|
| private static final ClassLogger logger | |
| PROTOCOL_PROVIDER_CLASS_LOADER | back to summary |
|---|---|
| public static final String PROTOCOL_PROVIDER_CLASS_LOADER Name of the attribute that specifies the class
loader for loading protocol providers.
The value associated with this attribute is an instance
of | |
| PROTOCOL_PROVIDER_DEFAULT_PACKAGE | back to summary |
|---|---|
| private static final String PROTOCOL_PROVIDER_DEFAULT_PACKAGE | |
| PROTOCOL_PROVIDER_PACKAGES | back to summary |
|---|---|
| public static final String PROTOCOL_PROVIDER_PACKAGES Name of the attribute that specifies the provider packages
that are consulted when looking for the handler for a protocol.
The value associated with this attribute is a string with
package names separated by vertical bars ( | |
| JMXConnectorServerFactory | back to summary |
|---|---|
| private JMXConnectorServerFactory() There are no instances of this class. | |
| getConnectorServerAsService | back to summary |
|---|---|
| private static JMXConnectorServer getConnectorServerAsService(ClassLoader loader, JMXServiceURL url, Map<String, ?> map, MBeanServer mbs, Predicate<ServiceLoader. | |
| newJMXConnectorServer | back to summary |
|---|---|
| public static JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL, Map<String, ?> environment, MBeanServer mbeanServer) throws IOException Creates a connector server at the given address. The
resultant server is not started until its
| |