public interface SubscriptionQuerySession extends OsidSession
This session provides methods for searching Subscription
objects. The search query is constructed using the
SubscriptionQuery.
The dispatch record Type
also
specifies the record for the dispatch query.
Subscriptions may have a query record indicated by their respective
record types. The query record is accessed via the
SubscriptionQuery.
The returns in this session may not be cast
directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchSubscriptions()
Tests if this user can perform susbcription searches.
|
Publisher |
getPublisher()
Gets the
Publisher associated with this session. |
Id |
getPublisherId()
Gets the
Publisher Id associated with
this session. |
SubscriptionQuery |
getSubscriptionQuery()
Gets a subscription query.
|
SubscriptionList |
getSubscriptionsByQuery(SubscriptionQuery subscriptionQuery)
Gets a list of subscriptions matching the given subscription query.
|
void |
useFederatedPublisherView()
Federates the view for methods in this session.
|
void |
useIsolatedPublisherView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getPublisherId()
Publisher
Id
associated with
this session. Publisher Id
associated with this sessionmandatory
- This method must be implemented. Publisher getPublisher() throws OperationFailedException, PermissionDeniedException
Publisher
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchSubscriptions()
PERMISSION_DENIED.
This is intended as a hint to an
application that may not wish to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedPublisherView()
mandatory
- This method is must be implemented. void useIsolatedPublisherView()
mandatory
- This method is must be implemented. SubscriptionQuery getSubscriptionQuery()
mandatory
- This method must be implemented. SubscriptionList getSubscriptionsByQuery(SubscriptionQuery subscriptionQuery) throws OperationFailedException, PermissionDeniedException
subscriptionQuery
- the subscription query SubscriptionList
NullArgumentException
- subscriptionQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- subscriptionQuery
is not of this servicemandatory
- This method must be implemented.