Package com.tangosol.net.management

Interface NotificationManager

public interface NotificationManager
A NotificationManager is responsible for JMX notification delivery from a managed node to a set of subscribing managing nodes.

For Standard MBeans that implement the NotificationEmitter interface and Platform MBeans registered with the Coherence Registry, notifications will be automatically sent to the corresponding MBean within the Coherence domain (e.g. "Coherence:type=Platform,Domain=java.lang,subType=Memory,nodeId=1"). Additionally, application logic can send notifications using the NotificationManager as follows: 

   Cluster             cluster  = CacheFactory.ensureCluster();
   Registry            registry = cluster.getManagement();
   NotificationManager manager  = registry.getNotificationManger();
   String              sName    = registry.ensureGlobalName("type=CustomMBean");

   if (manager.isSubscribedTo(sName))
      {
      manager.trigger(sName, "custom.notification.type", "Custom notification message");
      }
Since:
Coherence 3.6
Author:
ew 2010.02.05

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    isSubscribedTo(String sName)
    Determine if any subscriptions exist for the specified MBean.
    void
    trigger(String sName, String sType, String sMessage)
    Trigger the notification on subscribers for a given MBean.
    void
    trigger(String sName, Notification notification)
    Trigger the notification on subscribers for a given MBean.

  • Method Details

    • isSubscribedTo

      boolean isSubscribedTo(String sName)
      Determine if any subscriptions exist for the specified MBean.
      Parameters:
      sName - the MBean name to check for subscriptions
      Returns:
      true iff the specified name identifies the MBean that was registered by the caller's node and subscriptions exist for that MBean

    • trigger

      void trigger(String sName, String sType, String sMessage) throws IllegalArgumentException
      Trigger the notification on subscribers for a given MBean.
      Parameters:
      sName - the MBean name
      sType - the notification type
      sMessage - the notification message
      Throws:
      IllegalArgumentException - if an MBean with the specified name does not exists

    • trigger

      void trigger(String sName, Notification notification) throws IllegalArgumentException
      Trigger the notification on subscribers for a given MBean.

      Note: if the specified Notification object has a negative SequenceNumber, it will be automatically assigned.

      Parameters:
      sName - the MBean name
      notification - the notification object
      Throws:
      IllegalArgumentException - if an MBean with the specified name does not exists