JMX指南

转载 http://oss.org.cn/ossdocs/java/jmx/jmx.html
JMX指南（一）

JMX可以用来管理网络，设备，应用程序等资源，当前规范为1.1版。
JMX的结构

在JMX中共分为三层
1：Instrumentation
2：Agent
3：Distributed Services
JMX的优点：

1：可以非常容易的使应用程序具有被管理的功能
2：提供具有高度伸缩性的架构
每个JMX Agent服务可以很容易的放入到Agent中，每个JMX的实现都提供几个核心的Agent服务，你也可以自己编写服务，服务可以很容易的部署，取消部署。
3：集成了现有的一些管理解决方案，如SNMP
4：非常容易的利用其他java技术
5：主要提供接口，允许有不同的实现
在JMX的规范中，只讲述了前两部分，分布式服务并没有涉及到，jmx规范还在不断完善中

上面的这个图是jmx in action中的一副JMX的结构图，通过上面这个图，我们可以将JMX的层次分的更清楚一点。
通常我们需要写一个Bean（Managed bean，简称MBean），利用这个bean去管理资源。
基本概念：

1:MBean
通常是一个java类，它提供接口可以使这个类具有管理功能（如standard MBean，接口中定义的方法使MBean具有管理功能）。
2：MBean server
是管理MBean的一个java类，你需要向MBean server注册一个MBean后，这个MBean才会具有管理功能，MBean server还提供了查询功能和注册监听器的功能，sun提供的只是接口，不同的jmx实现中的MBean server实现也不同。
3：JMX agent
agent是为了管理一系列的MBean，而提供的一系列的服务，如上图所示，通常有MBean relationships, dynamically loading classes, simple monitoring services, timers。agent可以利用Protocol adapters（例如HTTP 和SNMP）和connectors（RMI 和Jini）使不同的客户端可以访问MBean。
4：Protocol adapters 和connectors
适配器和连接器主要使不同的协议和客户端可以使用这个agent，一个agent中可以有多个Protocol adapters 和connectors，这样管理起MBean来就更方便了（有多种类型的客户端和协议可以操作MBean）。注意，Protocol adapters 和connectors通常也是MBean。
MBean的类型

JMX1.1相对于1.0有了很大改进，在1.1中提供4种类型的MBean，3,4两种MBean都是特殊类型的dynamic MBean。
1：standard MBean
2：dynamic MBean
3：open MBean
4：model MBean
类型 描述
standard MBean 这种类型的MBean最简单，它能管理的资源（包括属性，方法，时间）必须定义在接口中，然后MBean必须实现这个接口。它的命名也必须遵循一定的规范，例如我们的MBean为Hello，则接口必须为HelloMBean。
dynamic MBean 必须实现javax.management.DynamicMBean接口，所有的属性，方法都在运行时定义
open MBean 此MBean的规范还不完善，正在改进中
model MBean 与标准和动态MBean相比，你可以不用写MBean类，只需使用javax.management.modelmbean.RequiredModelMBean即可。RequiredModelMBean实现了ModelMBean接口，而ModelMBean扩展了DynamicMBean接口，因此与DynamicMBean相似，Model MBean的管理资源也是在运行时定义的。与DynamicMBean不同的是，DynamicMBean管理的资源一般定义在DynamicMBean中（运行时才决定管理那些资源），而model MBean管理的资源并不在MBean中，而是在外部（通常是一个类），只有在运行时，才通过set方法将其加入到model MBean中。后面的例子会有详细介绍
Standard MBean编程简介


上面我们已经提到了编写这种类型MBean的规则
1：编写接口
2：编写MBean
3：编写agent
下面看接口的代码，very easy，主要定义get/get方法和其它你想使用的方法

public interface HelloWorldMBean
{
public void setGreeting( String greeting );

public String getGreeting();

public void printGreeting();
}

再看MBean的代码，跟传统的Bean非常相似，加入某个属性只有get方法，则说明这个属性是只读的，get/set都有的话，说明这个属性是可读可写的，此MBean只定义了一个属性 greeting。另外还定义了一个方法printGreeting。

public class HelloWorld implements HelloWorldMBean 
{

private String greeting = null;

public HelloWorld() 
{
this.greeting = "Hello World! I am a Standard MBean"; 
} 

public HelloWorld( String greeting ) 
{ 
this.greeting = greeting; 
} 

public void setGreeting( String greeting )
{
this.greeting = greeting;
}

public String getGreeting()
{
return greeting; 
}

public void printGreeting()
{
System.out.println( greeting ); 
}
}

下面编写agent
1:创建 MBeanServer
2：创建一个adapter
3：将MBean注册到MBeanServer，同时将apapter也注册到MBeanServer
4: 启动adapter

import javax.management.*; 
import com.sun.jdmk.comm.*;
public class HelloAgent
{
private MBeanServer mbs = null;

public HelloAgent()
{
mbs = MBeanServerFactory.createMBeanServer( "HelloAgent" );

HtmlAdaptorServer adapter = new HtmlAdaptorServer();

HelloWorld hw = new HelloWorld();

ObjectName adapterName = null;
ObjectName helloWorldName = null;

try 
{

helloWorldName = new ObjectName( "HelloAgent:name=helloWorld1" ); 
mbs.registerMBean( hw, helloWorldName ); 
adapterName = new ObjectName( "HelloAgent:name=htmladapter,port=9092" ); 
adapter.setPort( 9092 );
mbs.registerMBean( adapter, adapterName ); 
adapter.start();
}
catch( Exception e )
{
e.printStackTrace();
}

}

public static void main( String args[] )
{
System.out.println( "HelloAgent is running" );
HelloAgent agent = new HelloAgent(); 
}

}

上面的代码使用了sun的一个adapter：HtmlAdaptorServer，使得html客户端可以访问MBean，注意ObjectName类，它的书写规则是这样的："Domain names：key=value,key2=value2",因为createMBeanServer方法中我们使用了参数"HelloAgent",因此后面的Domain names必须为HelloAgent。
运行
将jmx的包放到classpath中，运行HelloAgent类，然后通过浏览器访问http://localhost:9092即可