Class JMXManageableSupport
- java.lang.Object
-
- com.ibm.websphere.management.JMXManageableSupport
-
- All Implemented Interfaces:
- JMXManageable
public class JMXManageableSupport extends java.lang.Object implements JMXManageable
The JMXManageableSupport class provides default implementation of JMXManageable interface that a CustomService implementation may choose to implement in order to indicate that it can be managed as a JMX MBean. On top of JMXManageable interface's automatic management of WebSphere JMX administration system as a CustomService, it also allows user provided managed resource (object) code to have a direct hook to ModelMBean handle which can be used to send notifications & also access other ModelMBean APIs without having to find the matching ModelMBean through the MBeanServer API.
-
-
Field Summary
Fields Modifier and Type Field and Description protected javax.management.modelmbean.ModelMBean
modelMBean
protected long
sequenceNumber
-
Constructor Summary
Constructors Constructor and Description JMXManageableSupport()
-
Method Summary
Methods Modifier and Type Method and Description java.util.Properties
getMBeanProperties()
Provides additional customer-defined key properties to be added to the key property list of the ObjectName for the MBean.javax.management.modelmbean.ModelMBean
getModelMBean()
Returns this managed resource's ModelMBean in order to allow sub-class of JMXManageableSupport class to have access to its associated ModelMBean.java.lang.String
getType()
Returns the MBean type for the MBean instance to be created.void
sendNotification(javax.management.Notification ntfyObj)
Built-in helper function to allow sub-class to send any Notification through its associated ModelMBean.void
sendNotification(java.lang.String type)
Built-in helper function to allow sub-class to simplify sending declared Notifications only using the notification type.void
setModelMBean(javax.management.modelmbean.ModelMBean srcModelMBean)
Allows WebSphere JMX admin system to bind associated ModelMBean to this managed resource's modelMBean.
-
-
-
Field Detail
-
modelMBean
protected javax.management.modelmbean.ModelMBean modelMBean
-
sequenceNumber
protected long sequenceNumber
-
-
Method Detail
-
getType
public java.lang.String getType()
Returns the MBean type for the MBean instance to be created.This type information is used by the WebSphere admin system to load the proper MBean Descriptor in order to define the attributes, operations, and notifications for the MBean.
The WebSphere admin system will first check whether this type is one of the predefined types shipped with the WebSphere product. If the type is one of the predefined ones, the MBean Descriptor shipped with WebSphere is loaded and used. Otherwise, the admin will attempt to locate an MBeanExtensionProvider configured to support this type of MBean and will load the MBean Descriptor from that MBeanExtensionProvider configuration.
If the JMXManageable implementation returns null from this method, the class name of the implementation will be used as the type.
- Specified by:
getType
in interfaceJMXManageable
-
getMBeanProperties
public java.util.Properties getMBeanProperties()
Provides additional customer-defined key properties to be added to the key property list of the ObjectName for the MBean.Note that in distributed environment, all ObjectNames have at least
cell, node, process, type and mbeanIdentifier
key properties.- Specified by:
getMBeanProperties
in interfaceJMXManageable
- See Also:
javax.management.ObjectName
-
getModelMBean
public javax.management.modelmbean.ModelMBean getModelMBean()
Returns this managed resource's ModelMBean in order to allow sub-class of JMXManageableSupport class to have access to its associated ModelMBean. If a null is returned then modelMBean has not been properly bound to this managed object.- See Also:
ModelMBean
-
setModelMBean
public final void setModelMBean(javax.management.modelmbean.ModelMBean srcModelMBean)
Allows WebSphere JMX admin system to bind associated ModelMBean to this managed resource's modelMBean.- See Also:
ModelMBean
-
sendNotification
public void sendNotification(java.lang.String type) throws javax.management.MBeanException, javax.management.RuntimeOperationsException
Built-in helper function to allow sub-class to simplify sending declared Notifications only using the notification type. It uses input type, this obj handle, and internal sequenceNumber to generate a new Notification object which is then sent using modelMBean (through its ModelMBeanNotificationBroadcaster interface).- Throws:
javax.management.MBeanException
javax.management.RuntimeOperationsException
- See Also:
ModelMBean
-
sendNotification
public void sendNotification(javax.management.Notification ntfyObj) throws javax.management.MBeanException, javax.management.RuntimeOperationsException
Built-in helper function to allow sub-class to send any Notification through its associated ModelMBean.- Throws:
javax.management.MBeanException
javax.management.RuntimeOperationsException
- See Also:
ModelMBean
-
-