public interface PollsLookupSession extends OsidSession
This session provides methods for retrieving Polls
objects. The Polls
represents a collection races, ballots,
candidates, and votes.
This session defines views that offer differing behaviors when retrieving multiple objects.
Generally, the comparative view should be used for most applications
as it permits operation even if there is data that cannot be accessed. For
example, a browsing application may only need to examine the Polls
it can access, without breaking execution. However, an
administrative application may require all Polls
elements
to be available.
Polls may have an additional records indicated by their respective
record types. The record may not be accessed through a cast of the
Polls.
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupPolls()
Tests if this user can perform
Polls lookups. |
PollsList |
getAllPolls()
Gets all
Polls. |
Polls |
getPolls(Id pollsId)
Gets the
Polls specified by its Id. |
PollsList |
getPollsByGenusType(Type pollsGenusType)
Gets a
PollsList corresponding to the given polls genus
Type which does not include polls of types derived from
the specified Type. |
PollsList |
getPollsByIds(IdList pollsIds)
Gets a
PollsList corresponding to the given
IdList. |
PollsList |
getPollsByParentGenusType(Type pollsGenusType)
Gets a
PollsList corresponding to the given polls genus
Type and include any additional polls with genus types
derived from the specified Type. |
PollsList |
getPollsByProvider(Id resourceId)
Gets a
PollsList for the given provider. |
PollsList |
getPollsByRecordType(Type pollsRecordType)
Gets a
PollsList containing the given polls record
Type. |
void |
useComparativePollsView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
usePlenaryPollsView()
A complete view of the
Polls returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canLookupPolls()
Polls
lookups. 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 lookup operations to
unauthorized users. false
if lookup methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativePollsView()
mandatory
- This method is must be implemented. void usePlenaryPollsView()
Polls
returns is desired.
Methods will return what is requested or result in an error. This view
is used when greater precision is desired at the expense of
interoperability.mandatory
- This method is must be implemented. Polls getPolls(Id pollsId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Polls
specified by its Id.
In
plenary mode, the exact Id
is found or a
NOT_FOUND
results. Otherwise, the returned Polls
may have a different Id
than requested, such as
the case where a duplicate Id
was assigned to a
Polls
and retained for compatibility.pollsId
- Id
of the Polls
NotFoundException
- pollsId
not foundNullArgumentException
- pollsId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. PollsList getPollsByIds(IdList pollsIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
PollsList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
polls specified in the Id
list, in the order of the
list, including duplicates, or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible Polls
may be omitted from the list and may
present the elements in any order including returning a unique set.pollsIds
- the list of Ids
to retrieve Polls list
NotFoundException
- an Id
was not foundNullArgumentException
- pollsIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. PollsList getPollsByGenusType(Type pollsGenusType) throws OperationFailedException, PermissionDeniedException
PollsList
corresponding to the given polls genus
Type
which does not include polls of types derived from
the specified Type.
In plenary mode, the returned list
contains all known polls or an error results. Otherwise, the returned
list may contain only those polls that are accessible through this
session.pollsGenusType
- a polls genus type Polls list
NullArgumentException
- pollsGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. PollsList getPollsByParentGenusType(Type pollsGenusType) throws OperationFailedException, PermissionDeniedException
PollsList
corresponding to the given polls genus
Type
and include any additional polls with genus types
derived from the specified Type.
In plenary mode, the
returned list contains all known polls or an error results. Otherwise,
the returned list may contain only those polls that are accessible
through this session.pollsGenusType
- a polls genus type Polls list
NullArgumentException
- pollsGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. PollsList getPollsByRecordType(Type pollsRecordType) throws OperationFailedException, PermissionDeniedException
PollsList
containing the given polls record
Type.
In plenary mode, the returned list contains all
known polls or an error results. Otherwise, the returned list may
contain only those polls that are accessible through this session.pollsRecordType
- a polls interface type Polls list
NullArgumentException
- pollsRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. PollsList getPollsByProvider(Id resourceId) throws OperationFailedException, PermissionDeniedException
PollsList
for the given provider.
In plenary mode, the returned list contains all known polls or an
error results. Otherwise, the returned list may contain only those
polls that are accessible through this session.resourceId
- a resource Id
Polls list
NullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. PollsList getAllPolls() throws OperationFailedException, PermissionDeniedException
Polls.
In plenary mode, the returned list
contains all known polls or an error results. Otherwise, the returned
list may contain only those polls that are accessible through this
session. Polls
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.