public interface TermSmartCourseCatalogSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A TermQuery
can be retrieved from this session
and mapped to this CourseCatalog
to create a virtual
collection of Terms.
The terms may be sequenced using the
TermSearchOrder
from this session.
This CourseCatalog
has a default query that matches any
term and a default search order that specifies no sequencing. The queries
may be examined using a TermQueryInspector.
The query may
be modified by converting the inspector back to a TermQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyTermQuery(TermQuery termQuery)
Applies a term query to this course catalog.
|
void |
applyTermSequencing(TermSearchOrder termSearchOrder)
Applies a term search order to this course catalog.
|
boolean |
canManageSmartCourseCatalogs()
Tests if this user can manage smart course catalogs.
|
CourseCatalog |
getCourseCatalog()
Gets the
CourseCatalog associated with this session. |
Id |
getCourseCatalogId()
Gets the
CourseCatalog Id associated
with this session. |
TermQuery |
getTermQuery()
Gets a term query.
|
TermQuery |
getTermQueryFromInspector(TermQueryInspector termQueryInspector)
Gets a term query from an inspector.
|
TermSearchOrder |
getTermSearchOrder()
Gets a term search order.
|
TermQueryInspector |
inspectTermQuery()
Gets a term query inspector for this course catalog.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCourseCatalogId()
CourseCatalog
Id
associated
with this session. CourseCatalog Id
associated with this
sessionmandatory
- This method must be implemented. CourseCatalog getCourseCatalog() throws OperationFailedException, PermissionDeniedException
CourseCatalog
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartCourseCatalogs()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart course catalog management is not
authorized, true
otherwisemandatory
- This method must be implemented. TermQuery getTermQuery()
mandatory
- This method must be implemented. TermSearchOrder getTermSearchOrder()
mandatory
- This method must be implemented. void applyTermQuery(TermQuery termQuery) throws OperationFailedException, PermissionDeniedException
termQuery
- the term queryNullArgumentException
- termQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- termQuery
not of
this servicemandatory
- This method must be implemented. TermQueryInspector inspectTermQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyTermSequencing(TermSearchOrder termSearchOrder) throws OperationFailedException, PermissionDeniedException
termSearchOrder
- the term search orderNullArgumentException
- termSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- termSearchOrder
not of this servicemandatory
- This method must be implemented. TermQuery getTermQueryFromInspector(TermQueryInspector termQueryInspector)
termQueryInspector
- a query inspectorNullArgumentException
- termQueryInspector
is null
UnsupportedException
- termQueryInspector
is not of this servicemandatory
- This method must be implemented.