UnsolicitedNotificationListener (Java SE 26 & JDK 26)
Description: declaration: module: java.naming, package: javax.naming.ldap, interface: UnsolicitedNotificationListener
Keywords: javax.naming.ldap.UnsolicitedNotificationListener interface

# 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(Name, int, NamingListener)`
  - `EventDirContext.addNamingListener(Name, String, SearchControls, NamingListener)`
  - `EventContext.removeNamingListener(NamingListener)`

- ## Method Summary

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

  ### Methods declared in interface NamingListener

  `namingExceptionThrown`
  Modifier and Type
  Method
  Description
  `void`
  `namingExceptionThrown(NamingExceptionEvent evt)`
  Called when a naming exception is thrown while attempting to fire a `NamingEvent`.

- ## Method Details

  - ### notificationReceived

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