Module java.management

软件包 javax.management.remote

Interface JMXConnector

All Superinterfaces:

AutoCloseable ， Closeable

所有已知实现类：

RMIConnector

public interface JMXConnector
extends Closeable

JMX API连接器的客户端。 此类型的对象可用于建立与连接器服务器的连接。

这种类型的新创建的对象是未连接的。 它的connect方法必须先被调用才能使用。 但是，由JMXConnectorFactory.connect创建的对象已经连接。

从以下版本开始：

1.5

Field Summary

Fields

Modifier and Type	Field	描述
static String	CREDENTIALS	指定在连接期间发送到连接器服务器的凭据的属性的名称。

方法摘要

Modifier and Type	方法	描述
void	addConnectionNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)	添加一个监听器以通知连接状态的变化。
void	close()	关闭与其服务器的客户端连接。
void	connect()	建立与连接器服务器的连接。
void	connect(Map<String,?> env)	建立与连接器服务器的连接。
String	getConnectionId()	从连接器服务器获取此连接的ID。
MBeanServerConnection	getMBeanServerConnection()	返回表示远程MBean服务器的 MBeanServerConnection对象。
MBeanServerConnection	getMBeanServerConnection(Subject delegationSubject)	返回一个表示远程MBean服务器的 MBeanServerConnection对象，代表所提供的委托主体执行操作。
void	removeConnectionNotificationListener(NotificationListener listener)	从列表中删除一个监听器以通知状态更改。
void	removeConnectionNotificationListener(NotificationListener l, NotificationFilter f, Object handback)	从列表中删除一个监听器以通知状态更改。

字段详细信息

CREDENTIALS

static final String CREDENTIALS

指定在连接期间发送到连接器服务器的凭据的属性的名称。 与此属性相关联的值（如果有）为服务器JMXAuthenticator的适当类型的可序列化对象。

另请参见：

Constant Field Values

方法详细信息

connect

void connect()
      throws IOException

建立与连接器服务器的连接。 此方法相当于connect(null) 。

异常

IOException - 如果由于通信问题而无法建立连接。

SecurityException - 如果出于安全考虑，无法连接。

connect

void connect(Map<String,?> env)
      throws IOException

建立与连接器服务器的连接。

如果connect已经在此对象上成功调用，则再次调用它不起作用。 但是，如果close()被称为后connect ，新connect将抛出IOException 。

否则， connect从未在此对象上被调用，或者已被调用但产生异常。 然后拨打connect将尝试建立与连接器服务器的连接。

参数

env - 连接的属性。 此映射中的属性将覆盖创建JMXConnector时指定的映射中的属性（如果有）。 此参数可以为null，这相当于一个空的地图。

异常

IOException - 如果由于通信问题而无法建立连接。

SecurityException - 如果由于安全原因无法连接。

getMBeanServerConnection

MBeanServerConnection getMBeanServerConnection()
                                        throws IOException

返回表示远程MBean服务器的MBeanServerConnection对象。 对于给定的JMXConnector ，两个成功调用此方法通常会返回相同的MBeanServerConnection对象，尽管这不是必需的。

对于返回的MBeanServerConnection中的每个方法，调用该方法将导致在远程MBean服务器中调用相应的方法。 MBean服务器方法返回的值是返回给客户端的值。 如果MBean服务器方法产生一个异常 ，客户端可以看到相同的异常 。 如果MBean服务器方法，或者试图调用它，产生Error ，所述Error被包裹在一个JMXServerErrorException ，这是由客户端可见。

调用此方法相当于调用getMBeanServerConnection(null)，这意味着没有指定委托主体，并且所有在MBeanServerConnection上调用的操作必须使用已认证的主题（如果有）。

结果

通过将其方法转发到远程MBean服务器来实现 MBeanServerConnection接口的对象。

异常

IOException - 如果无法创建有效的 MBeanServerConnection ，例如因为尚未建立与远程MBean服务器的连接（使用 connect方法）或已关闭或已断开连接。

getMBeanServerConnection

MBeanServerConnection getMBeanServerConnection(Subject delegationSubject)
                                        throws IOException

返回一个表示远程MBean服务器的MBeanServerConnection对象，代表所提供的委托主体执行操作。 对于给定的JMXConnector和Subject ，两个成功调用此方法通常会返回相同的MBeanServerConnection对象，尽管这不是必需的。

