Module java.management

软件包 javax.management.remote

Class JMXConnectorServerFactory

java.lang.Object

javax.management.remote.JMXConnectorServerFactory

public class JMXConnectorServerFactory
extends Object

工厂创建JMX API连接器服务器。 没有这个类的实例。

每个连接器服务器由JMXConnectorServerProvider的实例创建。 这个实例如下。 假设给定的JMXServiceURL看起来像"service:jmx:protocol:remainder" 。 那么工厂将尝试找到适合的JMXConnectorServerProvider protocol 。 字符的每一次出现+或-在protocol被替换.或_分别。

搜索提供程序包列表如下：

1. 如果environment参数为newJMXConnectorServer包含密钥jmx.remote.protocol.provider.pkgs则关联值为提供程序包列表。
2. 否则，如果系统属性jmx.remote.protocol.provider.pkgs存在，则其值是提供程序包列表。
3. 否则，没有提供程序包列表。

提供程序包列表是一个字符串，被解释为用竖线分隔的非空Java包名称列表（ | ）。 如果字符串为空，那么提供程序包列表也是如此。 如果提供程序包列表不是字符串，或者包含一个空字符串的元素，则抛出JMXProviderException 。

如果提供程序包列表存在且不为空，则对于列表的每个元素pkg ，工厂将尝试加载类

pkg.protocol.ServerProvider

如果environment参数newJMXConnectorServer包含关键字jmx.remote.protocol.provider.class.loader ，则关联的值的类加载器用来加载提供。 如果关联值不是ClassLoader的实例，则抛出IllegalArgumentException 。

如果environment参数中不存在jmx.remote.protocol.provider.class.loader密钥，则使用调用线程的上下文类加载器。

如果加载此类的尝试产生一个ClassNotFoundException ，搜索处理程序将继续列表的下一个元素。

否则，发现与供应商的一个问题是由信号JMXProviderException ，其cause表示底层异常，如下所示：

• 如果加载类的尝试产生了ClassNotFoundException以外的异常，那就是原因 ;
• 如果Class.newInstance()为该类产生异常，那就是原因 。

如果没有通过上述步骤找到提供程序，包括没有提供程序包列表的默认情况，那么实现将使用自己的提供者protocol ，否则将抛出一个MalformedURLException 。 实施可以选择通过其他方式查找提供商。 例如，它可以支持service providers ，其中服务接口是JMXConnectorServerProvider 。

每个实现必须支持具有默认RMI传输的RMI连接器协议，并使用字符串rmi指定。

一旦找到提供商， newJMXConnectorServer方法的结果就是在提供商上调用newJMXConnectorServer的结果。

该Map传递给参数JMXConnectorServerProvider是一个新的只读Map包含所有均在条目environment参数JMXConnectorServerFactory.newJMXConnectorServer ，如果有一个。 另外，如果environment参数中不存在jmx.remote.protocol.provider.class.loader键，则将其添加到新的只读Map 。 关联的值是调用线程的上下文类加载器。

从以下版本开始：

1.5

Field Summary

Fields

Modifier and Type	Field	描述
static String	DEFAULT_CLASS_LOADER	指定默认类加载器的属性的名称。
static String	DEFAULT_CLASS_LOADER_NAME	指定默认类加载器MBean名称的属性的名称。
static String	PROTOCOL_PROVIDER_CLASS_LOADER	指定加载协议提供程序的类加载器的属性的名称。
static String	PROTOCOL_PROVIDER_PACKAGES	指定在查找协议的处理程序时查询的提供程序包的属性的名称。

方法摘要

Modifier and Type	方法	描述
static JMXConnectorServer	newJMXConnectorServer(JMXServiceURL serviceURL, Map<String,?> environment, MBeanServer mbeanServer)	在给定的地址创建一个连接器服务器。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

DEFAULT_CLASS_LOADER

public static final String DEFAULT_CLASS_LOADER

指定默认类加载器的属性的名称。 此类加载器用于在从客户端接收的请求中对对象进行反序列化，可能在咨询了MBean特定类加载器之后。 与此属性相关联的值是一个ClassLoader的实例。

另请参见：

Constant Field Values

DEFAULT_CLASS_LOADER_NAME

public static final String DEFAULT_CLASS_LOADER_NAME

指定默认类加载器MBean名称的属性的名称。 此类加载器用于在从客户端接收的请求中对对象进行反序列化，可能在咨询了MBean特定类加载器之后。 与此属性相关联的值是一个ObjectName的实例。

另请参见：

Constant Field Values

PROTOCOL_PROVIDER_PACKAGES

public static final String PROTOCOL_PROVIDER_PACKAGES

指定在查找协议的处理程序时查询的提供程序包的属性的名称。 与此属性相关联的值是一个包含名称由竖线分隔的字符串（ | ）。

另请参见：

Constant Field Values

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String PROTOCOL_PROVIDER_CLASS_LOADER

指定加载协议提供程序的类加载器的属性的名称。 与此属性相关联的值为ClassLoader的实例。

另请参见：

Constant Field Values

方法详细信息

newJMXConnectorServer

public static JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL,
                                                       Map<String,?> environment,
                                                       MBeanServer mbeanServer)
                                                throws IOException

在给定的地址创建一个连接器服务器。 在调用start方法之前，不会启动生成的服务器。

参数

serviceURL - 新连接器服务器的地址。 由其getAddress方法返回的新连接器服务器的实际地址将不一定完全相同。 例如，如果原始地址没有，它可能包含端口号。

environment - 用于控制新连接器服务器行为的一组属性。 此参数可以为null。 此地图中的键必须是字符串。 每个关联值的适当类型取决于属性。 environment的内容不会被此呼叫更改。

mbeanServer - 此连接器服务器连接到的MBean服务器。 如果此连接器服务器将通过注册到MBean服务器，则为空。

结果

一个表示新的连接器服务器的JMXConnectorServer 。 每次成功调用此方法都会产生不同的对象。

异常

NullPointerException - 如果 serviceURL为空。

IOException - 如果连接器服务器由于通信问题而无法制作。

MalformedURLException -如果没有供应商在协议 serviceURL 。

JMXProviderException -如果在协议供应商 serviceURL ，但它不能用于某些原因。