这是三篇文章的第一篇,这三篇文章将展示如何通过JMX支持为Spring应用程序赋能。
Maven配置
这是用于设置此示例代码的Maven pom.xml:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>uk.co.jemos.experiments.jmx</groupId>
<artifactId>jemos-jmx-experiments</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>jemos-jmx-experiments</name>
<description>Jemos JMX Experiments</description>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.6</source>
<target>1.6</target>
</configuration>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.8.2</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.16</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>3.0.5.RELEASE</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>3.0.5.RELEASE</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jmx</artifactId>
<version>2.0.8</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>3.0.5.RELEASE</version>
<type>jar</type>
<scope>test</scope>
</dependency>
</dependencies>
</project>
弹簧配置
Spring配置非常简单:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xmlns:util="http://www.springframework.org/schema/util"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd">
<context:property-placeholder location="classpath:jemos-jmx.properties" />
<bean id="rmiRegistry" class="org.springframework.remoting.rmi.RmiRegistryFactoryBean">
<property name="port" value="${jemos.jmx.rmi.port}" />
</bean>
<bean id="jemosJmxServer" class="org.springframework.jmx.support.ConnectorServerFactoryBean"
depends-on="rmiRegistry" >
<property name="objectName" value="connector:name=rmi" />
<property name="serviceUrl"
value="service:jmx:rmi://localhost/jndi/rmi://localhost:${jemos.jmx.rmi.port}/jemosJmxConnector" />
<property name="environment">
<!-- the following is only valid when the sun jmx implementation is used -->
<map>
<entry key="jmx.remote.x.password.file" value="${user.home}/.secure/jmxremote.password" />
<entry key="jmx.remote.x.access.file" value="${user.home}/.secure/jmxremote.access" />
</map>
</property>
</bean>
</beans>
此配置虽然很简单,但可以满足以下所有要求:
- 从您的Spring应用程序上下文中启动JMX服务器
- 通过远程RMI URL公开对JMX服务器的访问
- 通过身份验证和授权保护对JMX服务器的访问
关于上述配置的几点注意事项:
- 您想外部化一些配置信息,例如RMI注册表端口和应用程序运行所在的主机。 尽管我将RMI注册表端口外部化为类路径中的属性文件,但我将“ localhost”保留为主机名。 在实际的生产环境中,尤其是当您想水平扩展应用程序(例如,将其部署在不同的服务器上)时,远程URL的服务器部分也应该外部化。
- 因为我们要公开一个远程RMI URL,所以为了将JMX服务器公开给RMI注册表,如果尚未启动一个RMI注册表,则需要启动它。 这是通过声明RmiRegistryFactoryBean发生的。 启动注册表的端口必须与公开的URL相同。
- 上面的配置未启用基于注释的MBean支持。 这种配置将成为我下一篇文章的主题,在该文章中,我将展示如何编写简单的MBean来更改基于Log4j的应用程序的日志记录级别。 通过身份验证和授权保护对JMX服务器的访问
在以上配置中,您可能已经注意到以下部分:
<property name="environment">
<!-- the following is only valid when the sun jmx implementation is used -->
<map>
<entry key="jmx.remote.x.password.file" value="${user.home}/.secure/jmxremote.password" />
<entry key="jmx.remote.x.access.file" value="${user.home}/.secure/jmxremote.access" />
</map>
</property>
上面的代码段声明的是两个文件的位置,一个用于授权,一个用于认证。 我决定将此类文件放在〜/ .secure下,但该位置最终取决于您。 这些文件的内容很简单:
JMX访问文件
jemosAdmin读写
上面的文件包含一个用户名(jemosAdmin)及其角色(readwrite)。
JMX密码文件
在JMX密码文件中,您声明用户及其密码:
jemosAdmin安全
这些信息到位后,您可以启动JMX服务器,然后通过jconsole或jvisualvm(如果使用的是JDK6或更高版本)访问它。
身份验证之后,RMI连接器实际上就可以作为Bean使用,所有Oracle的本地MBean一样。
在我的下一篇文章中,我将展示如何编写一个简单的Logging MBean服务的代码,该服务可在运行时用于更改包(及其所有子包)的日志记录级别。 这项服务带来了增加正常运行时间的优势,并有助于对应用程序进行故障排除。
继续第2部分 。
参考: JMX和Spring –我们的JCG合作伙伴 Marco Tedone的第1部分 ,位于Marco Tedone的博客博客中。
翻译自: https://www.javacodegeeks.com/2012/07/jmx-and-spring-part-1.html