The JMX component enables consumers to subscribe to an MBean's notifications. The
component supports passing the Notification object directly through the exchange
or serializing it to XML according to the schema provided within this project. This is a
consumer-only component. Exceptions are thrown if you attempt to create a producer for
it.
The component can connect to the local platform MBean server with the following URI:
jmx://platform?options
A remote MBean server URL can be specified after the jmx: scheme prefix, as
follows:
jmx:service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi?options
You can append query options to the URI in the following format,
?option=value&option=value&....
| Property | Required | Default | Description |
|---|---|---|---|
format
|
xml
|
Format for the message body. Either xml or raw. If
xml, the notification is serialized to XML. If raw, the raw
java object is set as the body. |
|
password
|
Credentials for making a remote connection. | ||
objectDomain
|
Yes | The domain of the MBean you are connecting to. | |
objectName
|
The name key for the MBean you are connecting to. Either this property of a list of keys must be provided (but not both). For more details, see ObjectName Construction. | ||
notificationFilter
|
Reference to a bean that implements the NotificationFilter
interface. The # syntax should be used to
reference the bean in the registry. |
||
handback
|
Value to hand back to the listener when a notification is received. This value will be
put into the jmx.handback message header. |
The URI must always have the objectDomain property. In addition, the URI must
contain either objectName or one or more properties that start with
key.
When the objectName property is provided, the following constructor is used
to build the ObjectName instance for the MBean:
ObjectName(String domain, String key, String value)
The key value in the preceding constructor must be name and the
value is the value of the objectName property.
ObjectName(String domain, Hashtable<String,String> table)
The Hashtable is constructed by extracting properties that start with
key. The properties will have the key prefix stripped prior to
building the Hashtable. This allows the URI to contain a variable number of
properties to identify the MBean.
 |  | |
 |
