模块 java.management

软件包 javax.management.remote

Class JMXConnectorServer

java.lang.Object

javax.management.NotificationBroadcasterSupport

javax.management.remote.JMXConnectorServer

实现的所有接口

MBeanRegistration ， NotificationBroadcaster ， NotificationEmitter ， JMXAddressable ， JMXConnectorServerMBean

已知直接子类：

RMIConnectorServer

public abstract class JMXConnectorServer
extends NotificationBroadcasterSupport
implements JMXConnectorServerMBean, MBeanRegistration, JMXAddressable

每个连接器服务器的超类。 连接器服务器连接到MBean服务器。 它侦听客户端连接请求并为每个请求创建连接。

连接器服务器通过在MBean服务器中注册MBean服务器或将MBean服务器传递给其构造函数与MBean服务器相关联。

连接器服务器在创建时处于非活动状 它只在调用start方法时才开始侦听客户端连接。 当调用stop方法或从其MBean服务器取消注册连接器服务器时，连接器服务器将停止侦听客户端连接。

停止连接器服务器不会从其MBean服务器取消注册。 一旦停止的连接器服务器无法重新启动。

每次建立或断开客户端连接时， 都会发出类JMXConnectionNotification的通知。

从以下版本开始：

1.5

字段汇总

字段

变量和类型	字段	描述
static String	AUTHENTICATOR	指定连接器服务器的身份验证器的属性的名称。

构造方法摘要

构造方法

构造器	描述
JMXConnectorServer()	构造一个连接器服务器，该服务器将在其所连接的MBean服务器中注册为MBean。
JMXConnectorServer(MBeanServer mbeanServer)	构造连接到给定MBean服务器的连接器服务器。

方法摘要

变量和类型	方法	描述
protected void	connectionClosed(String connectionId, String message, Object userData)	当客户端连接正常关闭时由子类调用。
protected void	connectionFailed(String connectionId, String message, Object userData)	客户端连接失败时由子类调用。
protected void	connectionOpened(String connectionId, String message, Object userData)	打开新客户端连接时由子类调用。
MBeanServer	getMBeanServer()	返回此连接器服务器所连接的MBean服务器。
MBeanNotificationInfo[]	getNotificationInfo()	返回一个数组，指示此MBean发送的通知。
void	preDeregister()	当从该MBean服务器取消注册此连接器服务器时，由MBean服务器调用。
ObjectName	preRegister(MBeanServer mbs, ObjectName name)	在此MBean服务器中注册此连接器服务器时由MBean服务器调用。
JMXConnector	toJMXConnector(Map<String,?> env)	返回此连接器服务器的客户端存根。

声明方法的类 javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, sendNotification

声明方法的类 java.lang.Object

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

声明方法的接口 javax.management.remote.JMXAddressable

getAddress

声明方法的接口 javax.management.remote.JMXConnectorServerMBean

getAddress, getAttributes, getConnectionIds, isActive, setMBeanServerForwarder, start, stop

声明方法的接口 javax.management.MBeanRegistration

postDeregister, postRegister

声明方法的接口 javax.management.NotificationBroadcaster

removeNotificationListener

声明方法的接口 javax.management.NotificationEmitter

removeNotificationListener

字段详细信息

AUTHENTICATOR

public static final String AUTHENTICATOR

指定连接器服务器的身份验证器的属性的名称。 与此属性关联的值（如果有）必须是实现接口JMXAuthenticator的对象。

另请参见：

常数字段值

构造方法详细信息

JMXConnectorServer

public JMXConnectorServer()

构造一个连接器服务器，该服务器将在其所连接的MBean服务器中注册为MBean。 在MBean服务器中创建使其可远程使用的连接器服务器时，此构造函数通常由createMBean方法之一调用。

JMXConnectorServer

public JMXConnectorServer(MBeanServer mbeanServer)

构造连接到给定MBean服务器的连接器服务器。 以这种方式创建的连接器服务器可以在不同的MBean服务器中注册，也可以不在任何MBean服务器中注册。

参数

mbeanServer - 此连接器服务器所连接的MBean服务器。 如果此连接器服务器通过在其中注册而附加到MBean服务器，则为空。

方法详细信息

getMBeanServer

public MBeanServer getMBeanServer()

返回此连接器服务器所连接的MBean服务器。

结果

此连接器服务器所连接的MBean服务器，如果尚未连接到MBean服务器，则为null。

toJMXConnector

public JMXConnector toJMXConnector(Map<String,?> env)
                            throws IOException

返回此连接器服务器的客户端存根。 客户端存根是一个可序列化的对象，其connect方法可用于与此连接器服务器建立一个新连接。

