public interface CatalogQuerySession extends OsidSession
This session provides methods for searching Catalog
objects. The search query is constructed using the CatalogQuery.
The catalog record Type
also specifies the record
for the catalog query.
Catalogs may have a query record indicated by their respective record
types. The query record is accessed via the CatalogQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchCatalogs()
Tests if this user can perform
Catalog searches. |
CatalogQuery |
getCatalogQuery()
Gets a catalog query.
|
CatalogList |
getCatalogsByQuery(CatalogQuery catalogQuery)
Gets a list of
Catalogs matching the given catalog
query. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canSearchCatalogs()
Catalog
searches. 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 opt not to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. CatalogQuery getCatalogQuery()
mandatory
- This method must be implemented. CatalogList getCatalogsByQuery(CatalogQuery catalogQuery) throws OperationFailedException, PermissionDeniedException
Catalogs
matching the given catalog
query.catalogQuery
- the catalog query CatalogList
NullArgumentException
- catalogQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- catalogQuery
is
not of this servicemandatory
- This method must be implemented.