Bundle Reconciliation: Close bundle on switch before reconciliation
[openflowplugin.git] / applications / forwardingrules-manager / src / main / java / org / opendaylight / openflowplugin / applications / frm / ForwardingRulesManager.java
index f6255d9b941692e3d62704474a6f5503b8eedd32..27932f87e8023e521d8242c13b5291d96de61a73 100644 (file)
@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2014 Cisco Systems, Inc. and others.  All rights reserved.
+ * Copyright (c) 2014, 2017 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,
@@ -8,10 +8,9 @@
 
 package org.opendaylight.openflowplugin.applications.frm;
 
-import org.opendaylight.openflowplugin.applications.frm.impl.ForwardingRulesManagerConfig;
-import org.opendaylight.yang.gen.v1.urn.opendaylight.table.types.rev131026.table.features.TableFeatures;
-
 import org.opendaylight.controller.md.sal.binding.api.ReadOnlyTransaction;
+import org.opendaylight.openflowplugin.api.openflow.configuration.ConfigurationListener;
+import org.opendaylight.openflowplugin.applications.frm.impl.FlowNodeConnectorInventoryTranslatorImpl;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.FlowCapableNode;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.meters.Meter;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.tables.table.Flow;
@@ -19,131 +18,157 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.service.rev130819.SalF
 import org.opendaylight.yang.gen.v1.urn.opendaylight.group.service.rev130918.SalGroupService;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.group.types.rev131018.groups.Group;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.meter.service.rev130918.SalMeterService;
+import org.opendaylight.yang.gen.v1.urn.opendaylight.openflowplugin.extension.onf.bundle.service.rev170124.SalBundleService;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.table.service.rev131026.SalTableService;
+import org.opendaylight.yang.gen.v1.urn.opendaylight.table.types.rev131026.table.features.TableFeatures;
 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
 
 /**
- * forwardingrules-manager
- * org.opendaylight.openflowplugin.applications.frm
- *
- * ForwardingRulesManager
- * It represent a central point for whole modul. Implementation
- * Flow Provider registers the link FlowChangeListener} and it holds all needed
- * services for link FlowChangeListener}.
+ * It represent a central point for whole module. Implementation Flow Provider
+ * registers the link FlowChangeListener} and it holds all needed services for
+ * link FlowChangeListener}.
  *
  * @author <a href="mailto:vdemcak@cisco.com">Vaclav Demcak</a>
- *
- * Created: Aug 25, 2014
  */
