OSID - osid.search.SearchManager Service Interface Definition

Interface	osid.search.SearchManager
Implements	`osid.OsidManager`
Implements	`osid.search.SearchProfile`
Description	The search manager provides access to search sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `SearchSession:` a session for evaluating and executing search `EngineLookupSession:` a session to retrieve engine objects `EngineQuerySession:` a session to query for engines `EngineSearchSession:` a session to search for engines `EngineAdminSession:` a session to create, update and delete engines `EngineNotificationSession:` a session to receive notifications for changes in engines `EngineHierarchySession:` a session to traverse hierarchies of engines `EngineHierarchyDesignSession:` a session to manage hierarchies of engines The search manager also provides a profile for determing the supported search types supported by this service.
Method	getSearchSession
Description	Gets the `OsidSession` associated with the search service.
Return	`osid.search.SearchSession`		a `SearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsSearch()` is `true.`
Method	getSearchSessionForEngine
Description	Gets the `OsidSession` associated with the search service for the given engine.
Parameters	`osid.id.Id`	`engineId`	the `Id` of the `Engine`
Return	`osid.search.SearchSession`		a `SearchSession`
Errors	NOT_FOUND		no `Engine` found by the given `Id`
	NULL_ARGUMENT		`engineId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsSearch()` and `supportsVisibleFederation()` are `true`
Method	getEngineLookupSession
Description	Gets the `OsidSession` associated with the engine lookup service.
Return	`osid.search.EngineLookupSession`		an `EngineLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineLookup()` is `true.`
Method	getEngineQuerySession
Description	Gets the `OsidSession` associated with the engine query service.
Return	`osid.search.EngineQuerySession`		an `EngineQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineQuery()` is `true.`
Method	getEngineSearchSession
Description	Gets the `OsidSession` associated with the engine search service.
Return	`osid.search.EngineSearchSession`		an `EngineSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineSearch()` is `true.`
Method	getEngineAdminSession
Description	Gets the `OsidSession` associated with the engine administrative service.
Return	`osid.search.EngineAdminSession`		an `EngineAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineAdmin()` is `true.`
Method	getEngineNotificationSession
Description	Gets the `OsidSession` associated with the engine notification service.
Parameters	`osid.search.EngineReceiver`	`engineReceiver`	the receiver
Return	`osid.search.EngineNotificationSession`		an `EngineNotificationSession`
Errors	NULL_ARGUMENT		`engineReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsEngineNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineNotification()` is `true.`
Method	getEngineHierarchySession
Description	Gets the `OsidSession` associated with the engine hierarchy service.
Return	`osid.search.EngineHierarchySession`		an `EngineHierarchySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineHierarchy()` is `true.`
Method	getEngineHierarchyDesignSession
Description	Gets the `OsidSession` associated with the engine hierarchy design service.
Return	`osid.search.EngineHierarchyDesignSession`		an `EngineierarchyDesignSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsEngineHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsEngineHierarchyDesign()` is `true.`