public interface CandidateSearchSession extends CandidateQuerySession
This session provides methods for searching among Candidate
objects. The search query is constructed using the
CandidateQuery.
getCandidatesByQuery()
is the basic search method and
returns a list of Candidates.
A more advanced search may be
performed with getCandidatesBySearch().
It accepts an
CandidateSearch
in addition to the query for the purpose of
specifying additional options affecting the entire search, such as
ordering. getCandidatesBySearch()
returns an
CandidateSearchResults
that can be used to access the resulting
CandidateList
or be used to perform a search within the
result set through CandidateList.
This session defines views that offer differing behaviors for searching.
Candidates may have a candidiate query record indicated by their
respective record types. The candidiate query record is accessed via the
CandidateQuery.
Modifier and Type | Method and Description |
---|---|
CandidateQuery |
getCandidateQueryFromInspector(CandidateQueryInspector candidateQueryInspector)
Gets a candidate query from an inspector.
|
CandidateSearchResults |
getCandidatesBySearch(CandidateQuery candidateQuery,
CandidateSearch candidateSearch)
Gets the search results matching the given search query using the
given search.
|
CandidateSearch |
getCandidateSearch()
Gets a candidate search.
|
CandidateSearchOrder |
getCandidateSearchOrder()
Gets a candidate search order.
|
canSearchCandidates, getCandidateQuery, getCandidatesByQuery, getPolls, getPollsId, useFederatedPollsView, useIsolatedPollsView
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
CandidateSearch getCandidateSearch()
mandatory
- This method must be implemented. CandidateSearchOrder getCandidateSearchOrder()
CandidateSearchOrder
is supplied to a CandidateSearch
to specify the
ordering of results.mandatory
- This method must be implemented. CandidateSearchResults getCandidatesBySearch(CandidateQuery candidateQuery, CandidateSearch candidateSearch) throws OperationFailedException, PermissionDeniedException
candidateQuery
- the candidate querycandidateSearch
- the candidate searchNullArgumentException
- candidateQuery
or candidateSearch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- candidateQuery
or
candidateSearch
is not of this servicemandatory
- This method must be implemented. CandidateQuery getCandidateQueryFromInspector(CandidateQueryInspector candidateQueryInspector)
CandidateSearchResults.
candidateQueryInspector
- a candidate query inspectorNullArgumentException
- candidateQueryInspector
is null
UnsupportedException
- candidateQueryInspector
is not of this servicemandatory
- This method must be implemented.