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.