JMXWrapper

Introduction

JMXWrapper is a wrapper class that allows the creation of dynamic JMX MBeans by simply annotating a normal Java class. Names and descriptions of JMX beans, attributes, operations and operation parameters can also be localized using standard Java ResourceBundles.

Example

 @JMXBean(description = "My first JMX bean test")
 public class MyBean {
 	int level = 0;
 
 	@JMXBeanAttribute(name = "Floor Level", description = "The current floor level")
 	public int getLevel() {
 		return level;
 	}
 
 	@JMXBeanAttribute
 	public void setLevel(int newLevel) {
 		level = newLevel;
 	}
 
 	@JMXBeanOperation(name = "Echo Test", description = "Echoes the parameter back to you")
 	public String myMethod(
 			@JMXBeanParameter(name = "Input", description = "String of what to echo") String param) {
 		return "You said " + param;
 	}
 }

Now you can use the JMXWrapper to publish a bean including the annotated informations to the JMX Server:

MyBean bean = new MyBean();
JMXBeanWrapper wrappedBean = new JMXBeanWrapper(bean);
MBeanServer mbs = ManagementFactory.getPlatformMBeanServer();
mbs.registerMBean(wrappedBean, new ObjectName("com.example.my.package:type=TestBean,name=My Bean"));

That's all!

Using ResourceBundles for names and descriptions

Instead of specifying names and descriptions directly into the annotations, you can use standard Java ResourceBundles. You just have to specify the bundle name in the JMXBean annotation and then annotate the bundle keys for beans, attributes, operations and parameters:

@JMXBean(resourceBundleName="com.example.my.package.BundleName")
        public class MyBean {
           int level = 0;
           @JMXBeanAttribute(nameKey="level", descriptionKey="levelDescription")
           public int getLevel() {
               return level;
           }

Annotation types

Four annotation types can be used:

JMXBean          : Marks and describes a class to be used as a dynamic JMX bean. 
JMXBeanAttribute : Marks and describes methods (setter/getter) in a JMXBean to be
                   used as a JMX attribute. 
JMXBeanOperation : Marks and describes a method to be used as a JMX operation. 
JMXBeanParameter : Describes a method parameter for JMX operation parameters

Project layout

The software was created and tested using Java 1.6.0. You can check it out directly to an Eclipse project, the necessary files are in the repository.

src/   The Java sources
tests/ JUnit tests

Maven

A pom.xml is provided, that allows to build the project with Maven.

I also put the JMXWrapper to a public Maven repository. The repository location is uklimaschewski/maven-repo.git, you will find the JMXWrapper there as an artifact.

To use JMXWrapper in your Maven project, add the following repository location to your pom.xml:

<repositories>
    <repository>
        <id>uklimaschewski-maven-repo</id>
        <name>Maven repository from uklimaschewski on GitHub</name>
        <url>https://raw.github.com/uklimaschewski/maven-repo/master</url>
        <layout>default</layout>
    </repository>
</repositories>

Then you can add a dependency from this repository to your pom.xml: Check the actual JMXWrapper version, here I only give an example entry using versions 1.0. You can check the versions at maven-metadata.xml.

<dependencies>
    <dependency>
        <groupId>com.udojava</groupId>
        <artifactId>jmxwrapper</artifactId>
        <version>1.0</version>
    </dependency>
</dependencies>

Author and License

The software is licensed under the MIT Open Source license (see LICENSE file).

TuomasKiviaho/JMXWrapper