1. /*

  2.  * @(#)UnsolicitedNotificationListener.java	1.4 00/02/02

  3.  *

  4.  * Copyright 1999, 2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package javax.naming.ldap;

  12. 

  13. import javax.naming.event.NamingListener;

  14. 

  15. /**

  16.  * This interface is for handling <tt>UnsolicitedNotificationEvent</tt>.

  17.  * "Unsolicited notification" is defined in

  18.  * <A HREF="ftp://ftp.isi.edu/in-notes/rfc2251.txt">RFC 2251</A>.

  19.  * It allows the server to send unsolicited notifications to the client.

  20.  * A <tt>UnsolicitedNotificationListener</tt> must:

  21.  *<ol>

  22.  * <li>Implement this interface and its method

  23.  * <li>Implement <tt>NamingListener.namingExceptionThrown()</tt> so

  24.  * that it will be notified of exceptions thrown while attempting to

  25.  * collect unsolicited notification events.

  26.  * <li>Register with the context using one of the <tt>addNamingListener()</tt>

  27.  * methods from <tt>EventContext</tt> or <tt>EventDirContext</tt>.

  28.  * Only the <tt>NamingListener</tt> argument of these methods are applicable;

  29.  * the rest are ignored for a <tt>UnsolicitedNotificationListener</tt>.

  30.  * (These arguments might be applicable to the listener if it implements

  31.  * other listener interfaces).

  32.  *</ol>

  33.  * 

  34.  * @author Rosanna Lee

  35.  * @author Scott Seligman

  36.  * @author Vincent Ryan

  37.  * @version 1.4 00/02/02

  38.  *

  39.  * @see UnsolicitedNotificationEvent

  40.  * @see UnsolicitedNotification

  41.  * @see javax.naming.event.EventContext#addNamingListener

  42.  * @see javax.naming.event.EventDirContext#addNamingListener

  43.  * @see javax.naming.event.EventContext#removeNamingListener

  44.  * @since 1.3

  45.  */

  46. public interface UnsolicitedNotificationListener extends NamingListener {

  47. 

  48.     /**

  49.      * Called when an unsolicited notification has been received.

  50.      *

  51.      * @param evt The non-null UnsolicitedNotificationEvent

  52.      */

  53.      void notificationReceived(UnsolicitedNotificationEvent evt);

  54. }