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远程API远程客户端的身份。
JMXServiceURL	一个JMX API接口服务器的地址。
NotificationResult	用于缓冲通知的查询的结果。
SubjectDelegationPermission	由身份验证身份所需的权限，以代表授权身份进行操作。
TargetedNotification	一个（通知，侦听器）对。

异常摘要

异常	描述
JMXProviderException	例外被 JMXConnectorFactory和 JMXConnectorServerFactory当供应商存在所需的协议但不能用于某些原因。
JMXServerErrorException	异常作为一个远程 MBeanServer方法调用的结果，当一个 Error扔在偏僻的MBean服务器调用处理。

Package javax.management.remote Description

用于远程访问JMX MBean服务器接口。此包定义做一个JMX MBean服务器远程管理的必备接口。此功能的规范是由 JMX Specification, version 1.4 PDF文档三部分完成。

JMX规范定义了连接器概念。连接器连接到一个JMX MBean服务器和API使得远程java客户端访问。一个连接器客户端出口基本接口作为MBean服务器相同，特别是MBeanServerConnection接口。

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

• JMX远程API定义了一个标准的连接器，该RMI连接器，通过RMI提供远程访问一个MBeanServer。
• JMX远程API还定义了一个可选的连接称为jmxmp连接器实现JMX消息协议（jmxmp）。由于它是可选的，它不是这个包的一部分（见下面的说明）。
• 用户定义的接口协议也使用JMXConnectorFactory可能和可选的通用连接器（不是这束，部分见下面的说明）。

注：实现JMX远程可选部分API不包括在java SE平台但可从JMX远程API的参考实现的可选包。

连接地址

通常，一个连接服务器的地址，由该类JMXServiceURL代表。在RMI连接器地址可以是这个样子的：

服务：JMX：RMI：/ / / / / / Myhost JNDI RMI：：1099 /我的名字

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

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

创建连接器服务器

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

通常情况下，连接器服务器是一个MBean服务器通过它注册在MBean服务器相关的，或通过提供MBean服务器作为一个参数创建连接器服务器时。

创建连接器客户端

连接器客户端通常是由连接到JMXConnectorFactory.connect方法提供连接器的服务器JMXServiceURL创建。

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

额外的客户端或服务器参数

创建一个连接的客户端或服务器时，它可以提供Map型定义额外的参数对象。在这个Map中的每个条目都有一个键，它是一个字符串和一个相关的值，该值的类型是适合该键的。标准键定义的JMX远程API都开始以字符串“jmx.remote.”。JMX远程API文档列出了这些标准键。

连接标识符

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

作为一个例子，一个连接标识可以看起来像这样：

RMI：/ / 192.18.1.9用户名1

连接ID，按照本公约的正式语法如下（使用java语言规范的™2.4节的语法符号）：

ConnectionId：协议：clientaddressopt空间clientidopt空间arbitrarytextClientAddress：clientportopt /主机地址clientport：hostport

的Protocol是会被JMXConnectorFactory协议。

是的ClientAddress地址和连接客户端的端口，如果这些可以确定，否则没有什么。是的HostAddress互联网地址的主机客户端连接，数字或DNS形式。数字的IPv6地址括在方括号中[]。的HostPort是客户端连接的端口号从小数。

是的ClientId客户单位的身份，通常返回的字符串JMXPrincipal.getName()。此字符串不能包含空格。

是的ArbitraryText任何其他文本连接服务器时加创建客户端ID。至少，它必须足够区分此连接ID从任何其他连接的身份通过此连接器服务器当前打开的。

从以下版本开始：

1.5

另请参见：

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