public class RequestController {
    // constructors
    public RequestCopntroller()
    public RequestController(Map resource)

    // attributes
    public boolean isStarted() { ... }
    public int getRequestCount(){ ... }
    public int getResourceCount() { ... }
    public void setRequestLimit(int limit){ ... }
    public int getRequestLimit() { ... }
    
    // operations
    public void start(){ ... }
    public void stop(){ ... }
    public void putResource(String name, Object resource){ ... }
    public void makeRequest(String res) { ... }
}

You can export an instance of that class for management to an MBeanServer using

def ctrl = new RequestController()

jmx.export {
    bean(ctrl)
}

The code above will export an MBean into the MBeanServer for the specified object instance for management. JmxBuilder will do the following

Generate a default JMX ObjectName
Export all JMX attributes (in read-only)
Export all operations

JConsole view of Exported Bean

You can see that JmxBuilder exports all attributes, operations, and constructor information automatically using this shorthand notation. You can customize your targeted attributes and operations description that you want to export (see below).

Export Descriptors

You can control, customize, and describe the information that is exported to the MBeanServer. JmxBuilder lets you describe your export information by declaring your descriptors inline or embedding the descriptors inside the object itself

Overriding the ObjectName

One of the thing you can do is to override the object name to customize your export. This is done as followed:

jmxBldr.export {
    bean(target:ctrl, name:"jmx.builder:type=Object")
}

This willl export the MBean using the object name provided. You can use the string representation or an instance of ObjectName here.

See JmxBuilderReference for detail.

Controlling Attribute Export

You can control the description and attribute export using JmxBuilder.

Export with Attributes with Wildcard `"*"`

You can use a wildcard character to export all attributes associated with the MBean. The snippet below exports all attributes, however, no operations or constructors will be defined nor exported into the MBeanServer.

jmxBldr.export{
    bean(
        target: ctrl, name: "jmx.builder:type=Object", 
        attributes: "*"
    )
}

See JmxBuilderReference for more detail on exporting attributes.

Export Attributes by List

The following code snippet provides a list of attributes to export. Only the listed attributes will be exposed for management.

jmxBldr.export{
    bean(
        target: ctrl, name: "jmx.builder:type=Object", 
        attributes: ["Started","RequestCount", "ResourceCount"]
    )
}

This snippet will cause JmxBuilder to export only the attributes listed in key "attributes:" and their associated getter operations.

JConsole View

See JmxBuilderReference for more detail on exporting attributes.

Controlling Operation Export

JmxBuilder lets you describe and export information about operations declared on the underlying bean to be exported as MBean. You can implicitly describe and export all operations (using the wildcard) or specify which operation to export.

Export with Operations with Wildcard `"*"`

You can use a wildcard character to export all operations declared on the underlying bean to exported. The snippet below exports all operations, however, no attributes or constructors will be defined nor exported into the MBeanServer.

jmxBldr.export{
    bean(
        target: ctrl, name: "jmx.builder:type=Object2", 
        operations: "*"
    )
}

JConsole View

You can see that JmxBuilder only exported operations on the MBean (including getter/setters). No attributes were described nor exported.

See JmxBuilderReference for more detail on exporting attributes.

Export Operations by List

You can target operations to export by specifying a comma-separated list of the methods on the underlying bean to export for management.

jmxBldr.export{
    bean(
        target: ctrl, name: "jmx.builder:type=Object3", 
        operations: ["start","stop", "makeRequest"]
    )
}

JConsole View

Notice that only the specified operations are described and export into the MBeanServer.

See JmxBuilderReference for more detail on exporting operations.

Handling Events

Using JmxBuilder, you can intercept listen and react to events emitted on the MBeanServer's event bus. Conversely, JmxBuilder lets you emit your own event on the bus to be consumed by registered listeners.

Attribute Change Events

One basic event that JmxBuilder allows you to listen for is "attribute changes". You can set easily set your listener when you setup the bean for export.

jmxBldr.export{
    bean(target:ctrl, name:"jmx.builder:type=Object",
        attributes: [
            "RequestLimit":[reable:true, writable:true,
                onChange:{e -> 
                    if(e.newValue > 10){
                        println "***** Warning, high limit detected *****"
                    }
                }
            ]
        ]
    )
}

The closure specified by key "onChange:" will be invoked whenever the attribute "RequestLimit" on the MBean is updated via the setter associated with the attribute.

JConsole View

Closure Executed

Attribute "RequestLimit" updated to 22, causes the onChange event closure to be called.

See JmxBuilderReference for more detail on event handling.

Operation Call Events

jmxBldr.export{
    bean(target:ctrl, name:"jmx.builder:type=Object",
        operations: [
            "makeRequest":[
                onCall:{e -> 
                    println "***** A request was made *****"
                }
            ]
        ]
    )
}

In the snippet above, the closure specified by key "onCall:" will be executed after each invokation of opeartion makeRequest on the MBean.

Closure Executed

See JmxBuilderReference for more detail on event handling.

What's Next

The JmxBuilder DSL is capable of much more. Please review the JmxBuilderReference section for a list of all of the capabilities of the tool.

Feedback

All feedbacks are welcome. If you find a bug, don't hesitate to report it.