Mark AD-SAL interfaces as deprecated
[controller.git] / opendaylight / adsal / sal / api / src / main / java / org / opendaylight / controller / sal / flowprogrammer / IPluginOutFlowProgrammerService.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
9 package org.opendaylight.controller.sal.flowprogrammer;
10
11 import org.opendaylight.controller.sal.core.Node;
12
13 /**
14  * This interface defines the methods the protocol plugin must implement to
15  * inform the SAL layer about the asynchronous messages related to flow
16  * programming coming from the network nodes.
17  */
18 @Deprecated
19 public interface IPluginOutFlowProgrammerService {
20     /**
21      * Inform SAL that the flow on the specified node has been removed Consumer
22      * has to expect this notification only for flows which were installed with
23      * an idle or hard timeout specified.
24      *
25      * @param node
26      *            the network node on which the flow got removed
27      * @param flow
28      *            the flow that got removed. Note: It may contain only the Match
29      *            and flow parameters fields. Actions may not be present.
30      */
31     public void flowRemoved(Node node, Flow flow);
32
33     /**
34      * Inform SAL that an error message has been received from a switch
35      * regarding a flow message previously sent to the switch. A Request ID
36      * associated with the offending message is also returned.
37      *
38      * @param node
39      *            the network node on which the error reported
40      * @param rid
41      *            the offending message request id
42      * @param err
43      *            the error message
44      */
45     public void flowErrorReported(Node node, long rid, Object err);
46 }