Package javax.management.remote

用于远程访问JMX MBean服务器的接口。

See: 描述

接口摘要

接口	描述
JMXAddressable	由具有 JMXServiceURL地址的对象实现。
JMXAuthenticator	用于定义远程凭据如何转换为JAAS主题的界面。
JMXConnector	JMX API连接器的客户端。
JMXConnectorProvider	使用给定协议创建JMX API连接器客户端的提供程序。
JMXConnectorServerMBean	连接器服务器的MBean接口。
JMXConnectorServerProvider	使用给定协议创建JMX API连接器服务器的提供程序。
MBeanServerForwarder	此类的一个对象实现MBeanServer接口并包装另一个也实现该接口的对象。

类摘要

类	描述
JMXConnectionNotification	客户端连接打开或关闭或通知丢失时发出的通知。
JMXConnectorFactory	工厂创建JMX API连接器客户端。
JMXConnectorServer	每个连接器服务器的超类。
JMXConnectorServerFactory	工厂创建JMX API连接器服务器。
JMXPrincipal	JMX Remote API的远程客户端的身份。
JMXServiceURL	JMX API连接器服务器的地址。
NotificationResult	对缓冲通知的查询结果。
SubjectDelegationPermission	认证身份所需的权限代表授权身份执行操作。
TargetedNotification	A（通知，听众ID）对。

异常摘要

异常	描述
JMXProviderException	例外由抛出JMXConnectorFactory和JMXConnectorServerFactory当存在所需的协议提供者，但不能用于由于某些原因。
JMXServerErrorException	当处理远程MBean服务器中的Error时抛出一个Error时，由于远程MBeanServer方法调用的结果抛出异常。

Package javax.management.remote Description

用于远程访问JMX MBean服务器的接口。 该包定义了使JMX MBean服务器可远程管理的基本界面。 该功能的规范由JMX Specification, version 1.4 PDF文档的第III部分完成。

JMX规范定义的连接器的概念。 连接器连接到JMX API MBean服务器，并使其可以访问远程Java客户端。 连接器的客户端导出与MBean服务器基本相同的界面，特别是MBeanServerConnection接口。

连接器使得MBean服务器可以通过给定的协议远程访问。 JMX Remote API允许使用不同类型的连接器：

• JMX Remote API定义了一个标准连接器RMI Connector ，它通过RMI提供对MBeanServer的远程访问。
• JMX Remote API还定义了一个名为JMXMP Connector的可选连接器，实现了JMX消息协议（JMXMP）。 由于它是可选的，它不属于此捆绑包（见下面的注释）。
• 用户定义的连接器协议也可以使用JMXConnectorFactory和可选的通用连接器（不包括此捆绑包的一部分，请参见下面的注释）。

注意 ：实现JMX Remote API可选部分的可选软件包不包括在Java SE平台中，但可从JMX Remote API Reference Implementation获得 。

连接器地址

通常，连接器服务器具有由类别JMXServiceURL表示的地址。 RMI连接器的地址可能如下所示：

  service:jmx:rmi:///jndi/rmi://myhost:1099/myname 

在这个JMXServiceURL ，第一个rmi:指定了RMI连接器，而第二个rmi:指定了RMI连接器服务器已存储其存根的RMI注册表。

上面的例子只显示一种形式的地址。 RMI连接器的地址可以采用多种形式，如包javax.management.remote.rmi的文档中所javax.management.remote.rmi 。

创建连接器服务器

一种连接器，服务器是通过构造的子类的实例创建JMXConnectorServer 。 通常，此实例是使用方法JMXConnectorServerFactory.newJMXConnectorServer创建的。

通常，连接器服务器通过在MBean服务器中注册或通过在创建连接器服务器时提供MBean服务器作为参数与MBean服务器相关联。

创建连接器客户端

一种连接器，客户机通常是通过提供所创建的JMXServiceURL连接器服务器的连接到至JMXConnectorFactory.connect方法。

为更专门的用途，连接器客户端可以通过直接实例化一个实现一个类创建JMXConnector接口，例如类RMIConnector 。

其他客户端或服务器参数

创建连接器客户端或服务器时，可以提供定义其他参数的类型为Map的对象。 此Map中的每个条目都有一个键，它是一个字符串和一个相关联的值，其类型适用于该键。 由JMX Remote API定义的标准键都以字符串“ jmx.remote. ”开头。 文档JMX Remote API列出了这些标准密钥。

连接标识符

连接器服务器打开的每个连接都有一个字符串标识符，称为连接ID 。 该标识符出现在由连接器服务器发出的JMXConnectionNotification事件中，在由getConnectionIds()返回的列表中，以及由客户端的getConnectionId()方法返回的值。

例如，连接ID可以如下所示：

  rmi://192.18.1.9 username 1 

遵循此约定的连接ID的正式语法如下（使用Java语言规范第2.4节中的语法符号）：

  ConnectionId:
    Protocol : ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
    // HostAddress ClientPortopt

ClientPort
    : HostPort 

Protocol是一个将被JMXConnectorFactory识别的协议 。

ClientAddress是连接客户端的地址和端口，如果可以确定，否则没有。 HostAddress是客户端从数字或DNS形式连接的主机的Internet地址。 数字IPv6地址用方括号[]括[] 。 HostPort是客户端连接的十进制端口号。

ClientId是客户端实体的标识，通常是由JMXPrincipal.getName()返回的字符串 。 此字符串不能包含空格。

ArbitraryText是创建客户端标识时连接器服务器添加的任何其他文本。 至少必须将此连接ID与此连接器服务器当前打开的任何其他连接的ID区分开来。

从以下版本开始：

1.5

另请参见：

Java Platform documentation on JMX technology, in particular the JMX Specification, version 1.4