Merge "Fail toggle flow if port is no longer a part of slice"

[controller.git] / opendaylight / topologymanager / src / main / java / org / opendaylight / controller / topologymanager / ITopologyManager.java

diff --git a/opendaylight/topologymanager/src/main/java/org/opendaylight/controller/topologymanager/ITopologyManager.java b/opendaylight/topologymanager/src/main/java/org/opendaylight/controller/topologymanager/ITopologyManager.java
index 73bbc4a29b41c7d5c8ff4d1b33e72f42da77a8e2..1f377593bb8282cb6f303354531e4b6368f5c1ff 100644 (file)
--- a/opendaylight/topologymanager/src/main/java/org/opendaylight/controller/topologymanager/ITopologyManager.java
+++ b/opendaylight/topologymanager/src/main/java/org/opendaylight/controller/topologymanager/ITopologyManager.java
@@ -9,6 +9,7 @@
 
 package org.opendaylight.controller.topologymanager;
 
+import java.util.List;
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.ConcurrentMap;
@@ -22,8 +23,7 @@ import org.opendaylight.controller.sal.core.UpdateType;
 import org.opendaylight.controller.sal.utils.Status;
 
 /**
- * Interface class that provides methods to interact with
- * network topology database
+ * The Interface provides methods to interact with network topology database.
  */
 public interface ITopologyManager {
     /**
@@ -68,12 +68,23 @@ public interface ITopologyManager {
     public Set<NodeConnector> getNodeConnectorWithHost();
 
     /**
-     * Return the Host attached to a NodeConnector with Host
-     *
+     * Return the Host attached to a NodeConnector with Host.
+     * Multiple hosts maybe attached to a node connector.
+     * This method returns the first one only. Hence it has been
+     * deprecated. Use the new method getHostsAttachedToNodeConnector
+     * that returns the complete list of hosts.
      * @return The Host attached to a NodeConnector
      */
+    @Deprecated
     public Host getHostAttachedToNodeConnector(NodeConnector p);
 
+    /**
+     * Returns a list of hosts attached to a NodeConnector
+     * @param p NodeConnector
+     * @return The list of hosts attached to a NodeConnector
+     */
+    public List<Host> getHostsAttachedToNodeConnector(NodeConnector p);
+
     /**
      * Returns a copy map which associates every node with all the
      * NodeConnectors of the node that have an Host attached to it