View Javadoc

1   /*
2    * $Id: ServerNotificationHandler.java 20321 2010-11-24 15:21:24Z dfeist $
3    * --------------------------------------------------------------------------------------
4    * Copyright (c) MuleSoft, Inc.  All rights reserved.  http://www.mulesoft.com
5    *
6    * The software in this package is published under the terms of the CPAL v1.0
7    * license, a copy of which has been included with this distribution in the
8    * LICENSE.txt file.
9    */
10  
11  package org.mule.api.context.notification;
12  
13  
14  public interface ServerNotificationHandler
15  {
16      void fireNotification(ServerNotification notification);
17  
18      boolean isNotificationDynamic();
19  
20      /**
21       *
22       * @param listener
23       * @return
24       *
25       * @since 3.0
26       */
27      boolean isListenerRegistered(ServerNotificationListener listener);
28  
29      /**
30       * This returns a very "conservative" value - it is true if the notification or any subclass would be
31       * accepted.  So if it returns false then you can be sure that there is no need to send the
32       * notification.  On the other hand, if it returns true there is no guarantee that the notification
33       * "really" will be dispatched to any listener.
34       *
35       * @param notfnClass Either the notification class being generated or some superclass
36       * @return false if there is no need to dispatch the notification
37       */
38      boolean isNotificationEnabled(Class<? extends ServerNotification> notfnClass);
39  
40  }