com.varra.jmx.registry

Class MBeanManager

java.lang.Object

com.varra.jmx.registry.MBeanManager

All Implemented Interfaces:

MBeanRegistration

public class MBeanManager
extends Object
implements MBeanRegistration

This is the main class for MBean manipulation on the agent side. It contains the methods necessary for the creation, registration, and deletion of MBeans as well as the access methods for registered MBeans.

This is the core component of the JMXWrapper infrastructure.

When an MBean is registered or unregistered in the MBean server a MBeanServerNotification Notification is emitted.

Implements the MBeanRegistration to support the registration, and deletion of MBeans.

Version:

1.0

Author:

Rajakrishna V. Reddy

Constructor Summary

Constructors

Constructor and Description
MBeanManager() Instantiates a new MBean manager.

Method Summary

Modifier and Type	Method and Description
boolean	isRegistered(MBean mBean) Checks whether an MBean, identified by its Port, the Type and Application provided, is already registered with the MBean server.
boolean	register(MBean mBean) Registers the specified object as an MBean with the MBean server in the specified Port with the Type and Application provided.
boolean	unRegister(MBean mBean) Unregisters an MBean from the MBean server.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MBeanManager

public MBeanManager()

Instantiates a new MBean manager.

Method Detail

register

public boolean register(MBean mBean)
                 throws MBeanRegistrationException

Description copied from interface: MBeanRegistration

Registers the specified object as an MBean with the MBean server in the specified Port with the Type and Application provided. And Adds a NotificationListener to a registered MBean.

A notification emitted by the MBean will be forwarded by the MBeanServer to the listener. If the source of the notification is a reference to the MBean object, the MBean server will replace it by the MBean's ObjectName. Otherwise the source is unchanged.

If the any one of the details provided happen to be incorrect/null, then nothing will be registered and throws a

Specified by:

register in interface MBeanRegistration

Parameters:

mBean - the mBean

Returns:

True if the MBean is registered successfully in the MBean server, false otherwise.

Throws:

MBeanRegistrationException - the m bean registration exception MBeanRegistrationException in fact.

unRegister

public boolean unRegister(MBean mBean)
                   throws MBeanRegistrationException

Description copied from interface: MBeanRegistration

Unregisters an MBean from the MBean server. The MBean is identified by its Port, the Type and Application provided. Once the method has been invoked, the MBean may no longer be accessed by its object name.

And Removes a listener from this MBean.

Specified by:

unRegister in interface MBeanRegistration

Parameters:

mBean - the m bean

Returns:

True if the MBean is unRegistered successfully in the MBean server, false otherwise.

Throws:

MBeanRegistrationException - the m bean registration exception if the provided mBean is a null or not a valid one.

isRegistered

public boolean isRegistered(MBean mBean)
                     throws MBeanRegistrationException

Description copied from interface: MBeanRegistration

Checks whether an MBean, identified by its Port, the Type and Application provided, is already registered with the MBean server.

Specified by:

isRegistered in interface MBeanRegistration

Parameters:

mBean - the m bean

Returns:

True if the MBean is already registered in the MBean server, false otherwise.

Throws:

MBeanRegistrationException - the m bean registration exception