public interface TopologyRoutingSession extends OsidSession
This session defines methods to route between nodes.
Modifier and Type | Method and Description |
---|---|
boolean |
areNodesConnected(Id startNodeId,
Id endNodeId)
Tests if there is an active path between the two given nodes.
|
boolean |
canTraverseTopology()
Tests if this user can traverse the topology.
|
EdgeList |
findCheapestPath(Id startNodeId,
Id endNodeId)
Gets all the edges forming lowest cost path between two nodes.
|
EdgeList |
findShortestPathByDistance(Id startNodeId,
Id endNodeId)
Gets all the edges forming shortest path by total distance between two
nodes.
|
EdgeList |
findShortestPathByHops(Id startNodeId,
Id endNodeId)
Gets all the edges forming shortest path by number of node hops
between two nodes.
|
Graph |
getGraph()
Gets the
Graph associated with this session. |
Id |
getGraphId()
Gets the
Graph Id associated with this
session. |
void |
useComparativeNodeView()
The returns from the traversal methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
useFederatedGraphView()
Federates the view for methods in this session.
|
void |
useIsolatedGraphView()
Isolates the view for methods in this session.
|
void |
usePlenaryNodeView()
A complete view of the method returns is desired.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getGraphId()
Graph
Id
associated with this
session. Graph Id
associated with this sessionmandatory
- This method must be implemented. Graph getGraph() throws OperationFailedException, PermissionDeniedException
Graph
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canTraverseTopology()
PERMISSION_DENIED.
This is intended as a hint to an
application that may not offer lookup operations to unauthorized
users. false
if topology methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeNodeView()
mandatory
- This method is must be implemented. void usePlenaryNodeView()
mandatory
- This method is must be implemented. void useFederatedGraphView()
mandatory
- This method is must be implemented. void useIsolatedGraphView()
mandatory
- This method is must be implemented. EdgeList findShortestPathByHops(Id startNodeId, Id endNodeId) throws NotFoundException, OperationFailedException, PermissionDeniedException
startNodeId
- the starting node Id
endNodeId
- the ending node Id
NotFoundException
- startNodeId
or
endNodeId
is not found or not connectedNullArgumentException
- startNodeId
or
endNodeId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EdgeList findShortestPathByDistance(Id startNodeId, Id endNodeId) throws NotFoundException, OperationFailedException, PermissionDeniedException
startNodeId
- the starting node Id
endNodeId
- the ending node Id
NotFoundException
- startNodeId
or
endNodeId
is not found or not connectedNullArgumentException
- startNodeId
or
endNodeId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EdgeList findCheapestPath(Id startNodeId, Id endNodeId) throws NotFoundException, OperationFailedException, PermissionDeniedException
startNodeId
- the starting node Id
endNodeId
- the ending node Id
NotFoundException
- startNodeId
or
endNodeId
is not found or not connectedNullArgumentException
- startNodeId
or
endNodeId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean areNodesConnected(Id startNodeId, Id endNodeId) throws OperationFailedException, PermissionDeniedException
startNodeId
- the starting node Id
endNodeId
- the ending node Id
true
if a path exists, false
otherwiseNullArgumentException
- startNodeId
or
endNodeId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.