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

Interface DOMNotificationService

All Superinterfaces:

DOMService, DOMService

All Known Implementing Classes:

DOMNotificationRouter, ForwardingDOMNotificationService, LegacyDOMNotificationServiceAdapter

@Deprecated(forRemoval=true)
public interface DOMNotificationService
extends DOMService

Deprecated, for removal: This API element is subject to removal in a future version.

Use DOMNotificationService instead

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

Method Summary

Modifier and Type	Method	Description
<T extends DOMNotificationListener> ListenerRegistration<T>	registerNotificationListener(@NonNull T listener, @NonNull Collection<SchemaPath> types)	Deprecated, for removal: This API element is subject to removal in a future version. Register a DOMNotificationListener to receive a set of notifications.
<T extends DOMNotificationListener> ListenerRegistration<T>	registerNotificationListener(@NonNull T listener, SchemaPath... types)	Deprecated, for removal: This API element is subject to removal in a future version. Register a DOMNotificationListener to receive a set of notifications.

Method Detail

registerNotificationListener

<T extends DOMNotificationListener> ListenerRegistration<T> registerNotificationListener(@NonNull T listener,
                                                                                         @NonNull Collection<SchemaPath> types)

Deprecated, for removal: This API element is subject to removal in a future version.

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 ListenerRegistration.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> ListenerRegistration<T> registerNotificationListener(@NonNull T listener,
                                                                                         SchemaPath... types)

Deprecated, for removal: This API element is subject to removal in a future version.

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 ListenerRegistration.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