com.sun.jbi.management

Interface EventNotifierMBean

All Superinterfaces:

NotificationBroadcaster, NotificationEmitter

public interface EventNotifierMBean
extends NotificationEmitter

This interface defines the DAS event notifier MBean, which collects event notifications from all instances within the domain, and re-emits them. This allows a client to register as a notification listener with this MBean and automatically receive notifications from all instances within the domain. Event notifications are generated for all events affecting the state of the runtime, such as startup and shutdown of the runtime, installation or uninstallation of a component or shared library, deployment or undeployment of a service assembly, and life cycle operations on components and service assemblies.

Author:

Mark S White

Method Summary

Methods

Modifier and Type	Method and Description
boolean	disableNotifications() This method is called to disable event notifications.
boolean	enableNotifications() This method is called to enable event notifications.
boolean	instanceStarted(String instanceName, ObjectName objectName) This method is called to inform the DAS that an instance has started and it needs to register itself as a notification listener for the event notifier MBean on that instance.
boolean	instanceStopped(String instanceName, ObjectName objectName) This method is called to inform the DAS that an instance has stopped and it needs to unregister itself as a notification listener for the event notifier MBean on that instance.

Methods inherited from interface javax.management.NotificationEmitter

removeNotificationListener

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Method Detail

disableNotifications

boolean disableNotifications()

This method is called to disable event notifications.

Returns:

true if notifications were previously enabled, or false if they were already disabled.

enableNotifications

boolean enableNotifications()

This method is called to enable event notifications.

Returns:

true if notifications were previously disabled, or false if they were already enabled.

instanceStarted

boolean instanceStarted(String instanceName,
                      ObjectName objectName)

This method is called to inform the DAS that an instance has started and it needs to register itself as a notification listener for the event notifier MBean on that instance.

Parameters:

instanceName - the name of the instance that has started.

objectName - the JMX object name of the event notifier MBean for the instance.

Returns:

true if the registration was successful, or false if not.

instanceStopped

boolean instanceStopped(String instanceName,
                      ObjectName objectName)

This method is called to inform the DAS that an instance has stopped and it needs to unregister itself as a notification listener for the event notifier MBean on that instance.

Parameters:

instanceName - the name of the instance that has stopped.

objectName - the JMX object name of the event notifier MBean for the instance.

Returns:

true if the unregistration was successful, or false if not.