给定的连接器不需要支持客户端存根的生成。 但是，JMX Remote API指定的连接器（JMXMP连接器和RMI连接器）。

此方法的默认实现使用JMXConnectorServerMBean.getAddress()和JMXConnectorFactory生成存根，代码等效于以下内容：

  JMXServiceURL addr = getAddress();
 return JMXConnectorFactory.newJMXConnector(addr, env); 

不适合的连接器服务器必须覆盖此方法，以便它实现适当的逻辑或抛出UnsupportedOperationException 。

Specified by:

toJMXConnector在界面 JMXConnectorServerMBean

参数

env - 可提供给JMXConnector.connect(Map)的相同类型的客户端连接参数。 可以为null，相当于空映射。

结果

客户端存根，可用于与此连接器服务器建立新连接。

异常

UnsupportedOperationException - 如果此连接器服务器不支持生成客户端存根。

IllegalStateException - 如果未启动JMXConnectorServer（请参阅 JMXConnectorServerMBean.isActive() ）。

IOException - 如果通信问题意味着无法创建存根。

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

返回一个数组，指示此MBean发送的通知。 JMXConnectorServer的实现返回一个包含一个元素的数组，表示它可以使用该类中定义的类型发出类JMXConnectionNotification的通知。 可以发出其他通知的子类应返回包含此元素的数组以及其他通知的描述。

Specified by:

getNotificationInfo ，界面 NotificationBroadcaster

结果

可能的通知数组。

connectionOpened

protected void connectionOpened(String connectionId,
                                String message,
                                Object userData)

打开新客户端连接时由子类调用。 添加connectionId通过返回的列表JMXConnectorServerMBean.getConnectionIds() ，然后发出JMXConnectionNotification类型JMXConnectionNotification.OPENED 。

参数

connectionId - 新连接的ID。 这必须与此连接器服务器先前打开的任何连接的ID不同。

message - 发出的JMXConnectionNotification的消息。 可以为null。 见Notification.getMessage() 。

userData -该userData的发射JMXConnectionNotification 。 可以为null。 见Notification.getUserData() 。

异常

NullPointerException - 如果 connectionId为空。

connectionClosed

protected void connectionClosed(String connectionId,
                                String message,
                                Object userData)

当客户端连接正常关闭时由子类调用。 删除connectionId从返回的列表JMXConnectorServerMBean.getConnectionIds() ，然后发出JMXConnectionNotification类型JMXConnectionNotification.CLOSED 。

参数

connectionId - 已关闭连接的ID。

message - 发出的消息JMXConnectionNotification 。 可以为null。 见Notification.getMessage() 。

userData -该userData的发射JMXConnectionNotification 。 可以为null。 见Notification.getUserData() 。

异常

NullPointerException - 如果 connectionId为空。

connectionFailed

protected void connectionFailed(String connectionId,
                                String message,
                                Object userData)

客户端连接失败时由子类调用。 删除connectionId从返回的列表JMXConnectorServerMBean.getConnectionIds() ，然后发出JMXConnectionNotification类型JMXConnectionNotification.FAILED 。

参数

connectionId - 失败连接的ID。

message - 发出的JMXConnectionNotification的消息。 可以为null。 见Notification.getMessage() 。

userData - userData用于发出的JMXConnectionNotification 。 可以为null。 见Notification.getUserData() 。

异常

NullPointerException - 如果 connectionId为空。

preRegister

public ObjectName preRegister(MBeanServer mbs,
                              ObjectName name)

在此MBean服务器中注册此连接器服务器时由MBean服务器调用。 此连接器服务器将附加到MBean服务器，其getMBeanServer()方法将返回mbs 。

如果此连接器服务器已附加到MBean服务器，则此方法无效。 它所连接的MBean服务器不一定是它所注册的服务器。

Specified by:

preRegister ，界面 MBeanRegistration

参数

mbs - 正在注册此连接服务器的MBean服务器。

name - MBean的对象名称。

结果

要注册MBean的名称。

异常

NullPointerException - 如果 mbs或 name为空。

preDeregister

public void preDeregister()
                   throws 异常

当从该MBean服务器取消注册此连接器服务器时，由MBean服务器调用。 如果此连接器服务器通过在其中注册而连接到该MBean服务器，并且连接器服务器仍处于活动状态，则取消注册它将调用stop方法。 如果stop方法抛出异常，则取消注册尝试将失败。 建议在取消注册MBean之前显式调用stop方法。

Specified by:

preDeregister ，界面 MBeanRegistration

异常

IOException - 如果被 stop方法抛出。

异常 - 此异常将被MBean服务器捕获并重新抛出为MBeanRegistrationException 。