OSID Logo
OSID Specifications
topology package
Version 3.0.0
Interfaceosid.topology.TopologyProxyManager
Implementsosid.OsidProxyManager
osid.topology.TopologyProfile
Used Byosid.orchestration.OrchestrationManager
Description

The topology manager provides access to topology sessions and provides interoperability tests for various aspects of this service. Methods in this manager include a Proxy for passing information from server environments.The sessions included in this manager are:

  • TopologyTraversalSession : a session to traverse topologies
  • TopologyRoutingSession : a session get routes through topologies
  • NodeLookupSession : a session to retrieve nodes
  • NodeQuerySession : a session to query nodes
  • NodeSearchSession : a session to search for nodes
  • NodeAdminSession : a session to create and delete nodes
  • NodeNotificationSession : a session to receive notifications pertaining to node changes
  • NodeGraphSession : a session to look up node to graph mappings
  • NodeGraphAssignmentSession : a session to manage node to graph mappings
  • NodeSmartGraphSession : a session to manage smart graphs of nodes
  • EdgeLookupSession : a session to retrieve edges
  • EdgeQuerySession: a session to query edges
  • EdgeSearchSession : a session to search for edges
  • EdgeAdminSession : a session to create and delete edges
  • EdgeNotificationSession : a session to receive notifications pertaining to edge changes
  • EdgeGraphSession : a session to looking mappings of edges to graphs
  • EdgeGraphAssignmentSession : a session to manage edge to graph mappings
  • EdgeSmartGraphSession : a session to manage smart graphs of edges
  • GraphLookupSession : a session to retrieve graphs
  • GraphQuerySession : a session to query for graphs
  • GraphSearchSession : a session to search for graphs
  • GraphAdminSession : a session to create and delete graphs
  • GraphNotificationSession : a session to receive notifications pertaining to graph changes
  • GraphHierarchySession : a session to traverse a hierarchy of graph
  • GraphHierarchyDesignSession : a session to manage a graph hierarchy
MethodgetTopologyTraversalSession
Description

Gets the OsidSession associated with the topology traversal service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.TopologyTraversalSessiona TopologyTraversalSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyTraversal() is false
ComplianceoptionalThis method must be implemented if supportsTopologyTraversal() is true .
MethodgetTopologyTraversalForGraph
Description

Gets the OsidSession associated with the topology traversal service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.TopologyTraversalSessiona TopologyTraversalSession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyTraversal() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsTopologyTraversal() and supportsVisibleFederation() are true
MethodgetTopologyRoutingSession
Description

Gets the OsidSession associated with the topology routing service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.TopologyRoutingSessiona TopologyRoutingSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyRouting() is false
ComplianceoptionalThis method must be implemented if supportsTopologyRouting() is true .
MethodgetTopologyRoutingForGraph
Description

Gets the OsidSession associated with the topology routing service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.TopologyRoutingSessiona TopologyRoutingSession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyRouting() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsTopologyRouting() and supportsVisibleFederation() are true
MethodgetNodeLookupSession
Description

Gets the OsidSession associated with the node lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeLookupSessiona NodeLookupSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeLookup() is false
ComplianceoptionalThis method must be implemented if supportsNodeLookup() is true .
MethodgetNodeLookupSessionForGraph
Description

Gets the OsidSession associated with the node lookup service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeLookupSessiona NodeLookupSession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsNodeLookup() and supportsVisibleFederation() are true
MethodgetNodeQuerySession
Description

Gets the OsidSession associated with the node query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeQuerySessiona NodeQuerySession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeQuery() is false
ComplianceoptionalThis method must be implemented if supportsNodeQuery() is true .
MethodgetNodeQuerySessionForGraph
Description

Gets the OsidSession associated with the node query service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeQuerySessiona NodeQuerySession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsNodeQuery() and supportsVisibleFederation() are true
MethodgetNodeSearchSession
Description

Gets the OsidSession associated with the node search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeSearchSessiona NodeSearchSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeSearch() is false
ComplianceoptionalThis method must be implemented if supportsNodeSearch() is true .
MethodgetNodeSearchSessionForGraph
Description

Gets the OsidSession associated with the node search service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeSearchSessiona NodeSearchSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeSearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsNodeSearch() and supportsVisibleFederation() are true
MethodgetNodeAdminSession
Description

