Module java.naming
Package javax.naming.ldap

# Interface UnsolicitedNotificationListener

All Superinterfaces:
  `EventListener`, `NamingListener`

public interface UnsolicitedNotificationListener extends NamingListener
This interface is for handling `UnsolicitedNotificationEvent`. "Unsolicited notification" is defined in RFC 2251. It allows the server to send unsolicited notifications to the client. An `UnsolicitedNotificationListener` must:

1. Implement this interface and its method
2. Implement `NamingListener.namingExceptionThrown()` so that it will be notified of exceptions thrown while attempting to collect unsolicited notification events.
3. Register with the context using one of the `addNamingListener()` methods from `EventContext` or `EventDirContext`. Only the `NamingListener` argument of these methods are applicable; the rest are ignored for an `UnsolicitedNotificationListener`. (These arguments might be applicable to the listener if it implements other listener interfaces).

Since:
  1.3
See Also:
  - `UnsolicitedNotificationEvent`
  - `UnsolicitedNotification`
  - `EventContext.addNamingListener(javax.naming.Name, int, javax.naming.event.NamingListener)`
  - `EventDirContext.addNamingListener(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls, javax.naming.event.NamingListener)`
  - `EventContext.removeNamingListener(javax.naming.event.NamingListener)`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `notificationReceived(UnsolicitedNotificationEvent evt)`
  Called when an unsolicited notification has been received.

  ### Methods declared in interface javax.naming.event.NamingListener

  `namingExceptionThrown`

- ## Method Details

  - ### notificationReceived

    void notificationReceived(UnsolicitedNotificationEvent evt)
    Called when an unsolicited notification has been received.
    Parameters:
      `evt` - The non-null UnsolicitedNotificationEvent