Remove deprecated MD-SAL APIs

[controller.git] / opendaylight / md-sal / sal-binding-api / src / main / java / org / opendaylight / controller / md / sal / binding / api / NotificationPublishService.java

diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/NotificationPublishService.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/NotificationPublishService.java
deleted file mode 100644 (file)
index 52170ac..0000000
--- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/NotificationPublishService.java
+++ /dev/null
@@ -1,98 +0,0 @@
-/*
- * Copyright (c) 2014 Cisco Systems, Inc. and others.  All rights reserved.
- *
- * This program and the accompanying materials are made available under the
- * terms of the Eclipse Public License v1.0 which accompanies this distribution,
- * and is available at http://www.eclipse.org/legal/epl-v10.html
- */
-package org.opendaylight.controller.md.sal.binding.api;
-
-import com.google.common.util.concurrent.Futures;
-import com.google.common.util.concurrent.ListenableFuture;
-import java.util.concurrent.TimeUnit;
-import org.opendaylight.yangtools.yang.binding.Notification;
-
-/**
- * A {@link NotificationService} which also allows its users to
- * submit YANG-modeled notifications for delivery. There are three
- * methods of submission, following the patters from {@link java.util.concurrent.BlockingQueue}:
- * - {@link #putNotification(Notification)}, which may block indefinitely
- *   if the implementation cannot allocate resources to accept the notification,
- * - {@link #offerNotification(Notification)}, which does not block if face
- *   of resource starvation,
- * - {@link #offerNotification(Notification, int, TimeUnit)}, which may block
- *   for specified time if resources are thin.
- *
- * <p>
- * The actual delivery to listeners is asynchronous and implementation-specific.
- * Users of this interface should not make any assumptions as to whether the
- * notification has or has not been seen.
- *
- * @deprecated Use {@link org.opendaylight.mdsal.binding.api.NotificationPublishService} instead
- */
-@Deprecated(forRemoval = true)
-public interface NotificationPublishService extends BindingService {
-
-    /**
-     * Well-known value indicating that the binding-aware implementation is currently not
-     * able to accept a notification.
-     */
-    ListenableFuture<Object> REJECTED = Futures.immediateFailedFuture(new NotificationRejectedException(
-            "Rejected due to resource constraints."));
-
-    /**
-     * Publishes a notification to subscribed listeners. This initiates
-     * the process of sending the notification, but delivery to the
-     * listeners can happen asynchronously, potentially after a call to
-     * this method returns.
-     *
-     * <b>Note:</b> This call will block when the notification queue is full.
-     *
-     * @param notification
-     *            the notification to publish.
-     * @throws InterruptedException if interrupted while waiting
-     * @throws NullPointerException if the notification is null
-     */
-    void putNotification(Notification notification) throws InterruptedException;
-
-    /**
-     * Publishes a notification to subscribed listeners. This initiates
-     * the process of sending the notification, but delivery to the
-     * listeners can happen asynchronously, potentially after a call to
-     * this method returns.
-     *
-     * <p>
-     * Still guaranteed not to block. Returns Listenable Future which will complete once.
-     *
-     * @param notification
-     *            the notification to publish.
-     * @return A listenable future which will report completion when the service has finished
-     *     propagating the notification to its immediate registrants, or {@link #REJECTED} if resource
-     *     constraints prevent
-     * @throws NullPointerException if the notification is null
-     */
-    ListenableFuture<?> offerNotification(Notification notification);
-
-    /**
-     * Publishes a notification to subscribed listeners. This initiates
-     * the process of sending the notification, but delivery to the
-     * listeners can happen asynchronously, potentially after a call to
-     * this method returns. This method is guaranteed not to block more
-     * than the specified timeout.
-     *
-     * @param notification
-     *            the notification to publish.
-     * @param timeout how long to wait before giving up, in units of unit
-     * @param unit a TimeUnit determining how to interpret the
-     *             timeout parameter
-     * @return A listenable future which will report completion when the service has finished
-     *     propagating the notification to its immediate registrants, or {@link #REJECTED} if resource
-     *     constraints prevent
-     * @throws InterruptedException if interrupted while waiting
-     * @throws NullPointerException if the notification or unit is null
-     * @throws IllegalArgumentException if timeout is negative.
-     */
-    ListenableFuture<?> offerNotification(Notification notification, int timeout, TimeUnit unit)
-            throws InterruptedException;
-
-}