compact3

javax.management.remote

Interface JMXConnectorServerMBean

所有已知实现类：

JMXConnectorServer， RMIConnectorServer

public interface JMXConnectorServerMBean

MBean接口连接器服务器。JMX API连接器服务器连接到一个MBean服务器，并建立了以MBean为远程客户端连接服务器。

一个新创建的连接器服务器处于无效状态，并且还没有侦听连接。只有当start方法被调用时它开始侦听连接。

从以下版本开始：

一点五

方法摘要

Modifier and Type	Method and Description
JMXServiceURL	getAddress() 此连接器服务器的地址。
Map<String,?>	getAttributes() 此连接器服务器的属性。
String[]	getConnectionIds() 当前打开的连接到该连接器服务器的入侵检测系统列表。
boolean	isActive() 确定连接器服务器是否已激活。
void	setMBeanServerForwarder(MBeanServerForwarder mbsf) 插入一个对象，截取MBean服务器到服务器的请求，通过此连接器。
void	start() 激活连接器服务器，即开始侦听客户端连接。
void	stop() 停用连接服务器，即停止侦听客户端连接。
JMXConnector	toJMXConnector(Map<String,?> env) 返回此连接器服务器的客户端存根。

方法详细信息

start

void start()
    throws IOException

激活连接器服务器，即开始侦听客户端连接。调用此方法时，连接器服务器已经激活，没有任何效果。调用此方法时，连接器服务器已停止将产生一个IOException。

异常

IOException -如果它不可能开始听或者连接器服务器已停止。

IllegalStateException如果连接器服务器没有连接到一个MBean服务器。

stop

void stop()
   throws IOException

停用连接服务器，即停止侦听客户端连接。调用此方法也将关闭此服务器所做的所有客户端连接。此方法返回后，无论是正常还是异常，连接器服务器将不会创建任何新的客户端连接。

一旦连接器服务器已被停止，它不能再次启动。

调用此方法时，连接器服务器已被停止，没有任何效果。调用此方法当连接器服务器尚未启动时，将永久禁用连接器服务器对象。

如果关闭客户端连接产生一个异常，则不会从该方法中抛出异常。一种类型JMXConnectionNotification.FAILED JMXConnectionNotification发出这MBean的连接，无法关闭连接ID。

关闭连接器服务器是一个潜在的缓慢操作。例如，如果一个开放连接的客户机已崩溃，关闭操作可能必须等待网络协议超时。不想阻塞关闭操作的调用方应在另一个线程中这样做。

异常

IOException -如果服务器不能关闭干净。当抛出此异常时，服务器已试图关闭所有客户端连接。所有的客户端连接都关闭，除非当服务器试图关闭它们时产生异常的情况除外。

isActive

boolean isActive()

确定连接器服务器是否已激活。连接器服务器开始活跃的start方法成功返回时，仍然有效，直到其stop方法被调用或连接服务器失败。

结果

如果连接器服务器是活动的。

setMBeanServerForwarder

void setMBeanServerForwarder(MBeanServerForwarder mbsf)

插入一个对象，截取MBean服务器到服务器的请求，通过此连接器。这个对象将提供任何新的连接通过此连接器服务器创建的MBeanServer。现有的连接不受影响。

这种方法可以称为一次以上不同MBeanServerForwarder对象。其结果是一个链的代理。最后一个加入的是链中的第一个。更详细的：

• 如果此连接器服务器已与MBeanServer对象相关的对象，然后给mbsf.setMBeanServer。如果这样做产生的一个例外，这个方法抛出同样的异常没有任何影响。

• 如果这个连接器是不是已经有MBeanServer对象相关，或者mbsf.setMBeanServer调用刚才提到成功，然后mbsf成为该连接器服务器的MBeanServer。

参数

mbsf -新的 MBeanServerForwarder。

异常

IllegalArgumentException -如果调用失败， IllegalArgumentException mbsf.setMBeanServer。这包括的情况下， mbsf是空的。

getConnectionIds

String[] getConnectionIds()

当前打开的连接到该连接器服务器的入侵检测系统列表。

结果

一个包含入侵检测列表列表的新字符串数组。如果没有当前打开的连接，这个数组将是空的。

getAddress

JMXServiceURL getAddress()

此连接器服务器的地址。

返回的地址可能不准确的原始JMXServiceURL，提供创建连接器服务器时，由于原来的地址不一定是完整的。例如，当启动连接器服务器时，可以动态分配端口号。相反，返回的地址是实际的JMXConnectorServer JMXServiceURL。这是JMXConnectorFactory.connect(JMXServiceURL)供应客户的地址。

注意，返回的地址可能null如果JMXConnectorServer尚未active。

结果

此连接器服务器的地址，或为空，如果它没有。

getAttributes

Map<String,?> getAttributes()

此连接器服务器的属性。

结果

包含此连接器服务器的属性的只读Map。其值是不可序列化的属性是从这个图略。如果没有序列化的属性，返回Map是空的。

toJMXConnector

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

返回此连接器服务器的客户端存根。客户端存根是可序列化的对象的connect方法可以用来使一个新的连接，这个连接服务器。

一个给定的连接器不需要支持客户端存根的生成。然而，通过JMX远程指定的连接器API做的（jmxmp连接器和RMI连接器）。

参数

env -相同的排序，可以提供给 JMXConnector.connect(Map)客户端连接参数。可以是空的，这相当于一个空的Map。

结果

可以用于向该连接器服务器上的新连接的客户端存根。

异常

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

IllegalStateException -如果jmxconnectorserver不启动（见 isActive()）。

IOException -如果一个通信问题意味着一个不能被创造。