Package org.apache.commons.modeler.ant

Ant Tasks for Commons Modeler Integration.

Class Summary

Arg
JmxInvoke Set mbean properties.
JmxSet Set mbean properties.
MLETTask Load an MBean.
ModelerTask Like MLETTask, but it wraps the bean in a BaseModelMBean.
RegistryTask Load descriptors into registry.
ServiceTask Group a set of mbeans in a service, and perform actions on it.
Ant Tasks for Commons Modeler Integration.
[mbean / MLET] [jmx-attribute] [jmx-operation] [mbeans-descriptors]

The commons-modeler package includes a set of custom tasks for the Ant build tool, which lets you use Ant to automate the loading of MBean descriptor information, dynamic creation of JMX MBeans, and calling operations and attribute setters on those MBeans. If your application can assemble itself based JMX Mbean operations, this means that you can now use Ant scripts to manage the lifecycle of your application's components, without having to write Java code for this purpose.

To use these tasks, you must copy commons-modeler.jar into the lib subdirectory of your Ant installation, or make sure that it is on the CLASSPATH being used to execute Ant.


mbean / MLET


jmx-attribute

Description

Locates the JMX MBean identified by the objectName attribute, and calls its setAttribute() operation, passing in the attribute name specified by attribute and the value specified by value, after converting the value to the type specified by type.

Parameters

AttributeDescriptionRequired
attribute

Name of the attribute for which the setAttribute() method will be called.

Yes
objectName The JMX ObjectName that identifies the MBean whose setAttribute() method will be called. Yes
type

The data type of the attribute value to be set. If not specified, will be assumed to be a String. Otherwise, must be one of ObjectName, boolean, or int.

No
value

String representation of the value to which this attribute will be set. Either value or valueRef must be specified.

No
valueRef

Indirect pointer to a project reference containing the value to which this attribute will be set. Either value or valueRef must be specified.

No

jmx-operation


mbeans-descriptors



Copyright (c) 2001-2003 - Apache Software Foundation