# Interface UnsolicitedNotification

All Superinterfaces:
  `ExtendedResponse, HasControls, Serializable`

public interface UnsolicitedNotification extends ExtendedResponse, HasControls
This interface represents an unsolicited notification as defined in RFC 2251. An unsolicited notification is sent by the LDAP server to the LDAP client without any provocation from the client. Its format is that of an extended response (`ExtendedResponse`).

Since:
  1.3
See Also:
  - `ExtendedResponse`
  - `UnsolicitedNotificationEvent`
  - `UnsolicitedNotificationListener`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `NamingException`
  `getException()`
  Retrieves the exception as constructed using information sent by the server.
  `String[]`
  `getReferrals()`
  Retrieves the referral(s) sent by the server.

  ### Methods declared in interface ExtendedResponse

  `getEncodedValue, getID`
  Modifier and Type
  Method
  Description
  `byte[]`
  `getEncodedValue()`
  Retrieves the ASN.1 BER encoded value of the LDAP extended operation response.
  `String`
  `getID()`
  Retrieves the object identifier of the response.

  ### Methods declared in interface HasControls

  `getControls`
  Modifier and Type
  Method
  Description
  `Control[]`
  `getControls()`
  Retrieves an array of `Control`s from the object that implements this interface.

- ## Method Details

  - ### getReferrals

    String[] getReferrals()
    Retrieves the referral(s) sent by the server.
    Returns:
      A possibly null array of referrals, each of which is represented by a URL string. If null, no referral was sent by the server.

  - ### getException

    NamingException getException()
    Retrieves the exception as constructed using information sent by the server.
    Returns:
      A possibly null exception as constructed using information sent by the server. If null, a "success" status was indicated by the server.