Package org.opendaylight.controller.sal.binding.api

Interface NotificationProviderService

All Superinterfaces:

BindingAwareService, NotificationPublishService<Notification>, NotificationService

All Known Implementing Classes:

AbstractBindingSalProviderInstance, HeliumNotificationProviderServiceAdapter, HeliumNotificationProviderServiceWithInterestListeners, RootBindingAwareBroker.RootSalInstance

@Deprecated(forRemoval=true)
public interface NotificationProviderService
extends NotificationService, NotificationPublishService<Notification>

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

Please use NotificationPublishService.

Interface for a notification service that provides publish/subscribe capabilities for YANG modeled notifications. This interface is a combination of the NotificationService and NotificationPublishService interfaces.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	NotificationProviderService.NotificationInterestListener	Deprecated, for removal: This API element is subject to removal in a future version. Interface for a listener interested in being notified about notification subscriptions.

Method Summary

Modifier and Type	Method	Description
void	publish(Notification notification)	Deprecated, for removal: This API element is subject to removal in a future version. Publishes a notification and notifies subscribed listeners.
void	publish(Notification notification, ExecutorService executor)	Deprecated, for removal: This API element is subject to removal in a future version. Publishes a notification and notifies subscribed listeners.
ListenerRegistration<NotificationProviderService.NotificationInterestListener>	registerInterestListener(NotificationProviderService.NotificationInterestListener interestListener)	Deprecated, for removal: This API element is subject to removal in a future version. Registers a listener to be notified about notification subscriptions.

Methods inherited from interface org.opendaylight.controller.sal.binding.api.NotificationService

registerNotificationListener, registerNotificationListener

Method Detail

publish

void publish(Notification notification)

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

Description copied from interface: NotificationPublishService

Publishes a notification and notifies subscribed listeners. All listener notifications are done via a default executor.

Note: This call will block when the default executor is saturated and the notification queue for this executor is full.

Specified by:

publish in interface NotificationPublishService<Notification>

Parameters:

notification - the notification to publish.

publish

void publish(Notification notification,
             ExecutorService executor)

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

Description copied from interface: NotificationPublishService

Publishes a notification and notifies subscribed listeners. All listener notifications are done via the provided executor.

Note: Use only if necessary. Consider using NotificationPublishService.publish(Object) for most use-cases.

By using this method you could customize execution policy of listeners present inside process (e.g. using single-threaded executor or even same-thread executor delivery.

This executor is used only for inside-process notification deliveries.

Specified by:

publish in interface NotificationPublishService<Notification>

Parameters:

notification - the notification to publish.

executor - the executor that will be used to deliver notifications to subscribed listeners.

registerInterestListener

ListenerRegistration<NotificationProviderService.NotificationInterestListener> registerInterestListener(NotificationProviderService.NotificationInterestListener interestListener)

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

Registers a listener to be notified about notification subscriptions. This enables a component to know when there is a notification listener subscribed for a particular notification type.

On registration of this listener, the NotificationProviderService.NotificationInterestListener.onNotificationSubscribtion(Class) method will be invoked for every notification type that currently has a notification listener subscribed.

Parameters:

interestListener - the listener that will be notified when subscriptions for new notification types occur.

Returns:

a ListenerRegistration instance that should be used to unregister the listener by invoking the ListenerRegistration.close() method when no longer needed.