Interface AssetContentSmartRepositorySession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. An AssetContentQuery can be retrieved from this session
and mapped to this Repository to create a virtual collection of
AssetContents . The asset contents may be sequenced using the
AssetContentSearchOrder from this session.
This Repository has a default query that matches any asset
content and a default search order that specifies no sequencing. The
queries may be examined using an AssetContentQueryInspector . The
query may be modified by converting the inspector back to an
AssetContentQuery .
-
Method Summary
Modifier and TypeMethodDescriptionvoidapplyAssetContentQuery(AssetContentQuery assetContentQuery) Applies an asset content query to this repository.voidapplyAssetContentSequencing(AssetContentSearchOrder assetContentSearchOrder) Applies an asset content search order to this repository.booleanTests if this user can manage smart repositories.Gets an asset content query.getAssetContentQueryFromInspector(AssetContentQueryInspector assetContentQueryInspector) Gets an asset content query from an inspector.Gets an asset content search order.Gets theRepositoryassociated with this session.Gets theRepositoryIdassociated with this session.Gets an asset content query inspector for this repository.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
-
getRepositoryId
Id getRepositoryId()Gets theRepositoryIdassociated with this session.- Returns:
- the
Repository Idassociated with this session - Compliance:
mandatory- This method must be implemented.
-
getRepository
Gets theRepositoryassociated with this session.- Returns:
- the repository
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
canManageSmartRepositories
boolean canManageSmartRepositories()Tests if this user can manage smart repositories. 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 repository management is not authorized,trueotherwise- Compliance:
mandatory- This method must be implemented.
-
getAssetContentQuery
AssetContentQuery getAssetContentQuery()Gets an asset content query.- Returns:
- the asset content query
- Compliance:
mandatory- This method must be implemented.
-
getAssetContentSearchOrder
AssetContentSearchOrder getAssetContentSearchOrder()Gets an asset content search order.- Returns:
- the asset content search order
- Compliance:
mandatory- This method must be implemented.
-
applyAssetContentQuery
void applyAssetContentQuery(AssetContentQuery assetContentQuery) throws OperationFailedException, PermissionDeniedException Applies an asset content query to this repository.- Parameters:
assetContentQuery- the asset content query- Throws:
NullArgumentException-assetContentQueryisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurredUnsupportedException-assetContentQuerynot of this service- Compliance:
mandatory- This method must be implemented.
-
inspectAssetContentQuery
AssetContentQueryInspector inspectAssetContentQuery() throws OperationFailedException, PermissionDeniedExceptionGets an asset content query inspector for this repository.- Returns:
- the asset content query inspector
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurred- Compliance:
mandatory- This method must be implemented.
-
applyAssetContentSequencing
void applyAssetContentSequencing(AssetContentSearchOrder assetContentSearchOrder) throws OperationFailedException, PermissionDeniedException Applies an asset content search order to this repository.- Parameters:
assetContentSearchOrder- the asset content search order- Throws:
NullArgumentException-assetContentSearchOrderisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure occurredUnsupportedException-assetContentSearchOrdernot of this service- Compliance:
mandatory- This method must be implemented.
-
getAssetContentQueryFromInspector
AssetContentQuery getAssetContentQueryFromInspector(AssetContentQueryInspector assetContentQueryInspector) Gets an asset content query from an inspector.- Parameters:
assetContentQueryInspector- an asset content query inspector- Returns:
- the asset content query
- Throws:
NullArgumentException-assetContentQueryInspectorisnullUnsupportedException-assetContentQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-