OSID - osid.authorization.AuthorizationSearchSession Service Interface Definition

Interface	osid.authorization.AuthorizationSearchSession
Implements	`osid.authorization.AuthorizationQuerySession`
Used By	`osid.authorization.AuthorizationManager`
Used By	`osid.authorization.AuthorizationProxyManager`
Description	This session provides methods for searching `Authorization` objects. The search query is constructed using the `AuthorizationQuery`. `getAuthorizationsByQuery()` is the basic search method and returns a list of `Authorizations`. A more advanced search may be performed with `getAuthorizationsBySearch()`.It accepts an `AgentSearch` in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. `getAuthorizationssBySearch()` returns an `AuthorizationSearchResults` that can be used to access the resulting `AuthorizationList` or be used to perform a search within the result set through `AuthorizationSearch`. This session defines views that offer differing behaviors for searching. federated view: searches include authorizations in `Vaults` of which this vault is an ancestor in the vault hierarchy isolated view: searches are restricted to authorizations in this `Vault` implicit authorization view: authorizations include implicit authorizations explicit authorization view: only explicit authorizations are returned
Method	getAuthorizationSearch
Description	Gets an authorization search.
Return	`osid.authorization.AuthorizationSearch`		the authorization search
Compliance	`mandatory`		This method must be implemented.
Method	getAuthorizationSearchOrder
Description	Gets an authorization search order. The `AuthorizationSearchOrder` is supplied to an `AuthorizationSearch` to specify the ordering of results.
Return	`osid.authorization.AuthorizationSearchOrder`		the authorization search order
Compliance	`mandatory`		This method must be implemented.
Method	getAuthorizationsBySearch
Description	Gets the search results matching the given search query using the given search.
Parameters	`osid.authorization.AuthorizationQuery`	`authorizationQuery`	the authorization query
Parameters	`osid.authorization.AuthorizationSearch`	`authorizationSearch`	the authorization search
Return	`osid.authorization.AuthorizationSearchResults`		the returned search results
Errors	NULL_ARGUMENT		`authorizationQuery` or `authorizationSearch` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNSUPPORTED		`authorizationSearch` or `authorizationQuery` is not of this service
Compliance	`mandatory`		This method must be implemented.
Method	getAuthorizationQueryFromInspector
Description	Gets an authorization query from an inspector. The inspector is available from an `AuthorizationSearchResults`.
Parameters	`osid.authorization.AuthorizationQueryInspector`	`authorizationQueryInspector`	an authorization query inspector
Return	`osid.authorization.AuthorizationQuery`		the authorization query
Errors	NULL_ARGUMENT		`authorizationQueryInspector` is `null`
Errors	UNSUPPORTED		`authorizationQueryInspector` is not of this service
Compliance	`mandatory`		This method must be implemented.