public interface SceneSmartSystemSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A SceneQuery
can be retrieved from this session
and systemped to this System
to create a virtual collection
of Scenes.
The scenes may be sequenced using the
SceneSearchOrder
from this session.
This System
has a default query that matches any scene
and a default search order that specifies no sequencing. The queries may
be examined using a SceneQueryInspector.
The query may be
modified by converting the inspector back to a SceneQuery.
Modifier and Type | Method and Description |
---|---|
void |
applySceneQuery(SceneQuery sceneQuery)
Applies a scene query to this system.
|
void |
applySceneSequencing(SceneSearchOrder sceneSearchOrder)
Applies a scene search order to this system.
|
boolean |
canManageSmartSystems()
Tests if this user can manage smart systems.
|
SceneQuery |
getSceneQuery()
Gets a scene query.
|
SceneQuery |
getSceneQueryFromInspector(SceneQueryInspector sceneQueryInspector)
Gets a scene query from an inspector.
|
SceneSearchOrder |
getSceneSearchOrder()
Gets a scene search order.
|
System |
getSystem()
Gets the
System associated with this session. |
Id |
getSystemId()
Gets the
System Id associated with this
session. |
SceneQueryInspector |
inspectSceneQuery()
Gets a scene query inspector for this system.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getSystemId()
System
Id
associated with this
session. System Id
associated with this sessionmandatory
- This method must be implemented. System getSystem() throws OperationFailedException, PermissionDeniedException
System
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartSystems()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart system management is not
authorized, true
otherwisemandatory
- This method must be implemented. SceneQuery getSceneQuery()
mandatory
- This method must be implemented. SceneSearchOrder getSceneSearchOrder()
mandatory
- This method must be implemented. void applySceneQuery(SceneQuery sceneQuery) throws OperationFailedException, PermissionDeniedException
sceneQuery
- the scene queryNullArgumentException
- sceneQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- sceneQuery
not of
this servicemandatory
- This method must be implemented. SceneQueryInspector inspectSceneQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applySceneSequencing(SceneSearchOrder sceneSearchOrder) throws OperationFailedException, PermissionDeniedException
sceneSearchOrder
- the scene search orderNullArgumentException
- sceneSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- sceneSearchOrder
not of this servicemandatory
- This method must be implemented. SceneQuery getSceneQueryFromInspector(SceneQueryInspector sceneQueryInspector)
sceneQueryInspector
- a scene query inspectorNullArgumentException
- sceneQueryInspector
is null
UnsupportedException
- sceneQueryInspector
is not of this servicemandatory
- This method must be implemented.