Please note that this documentation is not final and is subject to change.

JavaTM SCTP API
DRAFT ea-b09

com.sun.nio.sctp
Interface NotificationHandler<T>

All Known Implementing Classes:
AbstractNotificationHandler

public interface NotificationHandler<T>

A handler for consuming notifications from the SCTP stack.

The SCTP channels defined in this package allow a notification handler to be specified to consume notifications from the SCTP stack. When a notification is received the handleNotification method of the handler is invoked to handle that notification.

Additionally an attachment object can be attached to the receive operation to provide context when consuming the notification. The attachment is important for cases where a state-less NotificationHandler is used to consume the result of many receive operations.

Handler implementations are encouraged to extend the AbstractNotificationHandler class that implements this interface and provides notification specific methods. However, an API should generally use this handler interface as the type for parameters, return type, etc. rather than the abstract class.

Since:
1.7

Method Summary
 HandlerResult handleNotification(Notification notification, T attachment)
          Invoked when a notification is received from the SCTP stack.
 

Method Detail

handleNotification

HandlerResult handleNotification(Notification notification,
                                 T attachment)
Invoked when a notification is received from the SCTP stack.

Parameters:
notification - The notification
attachment - The object attached to the receive operation when it was initiated.
Returns:
The handler result

JavaTM SCTP API
DRAFT ea-b09