org.onosproject.net.topology

Interface PathService

All Known Implementing Classes:

AbstractPathService

public interface PathService

Service for obtaining pre-computed paths or for requesting computation of paths using the current topology snapshot.

Method Summary

Modifier and Type	Method and Description
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst) Returns the set of all disjoint shortest path pairs between the specified source and destination elements.
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst, LinkWeigher weigher) Returns the set of all disjoint shortest path pairs between the specified source and destination elements.
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst, LinkWeigher weigher, java.util.Map<Link,java.lang.Object> riskProfile) Returns the set of all disjoint shortest path pairs between the specified source and destination elements and taking into consideration the provided risk profile.
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst, LinkWeight weight) Deprecated. in Junco (1.9.0), use version with LinkWeigher instead
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst, LinkWeight weight, java.util.Map<Link,java.lang.Object> riskProfile) Deprecated. in Junco (1.9.0), use version with LinkWeigher instead
java.util.Set<DisjointPath>	getDisjointPaths(ElementId src, ElementId dst, java.util.Map<Link,java.lang.Object> riskProfile) Returns the set of all disjoint shortest path pairs between the specified source and destination elements and taking into consideration the provided risk profile.
default java.util.stream.Stream<Path>	getKShortestPaths(ElementId src, ElementId dst) Returns the k-shortest paths between source and destination devices.
default java.util.stream.Stream<Path>	getKShortestPaths(ElementId src, ElementId dst, LinkWeigher weigher) Returns the k-shortest paths between source and destination devices.
java.util.Set<Path>	getPaths(ElementId src, ElementId dst) Returns the set of all shortest paths between the specified source and destination elements.
java.util.Set<Path>	getPaths(ElementId src, ElementId dst, LinkWeigher weigher) Returns the set of all shortest paths between the specified source and destination network elements.
java.util.Set<Path>	getPaths(ElementId src, ElementId dst, LinkWeight weight) Deprecated. in Junco (1.9.0), use version with LinkWeigher instead

Method Detail

getPaths

java.util.Set<Path> getPaths(ElementId src,
                             ElementId dst)

Returns the set of all shortest paths between the specified source and destination elements. The path is computed using the default edge-weight function, which by default is hop-count.

Parameters:

src - source element

dst - destination element

Returns:

set of all shortest paths between the two elements

getPaths

@Deprecated
java.util.Set<Path> getPaths(ElementId src,
                                         ElementId dst,
                                         LinkWeight weight)

Deprecated. in Junco (1.9.0), use version with LinkWeigher instead

Returns the set of all shortest paths between the specified source and destination network elements. The path is computed using the supplied edge-weight function.

Parameters:

src - source element

dst - destination element

weight - edge-weight entity

Returns:

set of all shortest paths between the two element

getPaths

java.util.Set<Path> getPaths(ElementId src,
                             ElementId dst,
                             LinkWeigher weigher)

Returns the set of all shortest paths between the specified source and destination network elements. The path is computed using the supplied edge-weight function.

Parameters:

src - source element

dst - destination element

weigher - edge-weight entity

Returns:

set of all shortest paths between the two element

getKShortestPaths

default java.util.stream.Stream<Path> getKShortestPaths(ElementId src,
                                                        ElementId dst)

Returns the k-shortest paths between source and destination devices.

Parameters:

src - source device

dst - destination device

Returns:

stream of k-shortest paths

getKShortestPaths

default java.util.stream.Stream<Path> getKShortestPaths(ElementId src,
                                                        ElementId dst,
                                                        LinkWeigher weigher)

Returns the k-shortest paths between source and destination devices.

Parameters:

src - source device

dst - destination device

weigher - edge-weight entity

Returns:

stream of k-shortest paths

getDisjointPaths

java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                             ElementId dst)

Returns the set of all disjoint shortest path pairs between the specified source and destination elements. The path is computed using the default edge-weight function, which by default is hop-count.

Parameters:

src - source device

dst - destination device

Returns:

set of all shortest paths between the two devices

getDisjointPaths

@Deprecated
java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                                         ElementId dst,
                                                         LinkWeight weight)

Deprecated. in Junco (1.9.0), use version with LinkWeigher instead

Returns the set of all disjoint shortest path pairs between the specified source and destination elements. The path is computed using the supplied edge-weight function.

Parameters:

src - source device

dst - destination device

weight - edge-weight entity

Returns:

set of all shortest paths between the two devices

getDisjointPaths

java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                             ElementId dst,
                                             LinkWeigher weigher)

Returns the set of all disjoint shortest path pairs between the specified source and destination elements. The path is computed using the supplied edge-weight function.

Parameters:

src - source device

dst - destination device

weigher - edge-weight entity

Returns:

set of all shortest paths between the two devices

getDisjointPaths

java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                             ElementId dst,
                                             java.util.Map<Link,java.lang.Object> riskProfile)

Returns the set of all disjoint shortest path pairs between the specified source and destination elements and taking into consideration the provided risk profile. The path is computed using the default edge-weight function, which by default is hop-count.

Parameters:

src - source device

dst - destination device

riskProfile - map of edges to risk profiles

Returns:

set of all shortest paths between the two devices

getDisjointPaths

@Deprecated
java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                                         ElementId dst,
                                                         LinkWeight weight,
                                                         java.util.Map<Link,java.lang.Object> riskProfile)

Deprecated. in Junco (1.9.0), use version with LinkWeigher instead

Returns the set of all disjoint shortest path pairs between the specified source and destination elements and taking into consideration the provided risk profile. The path is computed using the supplied edge-weight function.

Parameters:

src - source device

dst - destination device

weight - edge-weight entity

riskProfile - map of edges to risk profiles

Returns:

set of all shortest paths between the two devices

getDisjointPaths

java.util.Set<DisjointPath> getDisjointPaths(ElementId src,
                                             ElementId dst,
                                             LinkWeigher weigher,
                                             java.util.Map<Link,java.lang.Object> riskProfile)

Returns the set of all disjoint shortest path pairs between the specified source and destination elements and taking into consideration the provided risk profile. The path is computed using the supplied edge-weight function.

Parameters:

src - source device

dst - destination device

weigher - edge-weight entity

riskProfile - map of edges to risk profiles

Returns:

set of all shortest paths between the two devices