+++ /dev/null
-/*
- * Copyright (c) 2013 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.forwardingrulesmanager;
-
-import java.util.List;
-import java.util.Map;
-
-import org.opendaylight.controller.sal.core.Node;
-import org.opendaylight.controller.sal.core.NodeConnector;
-import org.opendaylight.controller.sal.utils.Status;
-
-/**
- * Interface that describes methods for installing or removing forwarding rules
- * and to access to the flows database.
- */
-public interface IForwardingRulesManager {
-
- /**
- * It requests FRM to install the passed Flow Entry. FRM will request the
- * SDN protocol plugin to install the flow on the network node. Based on the
- * result of this operation FRM will update its database accordingly and
- * will return the proper {@code Status} code.
- *
- * @param flow
- * the flow entry to install
- * @return the {@code Status} object indicating the result of this action.
- */
- public Status installFlowEntry(FlowEntry flow);
-
- /**
- * It requests FRM to remove the passed Flow Entry. FRM will request the SDN
- * protocol plugin to uninstall the flow from the network node. Based on the
- * result of this operation FRM will update its database accordingly and
- * will return the proper {@code Status} code.
- *
- * @param flow
- * the flow entry to uninstall
- * @return the {@code Status} object indicating the result of this action
- */
- public Status uninstallFlowEntry(FlowEntry flow);
-
- /**
- * It requests FRM to remove all the Flow Entry that are part of the
- * specified group. FRM will request the SDN protocol plugin to uninstall
- * the flows from the network node one by one. Based on the result of this
- * operation FRM will update its database accordingly and will return the
- * proper {@code Status} code.
- *
- * @param groupName
- * the group name
- * @return the {@code Status} object indicating the result of this action
- */
- public Status uninstallFlowEntryGroup(String groupName);
-
- /**
- * It requests FRM to replace the currently installed Flow Entry with the
- * new one. It is up to the SDN protocol plugin to decide how to convey this
- * message to the network node. It could be a delete + add or a single
- * modify message depending on the SDN protocol specifications If the
- * current flow is equal to the new one it will be a no op and success code
- * is returned.
- *
- * @param current
- * the current flow entry to modify
- * @param newone
- * the new flow entry which will replace the current one
- * @return the {@code Status} object indicating the result of this action
- */
- public Status modifyFlowEntry(FlowEntry current, FlowEntry newone);
-
- /**
- * It requests the FRM to replace the currently installed Flow Entry with
- * the new one. The currently installed entry is derived by the Match
- * portion of the passed Flow. FRM looks in its database for a previously
- * installed FlowEntry which Match equals the Match of the passed Flow. If
- * it finds it, it will request the SDN protocol plugin to replace the
- * existing flow with the new one on the network node. If it does not find
- * it, it will request plugin to add the new flow. If the passed entry is
- * not valid an error code is returned. If the existing flow is equal to the
- * passed one it will be a no op and success code is returned.
- *
- * @param newone
- * the new flow entry to install
- * @return the {@code Status} object indicating the result of this action
- */
- public Status modifyOrAddFlowEntry(FlowEntry newone);
-
- /**
- * It requests FRM to install the passed Flow Entry through an asynchronous
- * call. A unique request id is returned to the caller. FRM will request the
- * SDN protocol plugin to install the flow on the network node. As immediate
- * result of this asynchronous call, FRM will update its flow database as if
- * the flow was successfully installed.
- *
- * @param flow
- * the flow entry to install
- * @return the status of this request containing the request id associated
- * to this asynchronous request
- */
- public Status installFlowEntryAsync(FlowEntry flow);
-
- /**
- * It requests FRM to remove the passed Flow Entry through an asynchronous
- * call. A unique request id is returned to the caller. FRM will request the
- * SDN protocol plugin to uninstall the flow from the network node. As
- * immediate result of this asynchronous call, FRM will update its flow
- * database as if the flow was successfully removed.
- *
- * @param flow
- * the flow entry to uninstall
- * @return the status of this request containing the unique id associated to
- * this asynchronous request
- */
- public Status uninstallFlowEntryAsync(FlowEntry flow);
-
- /**
- * It requests FRM to remove all the Flow Entry that are part of the
- * specified group through an asynchronous call. FRM will request the SDN
- * protocol plugin to uninstall the flows from the network node one by one.
- * As immediate result of this asynchronous call, FRM will update its flow
- * database as if the flow was successfully removed.
- *
- * @param groupName
- * the group name
- * @return the {@code Status} object indicating the result of this action
- */
- public Status uninstallFlowEntryGroupAsync(String groupName);
-
- /**
- * It requests FRM to replace the currently installed Flow Entry with the
- * new one through an asynchronous call. A unique request id is returned to
- * the caller. It is up to the SDN protocol plugin to decide how to convey
- * this message to the network node. It could be a delete + add or a single
- * modify message depending on the SDN protocol specifications. If the
- * current flow is equal to the new one it will be a no op.
- *
- * @param current
- * the current flow entry to modify
- * @param newone
- * the new flow entry which will replace the current one
- * @return the status of this request containing the request id associated
- * to this asynchronous request
- */
- public Status modifyFlowEntryAsync(FlowEntry current, FlowEntry newone);
-
- /**
- * It requests the FRM to replace the currently installed Flow Entry with
- * the new one through an asynchronous call. A unique request id is returned
- * to the caller. The currently installed entry is derived by the Match
- * portion of the passed Flow. FRM looks in its database for a previously
- * installed FlowEntry which Match equals the Match of the passed Flow. If
- * it finds it, it will request the SDN protocol plugin to replace the
- * existing flow with the new one on the network node. If it does not find
- * it, it will request plugin to add the new flow. If the passed entry is
- * not valid a zero request id is returned. If the existing flow is equal to
- * the passed one it will be a no op.
- *
- * @param newone
- * the new flow entry to install
- * @return the unique id associated to this request. In case of not
- * acceptable request -1 will be returned.
- */
- public Status modifyOrAddFlowEntryAsync(FlowEntry newone);
-
- /**
- * Requests ForwardingRulesManager to solicit the network node to inform us
- * about the status of its execution on the asynchronous requests that were
- * sent to it so far. It is a way for an application to poke the network
- * node in order to get a feedback asap on the asynchronous requests
- * generated by the application. The caller may decide if this is a blocking
- * or non-blocking operation. If blocking is set to true, the caller will be
- * blocked until the solicitation response is received from the network node
- * or receive timeout. Otherwise, it is a non-blocking call and does not
- * guarantee the node will respond in any given time.
- *
- * @param node
- * The network node to solicit a response
- * @param blocking
- * The blocking mode
- * @return the status of this request containing the request id associated
- * to this asynchronous request
- */
- public Status solicitStatusResponse(Node node, boolean blocking);
-
- /**
- * Check whether the passed flow entry conflicts with the Container flows
- *
- * @param flow
- * the flow entry to test
- * @return true if conflicts, false otherwise
- */
- public boolean checkFlowEntryConflict(FlowEntry flow);
-
- /**
- * Returns the list of Flow entries across network nodes which are part of
- * the same flow group, policy. This list contains the flows as they were
- * requested to be installed by the applications, before any merging with
- * container flow is done.
- *
- * @param group
- * the group name
- * @return the original list of flow entries belonging to the specified group
- */
- public List<FlowEntry> getFlowEntriesForGroup(String group);
-
- /**
- * Returns the list of Flow entries installed in network nodes which are part of
- * the same flow group, policy. This list contains the effective flows installed
- * on the nodes after the merging with any possible container flow was performed.
- * If no container flow are specified, this method returns the same list returned
- * by getFlowEntriesForGroup(String group).
- *
- * @param group
- * the group name
- * @return the list of container flow merged flow entries belonging to the specified group
- */
- public List<FlowEntry> getInstalledFlowEntriesForGroup(String policyName);
-
- /**
- * Add a list of output port to the flow with the specified name on the
- * specified network node
- *
- * @param node
- * the network node
- * @param flowName
- * the flow name
- * @param dstPort
- * the list of ports to be added to the flow output actions
- */
- public void addOutputPort(Node node, String flowName, List<NodeConnector> dstPort);
-
- /**
- * Remove a list of output port from the flow with the specified name on the
- * specified network node
- *
- * @param node
- * the network node
- * @param flowName
- * the flow name
- * @param dstPortthe
- * list of ports to be removed from the flow output actions
- */
- public void removeOutputPort(Node node, String flowName, List<NodeConnector> dstPort);
-
- /**
- * Replace the current output port in the specified flow with the specified
- * one
- *
- * @param node
- * the network node
- * @param groupName
- * the group name
- * @param flowName
- * the flow name
- * @param dstPort
- * the new output action port
- */
- public void replaceOutputPort(Node node, String flowName, NodeConnector outPort);
-
- /**
- * Returns the output port configured on the specified flow
- *
- * @param node
- * the network node
- * @param flowName
- * the flow name
- * @return the output action port for the specified flow
- */
- public NodeConnector getOutputPort(Node node, String flowName);
-
- /**
- * Returns all the troubleshooting information that applications have set
- * along with the policy they have configured through forwarding rules
- * manger.
- *
- * @return the collection of troubleshooting objects
- */
- public Map<String, Object> getTSPolicyData();
-
- /**
- * Set the troubleshooting information for the policy
- *
- * @param policyname
- * the flow group name
- * @param o
- * the object containing the troubleshooting information
- * @param add
- * true for adding, false for removing
- */
- public void setTSPolicyData(String policyName, Object o, boolean add);
-
- /**
- * Returns the troubleshooting information that was set for the specified
- * policy
- *
- * @param groupName
- * the flows group name
- * @return the troubleshooting info object
- */
- public Object getTSPolicyData(String policyName);
-
- /**
- * Returns the specifications of all the flows configured for all the
- * switches on the current container
- *
- * @return the list of flow configurations present in the database
- */
- public List<FlowConfig> getStaticFlows();
-
- /**
- * Returns the specifications of all the flows configured for the given
- * switch on the current container
- *
- * @param node
- * the network node identifier
- * @return the list of {@code FlowConfig} objects
- */
- public List<FlowConfig> getStaticFlows(Node node);
-
- /**
- * Returns the specification of the flow configured for the given network
- * node on the current container
- *
- * @param name
- * the flow name
- * @param n
- * the network node identifier
- * @return the {@code FlowConfig} object
- */
- public FlowConfig getStaticFlow(String name, Node n);
-
- /**
- * Returns the list of names of flows configured for the given Network node
- * on the current container
- *
- * @param node
- * the network node identifier
- * @return the list of flow names
- */
- public List<String> getStaticFlowNamesForNode(Node node);
-
- /**
- * Returns the list of Node(s) for which a static flow has been configured
- *
- * @return the list of network nodes
- */
- public List<Node> getListNodeWithConfiguredFlows();
-
- /**
- * Save the flow configured so far to file
- *
- * @return the {@code Status} object indicating the result of this action.
- */
- public Status saveConfig();
-
- /**
- * Add a flow specified by the {@code FlowConfig} object on the current
- * container
- *
- * @param config
- * the {@code FlowConfig} object representing the static flow
- * @return the {@code Status} object indicating the result of this action.
- */
- public Status addStaticFlow(FlowConfig config);
-
- /**
- * Add a flow specified by the {@code FlowConfig} object on the current
- * container, through an asynchronous call.
- *
- * @param config
- * the {@code FlowConfig} object representing the static flow
- * @return the {@code Status} object indicating the result of this action.
- */
- public Status addStaticFlowAsync(FlowConfig config);
-
- /**
- * Remove a flow specified by the {@code FlowConfig} object on the current
- * container
- *
- * @param config
- * the {@code FlowConfig} object representing the static flow
- * @return the {@code Status} object indicating the result of this action
- */
- public Status removeStaticFlow(FlowConfig config);
-
- /**
- * Remove a flow specified by the {@code FlowConfig} object on the current
- * container, through an asynchronous call.
- *
- * @param config
- * the {@code FlowConfig} object representing the static flow
- * @return the {@code Status} object indicating the result of this action
- */
- public Status removeStaticFlowAsync(FlowConfig config);
-
- /**
- * Replace the flow identified by the {@code FlowConfig.name} name for the
- * {@code FlowConfig.node} network node with the new flow specified by
- * {@code FlowConfig} object
- *
- * @param config
- * the {@code FlowConfig} object
- * @return the {@code Status} object indicating the result of this action
- */
- public Status modifyStaticFlow(FlowConfig config);
-
- /**
- * Remove the flow specified by name on the passed network node
- *
- * @param name
- * for the static flow
- * @param node
- * on which the flow is attached
- * @return the {@code Status} object indicating the result of this action
- */
- public Status removeStaticFlow(String name, Node node);
-
- /**
- * Remove the flow specified by name on the passed network node via an
- * asynchronous call
- *
- * @param name
- * for the static flow
- * @param node
- * on which the flow is attached
- * @return the {@code Status} object indicating the result of this action
- */
- public Status removeStaticFlowAsync(String name, Node node);
-
- /**
- * Toggle the installation status of the specified configured flow If the
- * flow configuration status is active, this call will change the flow
- * status to inactive and vice-versa
- *
- * @param configObject
- * the {@code FlowConfig} object
- * @return the {@code Status} object indicating the result of this action
- */
- public Status toggleStaticFlowStatus(FlowConfig configObject);
-
- /**
- * Toggle the installation status of the specified configured flow If the
- * flow configuration status is active, this call will change the flow
- * status to inactive and vice-versa
- *
- * @param name
- * for the static flow
- * @param node
- * on which the flow is attached
- * @return the {@code Status} object indicating the result of this action
- */
- public Status toggleStaticFlowStatus(String name, Node node);
-
- public Map<String, PortGroupConfig> getPortGroupConfigs();
-
- public boolean addPortGroupConfig(String name, String regex, boolean load);
-
- public boolean delPortGroupConfig(String name);
-
- public PortGroupProvider getPortGroupProvider();
-
- /**
- * Returns the list of Flow entries for a network node.
- * This list contains the flows as they were
- * requested to be installed by the applications, before any merging with
- * container flow is done.
- *
- * @param node
- * @return the original list of flow entries belonging to the specified node
- */
- public List<FlowEntry> getFlowEntriesForNode(Node node);
-
- /**
- * Returns the list of Flow entries installed in a network node.
- * This list contains the effective flows installed
- * on the nodes after the merging with any possible container flow was performed.
- * If no container flow are specified, this method returns the same list as returned
- * by getFlowEntriesForNode(Node node).
- *
- * @param node
- * @return the list of container flow merged flow entries belonging to the specified node
- */
- public List<FlowEntry> getInstalledFlowEntriesForNode(Node node);
-
-}