OSID Logo
OSID Specifications
resource package
Version 3.0.0
Release Candidate Preview
Interfaceosid.resource.ResourceSmartBinSession
Implementsosid.OsidSession
Description

This session manages queries and sequencing to create "smart" dynamic catalogs. A ResourceQuery can be retrieved from this session and mapped to this Bin to create a virtual collection of Resources. The resources may be sequenced using the ResourceSearchOrder from this session.

This Bin has a default query that matches any resource and a default search order that specifies no sequencing. The queries may be examined using a ResourceQueryInspector. The query may be modified by converting the inspector back to a ResourceQuery.

MethodgetBinId
Description

Gets the Bin Id associated with this session.

Returnosid.id.Idthe Bin Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetBin
Description

Gets the Bin associated with this session.

Returnosid.resource.Binthe Bin associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanManageSmartBins
Description

Tests if this user can manage smart bins. 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 a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer operations to unauthorized users.

Returnboolean false if smart bin management is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodgetResourceQuery
Description

Gets a resource query.

Returnosid.resource.ResourceQuerythe resource query
CompliancemandatoryThis method must be implemented.
MethodgetResourceSearchOrder
Description

Gets a resource search order.

Returnosid.resource.ResourceSearchOrderthe resource search order
CompliancemandatoryThis method must be implemented.
MethodapplyResourceQuery
Description

Applies a resource query to this bin.

Parametersosid.resource.ResourceQueryresourceQuerythe resource query
ErrorsNULL_ARGUMENT resourceQuery is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED resourceQuery not of this service
CompliancemandatoryThis method must be implemented.
MethodinspectResourceQuery
Description

Gets a resource query inspector for this bin.

Returnosid.resource.ResourceQueryInspectorthe resource query inspector
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodapplyResourceSequencing
Description

Applies a resource search order to this bin.

Parametersosid.resource.ResourceSearchOrderresourceSearchOrderthe resource search order
ErrorsNULL_ARGUMENT resourceSearchOrder is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED resourceSearchOrder not of this service
CompliancemandatoryThis method must be implemented.
MethodgetResourceQueryFromInspector
Description

Gets a resource query from an inspector.

Parametersosid.resource.ResourceQueryInspectorresourceQueryInspectora resource query inspector
Returnosid.resource.ResourceQuerythe resource query
ErrorsNULL_ARGUMENT resourceQueryInspector is null
UNSUPPORTED resourceQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.