1. /*

  2.  * @(#)UnsolicitedNotification.java	1.5 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.NamingException;

  14. 

  15. /**

  16.  * This interface represents an unsolicited notification as defined in

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

  18.  * An unsolicited notification is sent by the LDAP server to the LDAP

  19.  * client without any provocation from the client.

  20.  * Its format is that of an extended response (<tt>ExtendedResponse</tt>).

  21.  * 

  22.  * @author Rosanna Lee

  23.  * @author Scott Seligman

  24.  * @author Vincent Ryan

  25.  * @version 1.5 00/02/02

  26.  *

  27.  * @see ExtendedResponse

  28.  * @see UnsolicitedNotificationEvent

  29.  * @see UnsolicitedNotificationListener

  30.  * @since 1.3

  31.  */

  32. 

  33. public interface UnsolicitedNotification extends ExtendedResponse, HasControls {

  34.     /**

  35.      * Retrieves the referral(s) sent by the server.

  36.      * 

  37.      * @return A possibly null array of referrals, each of which is represented

  38.      * by a URL string. If null, no referral was sent by the server.

  39.      */

  40.     public String[] getReferrals();

  41. 

  42.     /**

  43.      * Retrieves the exception as constructed using information 

  44.      * sent by the server.

  45.      * @return A possibly null exception as constructed using information

  46.      * sent by the server. If null, a "success" status was indicated by

  47.      * the server.

  48.      */

  49.     public NamingException getException();

  50. }