-public interface ForwardingRulesManager extends AutoCloseable {
+public interface ForwardingRulesManager extends ConfigurationListener, AutoCloseable {
 
-    public void start();
+    void start();
 
     /**
-     * Method returns information :
-     * "is Node with send InstanceIdentifier connected"?
+     * Method returns information : "is Node with send InstanceIdentifier
+     * connected"?.
      *
-     * @param ident - the key of the node
+     * @param ident
+     *            - the key of the node
      * @return boolean - true if device is connected
      */
-    public boolean isNodeActive(InstanceIdentifier<FlowCapableNode> ident);
+    boolean isNodeActive(InstanceIdentifier<FlowCapableNode> ident);
 
     /**
-     * Method add new {@link FlowCapableNode} to active Node Holder.
-     * ActiveNodeHolder prevent unnecessary Operational/DS read for identify
-     * pre-configure and serious Configure/DS transactions.
+     * Method returns information : "is Node with send InstanceIdentifier present in
+     * operational data store"?.
      *
-     * @param ident - the key of the node
+     * @param ident
+     *            - the key of the node
+     * @return boolean - true if device is present in operational data store
      */
-    public void registrateNewNode(InstanceIdentifier<FlowCapableNode> ident);
+    boolean checkNodeInOperationalDataStore(InstanceIdentifier<FlowCapableNode> ident);
 
     /**
-     * Method remove disconnected {@link FlowCapableNode} from active Node
-     * Holder. And all next flows or groups or meters will stay in Config/DS
-     * only.
+     * Method returns generated transaction ID, which is unique for every
+     * transaction. ID is composite from prefix ("DOM") and unique number.
      *
-     * @param ident - the key of the node
+     * @return String transactionID for RPC transaction identification
      */
-    public void unregistrateNode(InstanceIdentifier<FlowCapableNode> ident);
+    String getNewTransactionId();
 
     /**
-     * Method returns generated transaction ID, which is unique for
-     * every transaction. ID is composite from prefix ("DOM") and unique number.
+     * Method returns Read Transaction. It is need for Node reconciliation only.
      *
-     * @return String transactionID for RPC transaction identification
+     * @return ReadOnlyTransaction
      */
-    public String getNewTransactionId();
+    ReadOnlyTransaction getReadTranaction();
 
     /**
-     * Method returns Read Transacion. It is need for Node reconciliation only.
+     * Flow RPC service.
      *
-     * @return ReadOnlyTransaction
      */
-    public ReadOnlyTransaction getReadTranaction();
+    SalFlowService getSalFlowService();
 
     /**
-     * Flow RPC service
+     * Group RPC service.
      *
-     * @return
      */
-    public SalFlowService getSalFlowService();
+    SalGroupService getSalGroupService();
 
     /**
-     * Group RPC service
+     * Meter RPC service.
      *
-     * @return
      */
-    public SalGroupService getSalGroupService();
+    SalMeterService getSalMeterService();
 
     /**
-     * Meter RPC service
+     * Table RPC service.
      *
-     * @return
      */
-    public SalMeterService getSalMeterService();
+    SalTableService getSalTableService();
 
     /**
-     * Table RPC service
+     * Bundle RPC service.
      *
-     * @return
+     * @return salBundleService
      */
-    public SalTableService getSalTableService();
+    SalBundleService getSalBundleService();
 
     /**
-     * Content definition method and prevent code duplicity in Reconcil
-     * @return ForwardingRulesCommiter&lt;Flow&gt;
+     * Content definition method and prevent code duplicity in Reconcil.
+     *
+     * @return ForwardingRulesCommiter&lt;Flow&gt;.
      */
-    public ForwardingRulesCommiter<Flow> getFlowCommiter();
+    ForwardingRulesCommiter<Flow> getFlowCommiter();
 
     /**
-     * Content definition method and prevent code duplicity in Reconcil
+     * Content definition method and prevent code duplicity in Reconcil.
+     *
      * @return ForwardingRulesCommiter&lt;Group&gt;
      */
-    public ForwardingRulesCommiter<Group> getGroupCommiter();
+    ForwardingRulesCommiter<Group> getGroupCommiter();
 
     /**
-     * Content definition method and prevent code duplicity
+     * Content definition method and prevent code duplicity.
+     *
      * @return ForwardingRulesCommiter&lt;Meter&gt;
      */
-    public ForwardingRulesCommiter<Meter> getMeterCommiter();
+    ForwardingRulesCommiter<Meter> getMeterCommiter();
 
     /**
-     * Content definition method and prevent code duplicity
+     * Content definition method and prevent code duplicity.
+     *
      * @return ForwardingRulesCommiter&lt;Table&gt;
      */
-    public ForwardingRulesCommiter<TableFeatures> getTableFeaturesCommiter();
+    ForwardingRulesCommiter<TableFeatures> getTableFeaturesCommiter();
 
     /**
-     * Content definition method
-     * @return FlowNodeReconciliation
+     * Check if reconciliation is disabled by user.
+     *
+     * @return true if reconciliation is disabled, else false
      */
-    public FlowNodeReconciliation getFlowNodeReconciliation();
+    boolean isReconciliationDisabled();
 
     /**
-     * Returns the config-subsystem/fallback configuration of FRM
-     * @return ForwardingRulesManagerConfig
+     * Check if stale marking is enabled for switch reconciliation.
+     *
+     * @return true if stale marking is enabled, else false
      */
-    public ForwardingRulesManagerConfig getConfiguration();
+    boolean isStaleMarkingEnabled();
 
-}
+    /**
+     * Return number of reconciliation retry are allowed.
+     *
+     * @return number of retries.
+     */
+    int getReconciliationRetryCount();
+
+    /**
+     * Method checks if *this* instance of openflowplugin is owner of the given
+     * openflow node.
+     *
+     * @return True if owner, else false
+     */
+    boolean isNodeOwner(InstanceIdentifier<FlowCapableNode> ident);
 
+    /**
+     * Content definition method and prevent code duplicity.
+     *
+     * @return FlowNodeConnectorInventoryTranslatorImpl
+     */
+    FlowNodeConnectorInventoryTranslatorImpl getFlowNodeConnectorInventoryTranslatorImpl();
+
+    /**
+     * holds the value read from the configuration file openflowplugin.cfg file.
+     *
+     * @return True if user enables bundle-based-reconciliation-enabled field in
+     *         config file or False
+     */
+    boolean isBundleBasedReconciliationEnabled();
+}