使用 JSR-160 连接器
对于远程访问,Spring JMX 模块在 org.springframework.jmx.support
包中提供了两个 FactoryBean
实现,用于创建服务器端和客户端连接器。
服务器端连接器
要让 Spring JMX 创建、启动和暴露一个 JSR-160 JMXConnectorServer
,你可以使用以下配置:
<bean id="serverConnector" class="org.springframework.jmx.support.ConnectorServerFactoryBean"/>
默认情况下,ConnectorServerFactoryBean
会创建一个绑定到 service:jmx:jmxmp://localhost:9875
的 JMXConnectorServer
。因此,serverConnector
bean 通过 JMXMP 协议在 localhost 的 9875 端口向客户端暴露本地 MBeanServer
。请注意,JMXMP 协议被 JSR 160 规范标记为可选。目前,主要的开源 JMX 实现 MX4J 以及 JDK 提供的实现都不支持 JMXMP。
要指定另一个 URL 并将 JMXConnectorServer
本身注册到 MBeanServer
,你可以分别使用 serviceUrl
和 ObjectName
属性,如下例所示:
<bean id="serverConnector"
class="org.springframework.jmx.support.ConnectorServerFactoryBean">
<property name="objectName" value="connector:name=rmi"/>
<property name="serviceUrl"
value="service:jmx:rmi://localhost/jndi/rmi://localhost:1099/myconnector"/>
</bean>
如果设置了 ObjectName
属性,Spring 会自动将你的连接器以该 ObjectName
注册到 MBeanServer
。以下示例显示了创建 JMXConnector
时可以传递给 ConnectorServerFactoryBean
的所有参数:
<bean id="serverConnector"
class="org.springframework.jmx.support.ConnectorServerFactoryBean">
<property name="objectName" value="connector:name=iiop"/>
<property name="serviceUrl"
value="service:jmx:iiop://localhost/jndi/iiop://localhost:900/myconnector"/>
<property name="threaded" value="true"/>
<property name="daemon" value="true"/>
<property name="environment">
<map>
<entry key="someKey" value="someValue"/>
</map>
</property>
</bean>
请注意,当你使用基于 RMI 的连接器时,你需要启动查找服务(tnameserv
或 rmiregistry
)才能完成名称注册。
客户端连接器
要创建到远程 JSR-160 启用的 MBeanServer
的 MBeanServerConnection
,你可以使用 MBeanServerConnectionFactoryBean
,如下例所示:
<bean id="clientConnector" class="org.springframework.jmx.support.MBeanServerConnectionFactoryBean">
<property name="serviceUrl" value="service:jmx:rmi://localhost/jndi/rmi://localhost:1099/jmxrmi"/>
</bean>
通过 Hessian 或 SOAP 实现 JMX
JSR-160 允许扩展客户端和服务器之间的通信方式。前面几节中显示的示例使用了 JSR-160 规范(IIOP 和 JRMP)要求的强制性基于 RMI 的实现以及(可选的)JMXMP。通过使用其他提供者或 JMX 实现(例如 MX4J),你可以利用诸如通过简单 HTTP 或 SSL 的 SOAP 或 Hessian 等协议,如下例所示:
<bean id="serverConnector" class="org.springframework.jmx.support.ConnectorServerFactoryBean">
<property name="objectName" value="connector:name=burlap"/>
<property name="serviceUrl" value="service:jmx:burlap://localhost:9874"/>
</bean>
在前面的示例中,我们使用了 MX4J 3.0.0。有关更多信息,请参阅 MX4J 官方文档。