public interface ValueEnablerSmartConfigurationSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
configurations. A ValueEnablerQuery
can be retrieved from
this session and mapped to this Configuration
to create a
virtual collection of value enablers. The value enablers may be sequenced
using the ValueEnablerSearchOrder
from this session.
This Configuration
has a default query that matches any
value enabler and a default search order that specifies no sequencing. The
queries may be examined using a ValueEnablerQueryInspector.
The query may be modified by converting the inspector back to a
ValueEnablerQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyValueEnablerQuery(ValueEnablerQuery valueEnablerQuery)
Applies a value enabler query to this configuration.
|
void |
applyValueEnablerSequencing(ValueEnablerSearchOrder valueEnablerSearchOrder)
Applies a value enabler search order to this configuration.
|
boolean |
canManageSmartConfigurations()
Tests if this user can manage smart configurations.
|
Configuration |
getConfiguration()
Gets the
Configuration associated with this session. |
Id |
getConfigurationId()
Gets the
Configuration Id associated
with this session. |
ValueEnablerQuery |
getValueEnablerQuery()
Gets a value enabler query.
|
ValueEnablerQuery |
getValueEnablerQueryFromInspector(ValueEnablerQueryInspector valueEnablerQueryInspector)
Gets a value enabler query from an inspector.
|
ValueEnablerSearchOrder |
getValueEnablerSearchOrder()
Gets a value enabler search order.
|
ValueEnablerQueryInspector |
inspectValueEnablerQuery()
Gets a value enabler query inspector for this configuration.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getConfigurationId()
Configuration
Id
associated
with this session. Configuration Id
associated with this
sessionmandatory
- This method must be implemented. Configuration getConfiguration() throws OperationFailedException, PermissionDeniedException
Configuration
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartConfigurations()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart configuration management is not
authorized, true
otherwisemandatory
- This method must be implemented. ValueEnablerQuery getValueEnablerQuery()
mandatory
- This method must be implemented. ValueEnablerSearchOrder getValueEnablerSearchOrder()
mandatory
- This method must be implemented. void applyValueEnablerQuery(ValueEnablerQuery valueEnablerQuery) throws OperationFailedException, PermissionDeniedException
valueEnablerQuery
- the value enabler queryNullArgumentException
- valueEnablerQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- valueEnablerQuery
not of this servicemandatory
- This method must be implemented. ValueEnablerQueryInspector inspectValueEnablerQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyValueEnablerSequencing(ValueEnablerSearchOrder valueEnablerSearchOrder) throws OperationFailedException, PermissionDeniedException
valueEnablerSearchOrder
- the value enabler search orderNullArgumentException
- valueEnablerSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- valueEnablerSearchOrder
not of this servicemandatory
- This method must be implemented. ValueEnablerQuery getValueEnablerQueryFromInspector(ValueEnablerQueryInspector valueEnablerQueryInspector)
valueEnablerQueryInspector
- a value enabler query inspectorNullArgumentException
-
valueEnablerQueryInspector
is null
UnsupportedException
-
valueEnablerQueryInspector
is not of this servicemandatory
- This method must be implemented.