Gets the OsidSession associated with the node administration service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeAdminSessiona NodeAdminSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeAdmin() is false
ComplianceoptionalThis method must be implemented if supportsNodeAdmin() is true .
MethodgetNodeAdminSessionForGraph
Description

Gets the OsidSession associated with the node administration service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeAdminSessiona NodeAdminSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeAdmin() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsNodeAdmin() and supportsVisibleFederation() are true
MethodgetNodeNotificationSession
Description

Gets the OsidSession associated with the node notification service.

Parametersosid.topology.NodeReceivernodeReceiverthe notification callback
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeNotificationSessiona NodeNotificationSession
ErrorsNULL_ARGUMENTnodeReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeNotification() is false
ComplianceoptionalThis method must be implemented if supportsNodeNotification() is true .
MethodgetNodeNotificationSessionForGraph
Description

Gets the OsidSession associated with the node notification service for the given graph.

Parametersosid.topology.NodeReceivernodeReceiverthe notification callback
osid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeNotificationSessiona NodeNotificationSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTnodeReceiver, graphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsNodeNotification() and supportsVisibleFederation() are true
MethodgetNodeGraphSession
Description

Gets the OsidSession to lookup node/graph mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeGraphSessiona NodeGraphSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeGraph() is false
ComplianceoptionalThis method must be implemented if supportsNodeGraph() is true .
MethodgetNodeGraphAssignmentSession
Description

Gets the OsidSession associated with assigning nodes to graphs.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.NodeGraphAssignmentSessiona NodeGraphAssignmentSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeGraphAssignment() is false
ComplianceoptionalThis method must be implemented if supportsNodeGraphAssignment() is true .
MethodgetNodeSmartGraphSession
Description

Gets the OsidSession to manage dynamic graphs of retlationships.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.NodeSmartGraphSessiona NodeSmartGraphSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsNodeSmartGraph() is false
ComplianceoptionalThis method must be implemented if supportsNodeSmartGraph() is true .
MethodgetEdgeLookupSession
Description

Gets the OsidSession associated with the edge lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeLookupSessionan EdgeLookupSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeLookup() is false
ComplianceoptionalThis method must be implemented if supportsEdgeLookup() is true .
MethodgetEdgeLookupSessionForGraph
Description

Gets the OsidSession associated with the edge lookup service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeLookupSessionan EdgeLookupSession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEdgeLookup() and supportsVisibleFederation() are true
MethodgetEdgeQuerySession
Description

Gets the OsidSession associated with the edge query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeQuerySessionan EdgeQuerySession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeQuery() is false
ComplianceoptionalThis method must be implemented if supportsEdgeQuery() is true .
MethodgetEdgeQuerySessionForGraph
Description

Gets the OsidSession associated with the edge query service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeQuerySessionan EdgeQuerySession
ErrorsNOT_FOUNDno Graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEdgeQuery() and supportsVisibleFederation() are true
MethodgetEdgeSearchSession
Description

Gets the OsidSession associated with the edge search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeSearchSessionan EdgeSearchSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeSearch() is false
ComplianceoptionalThis method must be implemented if supportsEdgeSearch() is true .
MethodgetEdgeSearchSessionForGraph
Description

Gets the OsidSession associated with the edge search service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeSearchSessionan EdgeSearchSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeSearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEdgeSearch() and supportsVisibleFederation() are true
MethodgetEdgeAdminSession
Description

Gets the OsidSession associated with the edge administration service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeAdminSessionan EdgeAdminSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeAdmin() is false
ComplianceoptionalThis method must be implemented if supportsEdgeAdmin() is true .
MethodgetEdgeAdminSessionForGraph
Description

Gets the OsidSession associated with the edge administration service for the given graph.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeAdminSessionan EdgeAdminSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeAdmin() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEdgeAdmin() and supportsVisibleFederation() are true
MethodgetEdgeNotificationSession
Description

Gets the OsidSession associated with the edge notification service.

Parametersosid.topology.EdgeReceiveredgeReceiverthe notification callback
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeNotificationSessionan EdgeNotificationSession
ErrorsNULL_ARGUMENTedgeReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeNotification() is false
ComplianceoptionalThis method must be implemented if supportsEdgeNotification() is true .
MethodgetEdgeNotificationSessionForGraph
Description

