e5a0a2bd6dda74aa8565757f2acea4679bbb1300
[controller.git] / opendaylight / md-sal / sal-binding-api / src / main / java / org / opendaylight / controller / sal / binding / api / NotificationListener.java
1 /*
2  * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.controller.sal.binding.api;
9
10 import java.util.EventListener;
11 import org.opendaylight.yangtools.yang.binding.Notification;
12
13 /**
14  * Interface for a generic listener that is interested in receiving YANG modeled notifications.
15  * This interface acts as a base interface for specific listeners which usually are a type
16  * capture of this interface.
17  *
18  * @param <T> the interested notification type
19  * @deprecated Deprecated unused API.
20  */
21 @Deprecated
22 public interface NotificationListener<T extends Notification> extends EventListener {
23     /**
24      * Invoked to deliver a notification.
25      * <p>
26      * Note that this method may be invoked from a shared thread pool, so implementations SHOULD NOT
27      * perform CPU-intensive operations and MUST NOT invoke any potentially blocking operations.
28      *
29      * @param notification the notification.
30      */
31     void onNotification(T notification);
32 }