1、前言
JMX管理及使用日趨成熟。spring對(duì)bean的管理功能也很強(qiáng)大，通過(guò)annotation把某些方法暴露成MBean，然后通過(guò)JMX遠(yuǎn)程管理，在某些場(chǎng)景下會(huì)帶來(lái)意想不到的效果。
?
本文只介紹兩個(gè)內(nèi)容：spring通過(guò)annotation暴露MBean、相關(guān)的xml配置。
?
?
2、spring通過(guò)annotation暴露MBean
?
??????2.1?? 涉及到三個(gè)重要的annotation：@ManagedResource @ManagedAttribute 和 @ManagedOperation。
?
用途 Commons Attributes屬性 JDK 5.0注解 屬性/注解類型
| 將類的所有實(shí)例標(biāo)識(shí)為JMX受控資源 |
ManagedResource
|
@ManagedResource
|
Class 類 |
| 將方法標(biāo)識(shí)為JMX操作 |
ManagedOperation
|
@ManagedOperation
|
Method方法 |
| 將getter或者setter標(biāo)識(shí)為部分JMX屬性 |
ManagedAttribute
|
@ManagedAttribute
|
Method (only getters and setters) 方法（僅getters和setters） |
|
定義操作參數(shù)說(shuō)明
|
ManagedOperationParameter
|
@ManagedOperationParameter和@ManagedOperationParameters
|
Method 方法
|
?
?
????2.2?? 看了上面官方解釋，應(yīng)該有個(gè)大概的了解，下面再舉個(gè)例子。
?
-
@ManagedResource
(objectName=
"bean:name=lionbuleTest"
,?description=
"My?Managed?Bean"
)??
-
public
?
class
?AnnotationTestMBean{??
-
????private?String?name;??
-
????private?int?age;??
-
??????
-
????@ManagedAttribute(description="The?Name?Attribute")??
-
????public?void?setName(String?name)?{??
-
????????this.name?=?name;??
-
????}??
-
??
-
????@ManagedAttribute()??
-
????public?String?getName()?{??
-
????????return?name;??
-
????}????
-
????public?int?getAge()?{??
-
????????return?age;??
-
????}??
-
????public?void?setAge(int?age)?{??
-
????????this.age?=?age;??
-
????}??
-
??????
-
????@ManagedOperation(description="Add?two?numbers")??
-
????@ManagedOperationParameters({??
-
????@ManagedOperationParameter(name?=?"x",?description?=?"The?first?number"),??
-
????@ManagedOperationParameter(name?=?"y",?description?=?"The?second?number")})??
-
????public?int?add_1(int?x,?int?y)?{??
-
????????return?x?+?y;??
-
????}??
-
??
-
????@ManagedOperation??
-
????public?int?add_2(int?x,?int?y){??
-
????????return?x?+?y;??
-
????}??
-
????
-
????public?void?dontExposeMe()?{??
-
????????throw?new?RuntimeException();??
-
????}??
-
??
-
}??
?
???2.3??Jconsole的管理界面截圖：
?
圖1、查看已暴露MBean的屬性
?
圖2、查看已暴露MBean的方法
?
???2.4?? 解釋說(shuō)明：
?
???????? 1、@ManagedResource?@ManagedAttribute 和 @ManagedOperation?還有許多參數(shù)，具體使用請(qǐng)參考spring官方手冊(cè)。(?spring手冊(cè)[2.5.3] ---- 20.3.4.?源代碼級(jí)的元數(shù)據(jù)類型)
?
???????? 2、@ManagedOperationParameters 是對(duì)@ManagedOperation的補(bǔ)充。具體看代碼樣例中的add1方法上的注解，然后再看圖2(查看已暴露MBean的方法)的add1方法和add2的區(qū)別。添加參數(shù)說(shuō)明的add1方法會(huì)顯示出參數(shù)名，而add2方法則是默認(rèn)的參數(shù)名p1/p2。
?
???????? 3、沒(méi)有添加@ManagedOperation和@ManagedAttribute的方法，在圖2中就沒(méi)有看到，說(shuō)明添加了注解的方法暴露MBean是可用的。
?
???????? 4、@ManagedOperation和@ManagedAttribute的區(qū)別，請(qǐng)查看2.1的詳解。
?
3、xml配置
? ? 方式一、通用spring bean配置
-
???
<
bean
?
id
=
"jmxAttributeSource"
??
-
?????????class="org.springframework.jmx.export.annotation.AnnotationJmxAttributeSource"/>??
-
?????
-
???<bean?id="assembler"??
-
?????????class="org.springframework.jmx.export.assembler.MetadataMBeanInfoAssembler">??
-
???????<property?name="attributeSource"?ref="jmxAttributeSource"/>??
-
???</bean>??
-
?????
-
???<bean?id="namingStrategy"??
-
?????????class="org.springframework.jmx.export.naming.MetadataNamingStrategy">??
-
???????<property?name="attributeSource"?ref="jmxAttributeSource"/>??
-
???</bean>??
-
???<bean?id="exporter"?class="org.springframework.jmx.export.MBeanExporter">??
-
???????<property?name="assembler"?ref="assembler"/>??
-
???????<property?name="namingStrategy"?ref="namingStrategy"/>??
-
???????<property?name="autodetect"?value="true"/>??
-
???</bean>??
-
??
-
??
-
<
bean
?
class
=
"org.springframework.remoting.rmi.RmiRegistryFactoryBean"
>
??????????
-
????<property?name="port"?value="2088"/>??
-
</
bean
>
??
-
<
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:2088/myconnector"/>??
-
</
bean
>
??
-
??
-
??
-
???<bean?id="annotationTestMBean"?class="com.lionbule.biz.test.AnnotationTestMBean">??
-
???????<property?name="name"?value="TEST"/>??
-
???????<property?name="age"?value="100"/>??
-
???</bean>??
??? 配置中，已經(jīng)加了相應(yīng)的注釋。還不是很清楚，可以查詢spring官方手冊(cè)。
?
? ? 方式二、簡(jiǎn)化spring-context配置
-
<?
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"??
-
????xsi:schemaLocation="http://www.springframework.org/schema/beans??
-
????????????????????????http://www.springframework.org/schema/beans/spring-beans.xsd??
-
????????????????????????http://www.springframework.org/schema/context??
-
????????????????????????http://www.springframework.org/schema/context/spring-context.xsd"??
-
????default-autowire="byName">??
-
??
-
????<context:mbean-export?default-domain="ShowCase"?registration="replaceExisting"?/>??
-
??????
-
????<bean?id="annotationTestMBean"?class="com.lionbule.biz.test.AnnotationTestMBean">??
-
????????<property?name="name"?value="TEST"/>??
-
????????<property?name="age"?value="100"/>??
-
????</bean>??
-
</
beans
>
??
? ??注意：方式二對(duì)ClassName和beanName有約束，請(qǐng)以‘MBean’結(jié)尾。?
?
4、客戶端工具連接
?
??? 常用的客戶端工具：Jconsole、jvisualvm、jmanager等。
??? 連接方式有多種，但本案只介紹了RMI連接管理，所以本案的鏈接地址為：
-
service:jmx:rmi://localhost/jndi/rmi://localhost:2088/myconnector??
?
參考資料：
1、spring官方手冊(cè)
?????http://static.springsource.org/spring/docs/2.5.x/reference/jmx.html#jmx-interface
2. ?http://wiki.springside.org.cn/display/SpringSide3/JMX