org.opendaylight.controller.md.sal.dom.api

Interface DOMNotificationService

All Superinterfaces:

BrokerService, DOMService

public interface DOMNotificationService
extends DOMService, BrokerService

A DOMService which allows its users to subscribe to receive DOMNotifications.

Method Summary

Methods

Modifier and Type	Method and Description
<T extends DOMNotificationListener> org.opendaylight.yangtools.concepts.ListenerRegistration<T>	registerNotificationListener(T listener, Collection<SchemaPath> types) Register a DOMNotificationListener to receive a set of notifications.
<T extends DOMNotificationListener> org.opendaylight.yangtools.concepts.ListenerRegistration<T>	registerNotificationListener(T listener, SchemaPath... types) Register a DOMNotificationListener to receive a set of notifications.

Method Detail

registerNotificationListener

<T extends DOMNotificationListener> org.opendaylight.yangtools.concepts.ListenerRegistration<T> registerNotificationListener(@Nonnull
                                                                                                                           T listener,
                                                                                                                           @Nonnull
                                                                                                                           Collection<SchemaPath> types)

Register a DOMNotificationListener to receive a set of notifications. As with other ListenerRegistration-based interfaces, registering an instance multiple times results in notifications being delivered for each registration.

Parameters:

listener - Notification instance to register

types - Notification types which should be delivered to the listener. Duplicate entries are processed only once, null entries are ignored.

Returns:

Registration handle. Invoking DOMNotificationListenerRegistration#close() will stop the delivery of notifications to the listener

Throws:

IllegalArgumentException - if types is empty or contains an invalid element, such as null or a SchemaPath which does not represent a valid DOMNotification type.

NullPointerException - if either of the arguments is null

registerNotificationListener

<T extends DOMNotificationListener> org.opendaylight.yangtools.concepts.ListenerRegistration<T> registerNotificationListener(@Nonnull
                                                                                                                           T listener,
                                                                                                                           SchemaPath... types)

Register a DOMNotificationListener to receive a set of notifications. As with other ListenerRegistration-based interfaces, registering an instance multiple times results in notifications being delivered for each registration.

Parameters:

listener - Notification instance to register

types - Notification types which should be delivered to the listener. Duplicate entries are processed only once, null entries are ignored.

Returns:

Registration handle. Invoking DOMNotificationListenerRegistration#close() will stop the delivery of notifications to the listener

Throws:

IllegalArgumentException - if types is empty or contains an invalid element, such as null or a SchemaPath which does not represent a valid DOMNotification type.

NullPointerException - if listener is null