OSID Logo
OSID Specifications
topology package
Version 3.0.0
Interfaceosid.topology.GraphSearchSession
Implementsosid.topology.GraphQuerySession
Used Byosid.topology.TopologyManager
osid.topology.TopologyProxyManager
Description

This session provides methods for searching among Graph objects. The search query is constructed using the GraphQuery .

getGraphsByQuery() is the basic search method and returns a list of Graphs . A more advanced search may be performed with getGraphsBySearch() . It accepts a GraphSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getGraphsBySearch() returns a GraphSearchResults that can be used to access the resulting GraphList or be used to perform a search within the result set through GraphSearch .

Graphs may have a query record indicated by their respective record types. The query record is accessed via the GraphQuery .

MethodgetGraphSearch
Description

Gets a graph search.

Returnosid.topology.GraphSearchthe graph search
CompliancemandatoryThis method must be implemented.
MethodgetGraphSearchOrder
Description

Gets a graph search order. The GraphSearchOrder is supplied to a GraphSearch to specify the ordering of results.

Returnosid.topology.GraphSearchOrderthe graph search order
CompliancemandatoryThis method must be implemented.
MethodgetGraphsBySearch
Description

Gets the search results matching the given search query using the given search.

Parametersosid.topology.GraphQuerygraphQuerythe graph query
osid.topology.GraphSearchgraphSearchthe graph search
Returnosid.topology.GraphSearchResultsthe graph search results
ErrorsNULL_ARGUMENTgraphQuery or graphSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTEDgraphQuery or graphSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetGraphQueryFromInspector
Description

Gets a graph query from an inspector. The inspector is available from a GraphSearchResults .

Parametersosid.topology.GraphQueryInspectorgraphQueryInspectora graph query inspector
Returnosid.topology.GraphQuerythe graph query
ErrorsNULL_ARGUMENTgraphQueryInspector is null
UNSUPPORTEDgraphQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.