-
- 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,例如因为连接被关闭或断开。
-
-