OSID - osid.course.CourseCatalogQuerySession Service Interface Definition

Interface	osid.course.CourseCatalogQuerySession
Implements	`osid.OsidSession`
Implemented By	`osid.course.CourseCatalogSearchSession`
Used By	`osid.course.CourseManager`
Used By	`osid.course.CourseProxyManager`
Description	This session provides methods for searching among `CourseCatalogs`. The search query is constructed using the `CourseCatalogQuery`. This session defines views that offer differing behaviors for searching. federated course catalog view: searches include course catalogs in course catalogs of which this course catalog is an ancestor in the course catalog hierarchy isolated course catalog view: searches are restricted to course catalogs in this course catalog Course catalogs may have a query record indicated by their respective record types. The query record is accessed via the `CourseCatalogQuery`.
Method	canSearchCourseCatalogs
Description	Tests if this user can perform `CourseCatalog` lookups. 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 not offer lookup operations to unauthorized users.
Return	`boolean`		`false` if search methods are not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getCourseCatalogQuery
Description	Gets a course catalog query.
Return	`osid.course.CourseCatalogQuery`		the course catalog query
Compliance	`mandatory`		This method must be implemented.
Method	getCourseCatalogsByQuery
Description	Gets a list of `CourseCatalogs` matching the given course catalog query.
Parameters	`osid.course.CourseCatalogQuery`	`courseCatalogQuery`	the course catalog query
Return	`osid.course.CourseCatalogList`		the returned `CourseCatalogList`
Errors	NULL_ARGUMENT		`courseCatalogQuery` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNSUPPORTED		`courseCatalogQuery` is not of this service
Compliance	`mandatory`		This method must be implemented.