com.sun.appserv.management.base
Interface NotificationEmitterService

All Superinterfaces:

AMX, AMXMBeanLogging, NotificationBroadcaster, NotificationEmitter

public interface NotificationEmitterService
extends AMX

Enables the emitting of JMX Notifications by any code with access to an MBean implementing this interfaces. Targeted for use by server code which has no corresponding MBean from which to emit a Notification.

Since:

AppServer 9.0

Field Summary

static String

J2EE_TYPE The j2eeType as returned by AMX.getJ2EEType().

Fields inherited from interface com.sun.appserv.management.base.AMX

FULL_TYPE_DELIM, GROUP_CONFIGURATION, GROUP_JSR77, GROUP_MONITORING, GROUP_OTHER, GROUP_UTILITY, J2EE_TYPE_KEY, JMX_DOMAIN, NAME_KEY, NO_NAME, NOTIFICATION_PREFIX, NULL_NAME

Method Summary

void	emitNotification(Notification notif) Emit an already-formed Notification.
int	getListenerCount()

Methods inherited from interface com.sun.appserv.management.base.AMX

getContainer, getDomainRoot, getFullType, getGroup, getJ2EEType, getName, isDAS

Methods inherited from interface javax.management.NotificationEmitter

removeNotificationListener

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface com.sun.appserv.management.base.AMXMBeanLogging

getMBeanLoggerName, getMBeanLogLevel, setMBeanLogLevel

Field Detail

J2EE_TYPE

static final String J2EE_TYPE

The j2eeType as returned by AMX.getJ2EEType().

See Also:

Constant Field Values

Method Detail

emitNotification

void emitNotification(Notification notif)

Emit an already-formed Notification. Any entity may invoke this method, even clients, but by convention only server code should do so.

Notifications emitted through this method usually return an Object from getSource() which is not an ObjectName; if an ObjectName is available then the Notification should usually be emitted by that MBean directly. There may be exceptions to this, for example Notifications emitted on behalf of MBeans found in remote server instances. Otherwise, by convention getSource() should return a String representing the source, and the same String should always be used for the same source. Furthermore, the String should never be translated so that the same source will be seen regardless of the language in which the server is running.

Notifications are not checked for duplication; callers should ensure that for any given source (as returned from Notification.getSource()) that the sequence number is monotonically increasing.

Excluding standard JMX Notification types, Notifications emitted by an AMX MBean implementing this interface must follow the AMX conventions:

• getUserData() must return a java.util.Map (possibly null)
• the Notification as a whole must be Serializable
• for instances of this interface which are part of AMX, getType() must return a String defined in an AMX interface.

Parameters:

notif -

See Also:

NotificationBuilder

getListenerCount

int getListenerCount()

Returns:

number of listeners