OSID - osid.ontology.OntologyQuerySession Service Interface Definition

Interface	osid.ontology.OntologyQuerySession
Implements	`osid.OsidSession`
Implemented By	`osid.ontology.OntologySearchSession`
Used By	`osid.ontology.OntologyManager`
Used By	`osid.ontology.OntologyProxyManager`
Description	This session provides methods for searching among `Ontology` objects. The search query is constructed using the `OntologyQuery`. Ontologies may have a query record indicated by their respective record types. The query record is accessed via the `OntologyQuery`.
Method	canSearchOntologies
Description	Tests if this user can perform `Ontology` searches. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a `PERMISSION_DENIED`. This is intended as a hint to an application that may opt not to offer search operations to unauthorized users.
Return	`boolean`		`false` if search methods are not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getOntologyQuery
Description	Gets an ontology query.
Return	`osid.ontology.OntologyQuery`		an ontology query
Compliance	`mandatory`		This method must be implemented.
Method	getOntologiesByQuery
Description	Gets a list of `Ontology` objects matching the given ontology query.
Parameters	`osid.ontology.OntologyQuery`	`ontologyQuery`	the ontology query
Return	`osid.ontology.OntologyList`		the returned `OntologyList`
Errors	NULL_ARGUMENT		`ontologyQuery` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNSUPPORTED		`ontologyQuery` is not of this service
Compliance	`mandatory`		This method must be implemented.