对于返回的MBeanServerConnection中的每个方法，调用该方法将导致在远程MBean服务器中代表给定的授权对象而不是经过身份验证的主题调用相应的方法。 MBean服务器方法返回的值是返回给客户端的值。 如果MBean服务器方法生成异常 ，客户端可以看到相同的异常 。 如果MBean服务器方法，或者试图调用它，产生Error ，所述Error被包裹在一个JMXServerErrorException ，这是由客户端可见。

参数

delegationSubject - 代表将要执行的请求的Subject 。 可以为null，在这种情况下，将代表被认证的主题（如果有的话）执行请求。

结果

通过代表给定的授权主体将其方法转发到远程MBean服务器来实现 MBeanServerConnection接口的对象。

异常

IOException - 如果无法创建有效的 MBeanServerConnection ，例如因为尚未建立与远程MBean服务器的连接（使用 connect方法）或已关闭或已断开连接。

close

void close()
    throws IOException

关闭与其服务器的客户端连接。 使用由getMBeanServerConnection()返回的MBeanServerConnection的任何正在进行的或新的请求都将获得IOException 。

如果close已经在此对象上成功调用，则再次调用它不起作用。 如果close从未被调用，或者如果被调用但产生异常，则将尝试关闭连接。 这个尝试可以成功，在这种情况下， close将正常返回，否则会产生异常。

关闭连接是一个潜在的慢操作。 例如，如果服务器崩溃，则关闭操作可能需要等待网络协议超时。 不想封闭操作的调用者应该在单独的线程中执行。

Specified by:

close在接口 AutoCloseable

Specified by:

close在接口 Closeable

异常

IOException - 如果连接不能被干净地关闭。 如果抛出此异常，则不知道连接的服务器端是否已完全关闭。

addConnectionNotificationListener

void addConnectionNotificationListener(NotificationListener listener,
                                       NotificationFilter filter,
                                       Object handback)

添加一个监听器以通知连接状态的变化。 收听者将收到类型为JMXConnectionNotification的通知。 一个实现也可以发送其他类型的通知。

可以使用此方法添加任意数量的侦听器。 可以使用相同或不同的过滤器和回传值，多次添加相同的侦听器。 重复条目没有特殊处理。 例如，如果一个监听器被注册了两次，没有过滤器，那么它的handleNotification方法将被调用两次通知。

参数

listener - 接收连接状态通知的侦听器。

filter - 用于选择要将哪些通知传递给侦听器的过滤器，如果要传送所有通知，则为null。

handback - 与每个通知一起提供给侦听器的对象。 可以为null。

异常

NullPointerException - 如果 listener为空。

另请参见：

removeConnectionNotificationListener(javax.management.NotificationListener) ， NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

void removeConnectionNotificationListener(NotificationListener listener)
                                   throws ListenerNotFoundException

从列表中删除一个监听器以通知状态更改。 以前必须添加侦听器。 如果有多个匹配的侦听器，则全部被删除。

参数

listener - 接收连接状态通知的侦听器。

异常

NullPointerException - 如果 listener为空。

ListenerNotFoundException - 如果监听器未注册此 JMXConnector 。

另请参见：

removeConnectionNotificationListener(NotificationListener, NotificationFilter, Object) ， addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) ， NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

void removeConnectionNotificationListener(NotificationListener l,
                                          NotificationFilter f,
                                          Object handback)
                                   throws ListenerNotFoundException

从列表中删除一个监听器以通知状态更改。 先前已经添加了同样的三个参数的侦听器。 如果有多个匹配的侦听器，只有一个被删除。

参数

l - 接收连接状态通知的侦听器。

f - 一个过滤器，用于选择要将哪些通知传递给收听者。 可以为null。

handback - 与每个通知一起提供给侦听器的对象。 可以为null。

异常

ListenerNotFoundException - 如果收听者未注册此 JMXConnector ，或未注册给定的过滤器和回传。

另请参见：

removeConnectionNotificationListener(NotificationListener) ， addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) ， NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

getConnectionId

String getConnectionId()
                throws IOException

从连接器服务器获取此连接的ID。 对于给定的连接器服务器，每个连接将具有唯一的ID，在连接的生命周期内不会更改。

结果

此连接的唯一ID。 这与连接器服务器在其JMXConnectionNotification中包含的ID相同。 package description描述了连接ID的约定。

异常

IOException - 如果无法获取连接ID，例如因为连接被关闭或断开。