OSID - osid.search.EngineQueryInspector Service Interface Definition

Interface	osid.search.EngineQueryInspector
Implements	`osid.OsidCatalogQueryInspector`
Used By	`osid.search.EngineQueryInspector`
Used By	`osid.search.EngineSearchResults`
Description	The query inspectors provide a means of accessing the match terms of a query. These interfaces are used to examine the actual query terms used in a search or that may be used to create a smart catalog. Query inspectors may be converted to `OsidQuery` interfaces for reuse or modification in the search sessions. Like all `OsidQueryInspectors`, `EngineQueryInspector` is stateful and must not be accessed by multiple processing threads.
Method	getAncestorEngineIdTerms
Description	Gets the ancestor engine `Id` query terms.
Return	`osid.search.terms.IdTerm[]`		the ancestor engine `Id` terms
Compliance	`mandatory`		This method must be implemented.
Method	getAncestorEngineTerms
Description	Gets the ancestor engine query terms.
Return	`osid.search.EngineQueryInspector[]`		the ancestor engine terms
Compliance	`mandatory`		This method must be implemented.
Method	getDescendantEngineIdTerms
Description	Gets the descendant engine `Id` query terms.
Return	`osid.search.terms.IdTerm[]`		the descendant engine `Id` terms
Compliance	`mandatory`		This method must be implemented.
Method	getDescendantEngineTerms
Description	Gets the descendant engine query terms.
Return	`osid.search.EngineQueryInspector[]`		the descendant engine terms
Compliance	`mandatory`		This method must be implemented.
Method	getEngineQueryInspectorRecord
Description	Gets the engine query inspector record corresponding to the given `Engine` record `Type`. Multiple record retrievals produce a nested boolean `OR` term.
Parameters	`osid.type.Type`	`engineRecordType`	an engine record type
Return	`osid.search.records.EngineQueryInspectorRecord`		the engine query inspector record
Errors	NULL_ARGUMENT		`engineRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNSUPPORTED		`hasRecordType(engineRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.