Interface DispatchConstrainerEnablerSmartPublisherSession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A DispatchConstrainerEnablerQuery can be retrieved from
this session and mapped to this Publisher to create a virtual
collection of DispatchConstrainerEnablers . The dispatch
constrainer enablers may be sequenced using the
DispatchConstrainerEnablerSearchOrder from this session.
This Publisher has a default query that matches any dispatch
constrainer enabler and a default search order that specifies no
sequencing. The queries may be examined using a
DispatchConstrainerEnablerQueryInspector . The query may be modified by
converting the inspector back to a DispatchConstrainerEnablerQuery
.
-
Method Summary
Modifier and TypeMethodDescriptionvoidapplyDispatchConstrainerEnablerQuery(DispatchConstrainerEnablerQuery dispatchConstrainerEnablerQuery) Applies a dispatch constrainer enabler query to this publisher.voidapplyDispatchConstrainerEnablerSequencing(DispatchConstrainerEnablerSearchOrder dispatchConstrainerEnablerSearchOrder) Applies a dispatch constrainer enabler search order to this publisher.booleanTests if this user can manage smart publishers.Gets a dispatch constrainer enabler query.getDispatchConstrainerEnablerQueryFromInspector(DispatchConstrainerEnablerQueryInspector dispatchConstrainerEnablerQueryInspector) Gets a dispatch constrainer enabler query from an inspector.Gets a dispatch constrainer enabler search order.Gets thePublisherassociated with this session.Gets thePublisherIdassociated with this session.Gets a dispatch constrainer enabler query inspector for this publisher.Methods inherited from interface OsidSession
closeMethods inherited from interface OsidSession
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactionsModifier and TypeMethodDescriptionGets the agent authenticated to this session.Gets theIdof the agent authenticated to this session.Gets the rate of the service clock.getDate()Gets the service date which may be the current date or the effective date in which this session exists.Gets the effective agent in use by this session.Gets theIdof the effective agent in use by this session.Gets theDisplayTextformatTypepreference in effect for this session.Gets the locale indicating the localization preferences in effect for this session.booleanTests if an agent is authenticated to this session.Starts a new transaction for this sesson.booleanTests for the availability of transactions.
-
Method Details
-
getPublisherId
Id getPublisherId()Gets thePublisherIdassociated with this session.- Returns:
- the
Publisher Idassociated with this session - Compliance:
mandatory- This method must be implemented.
-
getPublisher
Gets thePublisherassociated with this session.- Returns:
- the publisher
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
canManageSmartPublishers
boolean canManageSmartPublishers()Tests if this user can manage smart publishers. A return of true does not guarantee successful authorization. A return of false indicates that it is known methods in this session will result in aPERMISSION_DENIED.This is intended as a hint to an application that may opt not to offer operations to unauthorized users.- Returns:
falseif smart publisher management is not authorized,trueotherwise- Compliance:
mandatory- This method must be implemented.
-
getDispatchConstrainerEnablerQuery
DispatchConstrainerEnablerQuery getDispatchConstrainerEnablerQuery()Gets a dispatch constrainer enabler query.- Returns:
- the dispatch constrainer enabler query
- Compliance:
mandatory- This method must be implemented.
-
getDispatchConstrainerEnablerSearchOrder
DispatchEnablerSearchOrder getDispatchConstrainerEnablerSearchOrder()Gets a dispatch constrainer enabler search order.- Returns:
- the dispatch constrainer enabler search order
- Compliance:
mandatory- This method must be implemented.
-
applyDispatchConstrainerEnablerQuery
void applyDispatchConstrainerEnablerQuery(DispatchConstrainerEnablerQuery dispatchConstrainerEnablerQuery) throws OperationFailedException, PermissionDeniedException Applies a dispatch constrainer enabler query to this publisher.- Parameters:
dispatchConstrainerEnablerQuery- the dispatch constrainer enabler query- Throws:
NullArgumentException-dispatchConstrainerEnablerQueryisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurredUnsupportedException-dispatchConstrainerEnablerQuerynot of this service- Compliance:
mandatory- This method must be implemented.
-
inspectDispatchConstrainerEnablerQuery
DispatchConstrainerEnablerQueryInspector inspectDispatchConstrainerEnablerQuery() throws OperationFailedException, PermissionDeniedExceptionGets a dispatch constrainer enabler query inspector for this publisher.- Returns:
- the dispatch constrainer enabler query inspector
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurred- Compliance:
mandatory- This method must be implemented.
-
applyDispatchConstrainerEnablerSequencing
void applyDispatchConstrainerEnablerSequencing(DispatchConstrainerEnablerSearchOrder dispatchConstrainerEnablerSearchOrder) throws OperationFailedException, PermissionDeniedException Applies a dispatch constrainer enabler search order to this publisher.- Parameters:
dispatchConstrainerEnablerSearchOrder- the dispatch constrainer enabler search order- Throws:
NullArgumentException-dispatchConstrainerEnablerSearchOrderisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurredUnsupportedException-dispatchConstrainerEnablerSearchOrdernot of this service- Compliance:
mandatory- This method must be implemented.
-
getDispatchConstrainerEnablerQueryFromInspector
DispatchConstrainerEnablerQuery getDispatchConstrainerEnablerQueryFromInspector(DispatchConstrainerEnablerQueryInspector dispatchConstrainerEnablerQueryInspector) Gets a dispatch constrainer enabler query from an inspector.- Parameters:
dispatchConstrainerEnablerQueryInspector- a dispatch constrainer enabler query inspector- Returns:
- the dispatch constrainer enabler query
- Throws:
NullArgumentException-dispatchConstrainerEnablerQueryInspectorisnullUnsupportedException-dispatchConstrainerEnablerQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-