public interface SubscriptionSearchSession extends SubscriptionQuerySession
This session provides methods for searching Subscription
objects. The search query is constructed using the
SubscriptionQuery.
The subscription record Type
also specifies the record for the subscription query.
getSubscriptionsByQuery()
is the basic search method
and returns a list of Publisher
elements. A more advanced
search may be performed with getSubscriptionsBySearch().
It
accepts a SubscriptionSearch
in addition to the query for
the purpose of specifying additional options affecting the entire search,
such as ordering. getSubscriptionsBySearch()
returns a
SubscriptionSearchResults
that can be used to access the
resulting SubscriptionList
or be used to perform a search
within the result set through SubscriptionSearch.
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 |
---|---|
SubscriptionQuery |
getSubscriptionQueryFromInspector(SubscriptionQueryInspector subscriptionQueryInspector)
Gets an entry query from an inspector.
|
SubscriptionSearchResults |
getSubscriptionsBySearch(SubscriptionQuery subscriptionQuery,
SubscriptionSearch subscriptionSearch)
Gets the subscription search results matching the given search.
|
SubscriptionSearch |
getSubscriptionSearch()
Gets a subscription search.
|
SubscriptionSearchOrder |
getSubscriptionSearchOrder()
Gets a subscription search order.
|
canSearchSubscriptions, getPublisher, getPublisherId, getSubscriptionQuery, getSubscriptionsByQuery, useFederatedPublisherView, useIsolatedPublisherView
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
SubscriptionSearch getSubscriptionSearch()
mandatory
- This method must be implemented. SubscriptionSearchOrder getSubscriptionSearchOrder()
SubscriptionSearchOrder
is supplied to a SubscriptionSearch
to specify
the ordering of results.mandatory
- This method must be implemented. SubscriptionSearchResults getSubscriptionsBySearch(SubscriptionQuery subscriptionQuery, SubscriptionSearch subscriptionSearch) throws OperationFailedException, PermissionDeniedException
subscriptionQuery
- the subscription querysubscriptionSearch
- the subscription searchNullArgumentException
- subscriptionQuery
or subscriptionSearch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- subscriptionQuery
or subscriptionSearch
is not of this servicemandatory
- This method must be implemented. SubscriptionQuery getSubscriptionQueryFromInspector(SubscriptionQueryInspector subscriptionQueryInspector)
SubscriptionSearchResults.
subscriptionQueryInspector
- a query inspectorNullArgumentException
-
subscriptionQueryInspector
is null
UnsupportedException
-
subscriptionQueryInspector
is not of this servicemandatory
- This method must be implemented.