OSID Logo
OSID Specifications
authorization package
Version 3.0.0
Release Candidate Preview
Interfaceosid.authorization.VaultSearchSession
Implementsosid.authorization.VaultQuerySession
Description

This session provides methods for searching among Vault objects. The search query is constructed using the VaultQuery.

getVaultsByQuery() is the basic search method and returns a list of Vault objects.A more advanced search may be performed with getVaultsBySearch(). It accepts a VaultSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getVaultsBySearch() returns a VaultSearchResults that can be used to access the resulting VaultList or be used to perform a search within the result set through VaultSearch.

Vaults may have a query record indicated by their respective record types. The query record is accessed via the VaultQuery.

MethodgetVaultSearch
Description

Gets a vault search.

Returnosid.authorization.VaultSearcha vault search
CompliancemandatoryThis method must be implemented.
MethodgetVaultSearchOrder
Description

Gets a vault search order. The VaultSearchOrder is supplied to a VaultSearch to specify the ordering of results.

Returnosid.authorization.VaultSearchOrderthe vault search order
CompliancemandatoryThis method must be implemented.
MethodgetVaultsBySearch
Description

Gets the search results matching the given search query using the given search.

Parametersosid.authorization.VaultQueryvaultQuerythe vault query
osid.authorization.VaultSearchvaultSearchthe vault search
Returnosid.authorization.VaultSearchResultsthe search results
ErrorsNULL_ARGUMENT vaultQuery or vaultSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED vaultQuery or vaultSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetVaultQueryFromInspector
Description

Gets a vault query from an inspector. The inspector is available from a VaultSearchResults.

Parametersosid.authorization.VaultQueryInspectorvaultQueryInspectora vault query inspector
Returnosid.authorization.VaultQuerythe vault query
ErrorsNULL_ARGUMENT vaultQueryInspector is null
UNSUPPORTED vaultQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.