15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.naming.ldap;
  27 
  28 import javax.naming.NamingException;
  29 
  30 /**
  31  * This interface represents an unsolicited notification as defined in
  32  * <A HREF="http://www.ietf.org/rfc/rfc2251.txt">RFC 2251</A>.
  33  * An unsolicited notification is sent by the LDAP server to the LDAP
  34  * client without any provocation from the client.
  35  * Its format is that of an extended response (<tt>ExtendedResponse</tt>).
  36  *
  37  * @author Rosanna Lee
  38  * @author Scott Seligman
  39  * @author Vincent Ryan
  40  *
  41  * @see ExtendedResponse
  42  * @see UnsolicitedNotificationEvent
  43  * @see UnsolicitedNotificationListener
  44  * @since 1.3
  45  */
  46 
  47 public interface UnsolicitedNotification extends ExtendedResponse, HasControls {
  48     /**
  49      * Retrieves the referral(s) sent by the server.
  50      *
  51      * @return A possibly null array of referrals, each of which is represented
  52      * by a URL string. If null, no referral was sent by the server.
  53      */
  54     public String[] getReferrals();
  55 

  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.naming.ldap;
  27 
  28 import javax.naming.NamingException;
  29 
  30 /**
  31  * This interface represents an unsolicited notification as defined in
  32  * <A HREF="http://www.ietf.org/rfc/rfc2251.txt">RFC 2251</A>.
  33  * An unsolicited notification is sent by the LDAP server to the LDAP
  34  * client without any provocation from the client.
  35  * Its format is that of an extended response ({@code ExtendedResponse}).
  36  *
  37  * @author Rosanna Lee
  38  * @author Scott Seligman
  39  * @author Vincent Ryan
  40  *
  41  * @see ExtendedResponse
  42  * @see UnsolicitedNotificationEvent
  43  * @see UnsolicitedNotificationListener
  44  * @since 1.3
  45  */
  46 
  47 public interface UnsolicitedNotification extends ExtendedResponse, HasControls {
  48     /**
  49      * Retrieves the referral(s) sent by the server.
  50      *
  51      * @return A possibly null array of referrals, each of which is represented
  52      * by a URL string. If null, no referral was sent by the server.
  53      */
  54     public String[] getReferrals();
  55