public interface CandidateQuerySession extends OsidSession
This session provides methods for searching among Candidate
objects. The search query is constructed using the
CandidateQuery.
This session defines views that offer differing behaviors for searching.
Candidates may have a candidate query record indicated by their
respective record types. The candidate query record is accessed via the
CandidateQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchCandidates()
Tests if this user can perform
Candidate searches. |
CandidateQuery |
getCandidateQuery()
Gets a candidate query.
|
CandidateList |
getCandidatesByQuery(CandidateQuery candidateQuery)
Gets a list of
Candidates matching the given candidate
query. |
Polls |
getPolls()
Gets the
Polls associated with this session. |
Id |
getPollsId()
Gets the
Polls Id associated with this
session. |
void |
useFederatedPollsView()
Federates the view for methods in this session.
|
void |
useIsolatedPollsView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getPollsId()
Polls
Id
associated with this
session. Polls Id
associated with this sessionmandatory
- This method must be implemented. Polls getPolls() throws OperationFailedException, PermissionDeniedException
Polls
associated with this session. Polls
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchCandidates()
Candidate
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. void useFederatedPollsView()
mandatory
- This method is must be implemented. void useIsolatedPollsView()
mandatory
- This method is must be implemented. CandidateQuery getCandidateQuery()
mandatory
- This method must be implemented. CandidateList getCandidatesByQuery(CandidateQuery candidateQuery) throws OperationFailedException, PermissionDeniedException
Candidates
matching the given candidate
query.candidateQuery
- the candidate query CandidateList
NullArgumentException
- candidateQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- candidateQuery
is
not of this servicemandatory
- This method must be implemented.