public interface QueueSmartDistributorSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A QueueQuery
can be retrieved from this session
and mapped to this Distributor
to create a virtual
collection of queues. The queues may be sequenced using the
QueueSearchOrder
from this session.
This Distributor
has a default query that matches any
queue and a default search order that specifies no sequencing. The queries
may be examined using a QueueQueryInspector.
The query may
be modified by converting the inspector back to a QueueQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyQueueQuery(QueueQuery queueQuery)
Applies a queue query to this distributor.
|
void |
applyQueueSequencing(QueueSearchOrder queueSearchOrder)
Applies a queue search order to this distributor.
|
boolean |
canManageSmartDistributors()
Tests if this user can manage smart distributors.
|
Distributor |
getDistributor()
Gets the
Distributor associated with this session. |
Id |
getDistributorId()
Gets the
Distributor Id associated with
this session. |
QueueQuery |
getQueueQuery()
Gets a queue query.
|
QueueQuery |
getQueueQueryFromInspector(QueueQueryInspector queueQueryInspector)
Gets a queue query from an inspector.
|
QueueSearchOrder |
getQueueSearchOrder()
Gets a queue search order.
|
QueueQueryInspector |
inspecQueueQuery()
Gets a queue query inspector for this distributor.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getDistributorId()
Distributor
Id
associated with
this session. Distributor Id
associated with this sessionmandatory
- This method must be implemented. Distributor getDistributor() throws OperationFailedException, PermissionDeniedException
Distributor
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartDistributors()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart distributor management is not
authorized, true
otherwisemandatory
- This method must be implemented. QueueQuery getQueueQuery()
mandatory
- This method must be implemented. QueueSearchOrder getQueueSearchOrder()
mandatory
- This method must be implemented. void applyQueueQuery(QueueQuery queueQuery) throws OperationFailedException, PermissionDeniedException
queueQuery
- the queue queryNullArgumentException
- queueQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- queueQuery
not of
this servicemandatory
- This method must be implemented. QueueQueryInspector inspecQueueQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyQueueSequencing(QueueSearchOrder queueSearchOrder) throws OperationFailedException, PermissionDeniedException
queueSearchOrder
- the queue search orderNullArgumentException
- queueSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- queueSearchOrder
not of this servicemandatory
- This method must be implemented. QueueQuery getQueueQueryFromInspector(QueueQueryInspector queueQueryInspector)
queueQueryInspector
- a queue query inspectorNullArgumentException
- queueQueryInspector
is null
UnsupportedException
- queueQueryInspector
is not of this servicemandatory
- This method must be implemented.