public interface ResponseSmartInquestSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A ResponseQuery
can be retrieved from this
session and inquestped to this Inquest
to create a virtual
collection of Responses.
The responses may be sequenced
using the ResponseSearchOrder
from this session.
This Inquest
has a default query that matches any
response and a default search order that specifies no sequencing. The
queries may be examined using a ResponseQueryInspector.
The
query may be modified by converting the inspector back to a
ResponseQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyResponseQuery(ResponseQuery responseQuery)
Applies a response query to this inquest.
|
void |
applyResponseSequencing(ResponseSearchOrder responseSearchOrder)
Applies a response search order to this inquest.
|
boolean |
canManageSmartInquests()
Tests if this user can manage smart inquests.
|
Inquest |
getInquest()
Gets the
Inquest associated with this session. |
Id |
getInquestId()
Gets the
Inquest Id associated with this
session. |
ResponseQuery |
getResponseQuery()
Gets a response query.
|
ResponseQuery |
getResponseQueryFromInspector(ResponseQueryInspector responseQueryInspector)
Gets a response query from an inspector.
|
ResponseSearchOrder |
getResponseSearchOrder()
Gets a response search order.
|
ResponseQueryInspector |
inspectResponseQuery()
Gets a response query inspector for this inquest.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getInquestId()
Inquest
Id
associated with this
session. Inquest Id
associated with this sessionmandatory
- This method must be implemented. Inquest getInquest() throws OperationFailedException, PermissionDeniedException
Inquest
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartInquests()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart inquest management is not
authorized, true
otherwisemandatory
- This method must be implemented. ResponseQuery getResponseQuery()
mandatory
- This method must be implemented. ResponseSearchOrder getResponseSearchOrder()
mandatory
- This method must be implemented. void applyResponseQuery(ResponseQuery responseQuery) throws OperationFailedException, PermissionDeniedException
responseQuery
- the response queryNullArgumentException
- responseQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- responseQuery
not
of this servicemandatory
- This method must be implemented. ResponseQueryInspector inspectResponseQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyResponseSequencing(ResponseSearchOrder responseSearchOrder) throws OperationFailedException, PermissionDeniedException
responseSearchOrder
- the response search orderNullArgumentException
- responseSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- responseSearchOrder
not of this servicemandatory
- This method must be implemented. ResponseQuery getResponseQueryFromInspector(ResponseQueryInspector responseQueryInspector)
responseQueryInspector
- a response query inspectorNullArgumentException
- responseQueryInspector
is null
UnsupportedException
- responseQueryInspector
is not of this servicemandatory
- This method must be implemented.