Gets the OsidSession associated with the edge notification service for the given graph.

Parametersosid.topology.EdgeReceiveredgeReceiverthe notification callback
osid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeNotificationSessionan EdgeNotificationSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTedgeReceiver, graphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEdgeNotification() and supportsVisibleFederation() are true
MethodgetEdgeGraphSession
Description

Gets the OsidSession to lookup edge/graph mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeGraphSessionan EdgeGraphSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeGraph() is false
ComplianceoptionalThis method must be implemented if supportsEdgeGraph() is true .
MethodgetEdgeGraphAssignmentSession
Description

Gets the OsidSession associated with assigning edges to graphs.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeGraphAssignmentSessionan EdgeGraphAssignmentSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeGraphAssignment() is false
ComplianceoptionalThis method must be implemented if supportsEdgeGraphAssignment() is true .
MethodgetEdgeSmartGraphSession
Description

Gets the OsidSession to manage dynamic graphs of retlationships.

Parametersosid.id.IdgraphIdthe Id of the Graph
osid.proxy.Proxyproxya proxy
Returnosid.topology.EdgeSmartGraphSessionan EdgeSmartGraphSession
ErrorsNOT_FOUNDno graph found by the given Id
NULL_ARGUMENTgraphId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsEdgeSmartGraph() is false
ComplianceoptionalThis method must be implemented if supportsEdgeSmartGraph() is true .
MethodgetGraphLookupSession
Description

Gets the OsidSession associated with the graph lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphLookupSessiona GraphLookupSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphLookup() is false
ComplianceoptionalThis method must be implemented if supportsGraphLookup() is true .
MethodgetGraphQuerySession
Description

Gets the OsidSession associated with the graph query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphQuerySessiona GraphQuerySession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphQuery() is false
ComplianceoptionalThis method must be implemented if supportsFamilQuery() is true .
MethodgetGraphSearchSession
Description

Gets the OsidSession associated with the graph search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphSearchSessiona GraphSearchSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphSearch() is false
ComplianceoptionalThis method must be implemented if supportsGraphSearch() is true .
MethodgetGraphAdminSession
Description

Gets the OsidSession associated with the graph administrative service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphAdminSessiona GraphAdminSession
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphAdmin() is false
ComplianceoptionalThis method must be implemented if supportsGraphAdmin() is true .
MethodgetGraphNotificationSession
Description

Gets the OsidSession associated with the graph notification service.

Parametersosid.topology.GraphReceivergraphReceiverthe notification callback
osid.proxy.Proxyproxya proxy
Returnosid.topology.GraphNotificationSessiona GraphNotificationSession
ErrorsNULL_ARGUMENTgraphReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphNotification() is false
ComplianceoptionalThis method must be implemented if supportsGraphNotification() is true .
MethodgetGraphHierarchySession
Description

Gets the OsidSession associated with the graph hierarchy service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphHierarchySessiona GraphHierarchySession for graphs
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphHierarchy() is false
ComplianceoptionalThis method must be implemented if supportsGraphHierarchy() is true .
MethodgetGraphHierarchyDesignSession
Description

Gets the OsidSession associated with the graph hierarchy design service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.topology.GraphHierarchyDesignSessiona HierarchyDesignSession for graphs
ErrorsNULL_ARGUMENTproxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsGraphHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsGraphHierarchyDesign() is true .
MethodgetTopologyBatchProxyManager
Description

Gets a TopologyBatchManager .

Returnosid.topology.batch.TopologyBatchProxyManagera TopologyBatchProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyBatch() is false
ComplianceoptionalThis method must be implemented if supportsTopologyBatch() is true .
MethodgetTopologyPathProxyManager
Description

Gets a TopologyPathManager .

Returnosid.topology.path.TopologyPathProxyManagera TopologyPathProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyPath() is false
ComplianceoptionalThis method must be implemented if supportsTopologyPath() is true .
MethodgetTopologyRulesProxyManager
Description

Gets a TopologyRulesManager .

Returnosid.topology.rules.TopologyRulesProxyManagera TopologyRulesProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTEDsupportsTopologyRules() is false
ComplianceoptionalThis method must be implemented if supportsTopologyRules() is true .