public interface BlockSmartOublietteSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A BlockQuery
can be retrieved from this session
and mapped to this Oubliette
to create a virtual collection
of Blocks.
The blocks may be sequenced using the
BlockSearchOrder
from this session.
This Oubliette
has a default query that matches any
block and a default search order that specifies no sequencing. The queries
may be examined using a BlockQueryInspector.
The query may
be modified by converting the inspector back to a BlockQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyBlockQuery(BlockQuery blockQuery)
Applies a block query to this oubliette.
|
void |
applyBlockSequencing(BlockSearchOrder blockSearchOrder)
Applies a block search order to this oubliette.
|
boolean |
canManageSmartOubliettes()
Tests if this user can manage smart oubliettes.
|
BlockQuery |
getBlockQuery()
Gets a block query.
|
BlockQuery |
getBlockQueryFromInspector(BlockQueryInspector blockQueryInspector)
Gets a block query from an inspector.
|
BlockSearchOrder |
getBlockSearchOrder()
Gets a block search order.
|
Oubliette |
getOubliette()
Gets the
Oubliette associated with this session. |
Id |
getOublietteId()
Gets the
Oubliette Id associated with
this session. |
BlockQueryInspector |
inspectBlockQuery()
Gets a block query inspector for this oubliette.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getOublietteId()
Oubliette
Id
associated with
this session. Oubliette Id
associated with this sessionmandatory
- This method must be implemented. Oubliette getOubliette() throws OperationFailedException, PermissionDeniedException
Oubliette
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartOubliettes()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart oubliette management is not
authorized, true
otherwisemandatory
- This method must be implemented. BlockQuery getBlockQuery()
mandatory
- This method must be implemented. BlockSearchOrder getBlockSearchOrder()
mandatory
- This method must be implemented. void applyBlockQuery(BlockQuery blockQuery) throws OperationFailedException, PermissionDeniedException
blockQuery
- the block queryNullArgumentException
- blockQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- blockQuery
not of
this servicemandatory
- This method must be implemented. BlockQueryInspector inspectBlockQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyBlockSequencing(BlockSearchOrder blockSearchOrder) throws OperationFailedException, PermissionDeniedException
blockSearchOrder
- the block search orderNullArgumentException
- blockSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- blockSearchOrder
not of this servicemandatory
- This method must be implemented. BlockQuery getBlockQueryFromInspector(BlockQueryInspector blockQueryInspector)
blockQueryInspector
- a block query inspectorNullArgumentException
- blockQueryInspector
is null
UnsupportedException
- blockQueryInspector
is not of this servicemandatory
- This method must be implemented.