OSID Logo
OSID Specifications
resource package
Version 3.0.0
Release Candidate Preview
Interfaceosid.resource.ResourceQuery
Implementsosid.OsidObjectQuery
Description

This is the query for searching resources. Each method specifies an AND term while multiple invocations of the same method produce a nested OR.

MethodmatchGroup
Description

Matches resources that are also groups.

Parametersbooleanmatch true for a positive match, false for a negative match
CompliancemandatoryThis method must be implemented.
MethodclearGroupTerms
Description

Clears the group terms.

CompliancemandatoryThis method must be implemented.
MethodmatchDemographic
Description

Matches resources that are also demographics.

Parametersbooleanmatch true for a positive match, false for a negative match
CompliancemandatoryThis method must be implemented.
MethodclearDemographicTerms
Description

Clears the demographic terms.

CompliancemandatoryThis method must be implemented.
MethodmatchContainingGroupId
Description

Sets the group Id for this query to match resources within the given group.

Parametersosid.id.IdresourceIda resource Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT resourceId is null
CompliancemandatoryThis method must be implemented.
MethodclearContainingGroupIdTerms
Description

Clears the group Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsContainingGroupQuery
Description

Tests if a ResourceQuery is available for querying containing groups.

Returnboolean true if a group resource query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetContainingGroupQuery
Description

Gets the query for a a containing group. Multiple retrievals produce a nested OR term.

Returnosid.resource.ResourceQuerythe resource query
ErrorsUNIMPLEMENTED supportsContainingGroupQuery() is false
ComplianceoptionalThis method must be implemented if supportsAgentQuery() is true.
MethodmatchAnyContainingGroup
Description

Matches resources inside any group.

Parametersbooleanmatch true to match any containing group, false to match resources part of no groups
CompliancemandatoryThis method must be implemented.
MethodclearContainingGroupTerms
Description

Clears the containing group terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAvatarId
Description

Sets the asset Id for this query.

Parametersosid.id.IdassetIdthe asset Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT assetId is null
CompliancemandatoryThis method must be implemented.
MethodclearAvatarIdTerms
Description

Clears the asset Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsAvatarQuery
Description

Tests if an AssetQuery is available.

Returnboolean true if an asset query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetAvatarQuery
Description

Gets the query for an asset. Multiple retrievals produce a nested OR term.

Returnosid.repository.AssetQuerythe asset query
ErrorsUNIMPLEMENTED supportsAvatarQuery() is false
ComplianceoptionalThis method must be implemented if supportsAvatarQuery() is true.
MethodmatchAnyAvatar
Description

Matches resources with any asset.

Parametersbooleanmatch true to match any asset, false to match resources with no asset
CompliancemandatoryThis method must be implemented.
MethodclearAvatarTerms
Description

Clears the asset terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAgentId
Description

Sets the agent Id for this query.

Parametersosid.id.IdagentIdthe agent Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT agentId is null
CompliancemandatoryThis method must be implemented.
MethodclearAgentIdTerms
Description

Clears the agent Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsAgentQuery
Description

Tests if an AgentQuery is available.

Returnboolean true if an agent query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetAgentQuery
Description

Gets the query for an agent. Multiple retrievals produce a nested OR term.

Returnosid.authentication.AgentQuerythe agent query
ErrorsUNIMPLEMENTED supportsAgentQuery() is false
ComplianceoptionalThis method must be implemented if supportsAgentQuery() is true.
MethodmatchAnyAgent
Description

Matches resources with any agent.

Parametersbooleanmatch true to match any agent, false to match resources with no agent
CompliancemandatoryThis method must be implemented.
MethodclearAgentTerms
Description

Clears the agent terms.

CompliancemandatoryThis method must be implemented.
MethodmatchResourceRelationshipId
Description

Sets the resource relationship Id for this query.

Parametersosid.id.IdresourceRelationshipIdthe resource relationship Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT resourceRelationshipId is null
CompliancemandatoryThis method must be implemented.
MethodclearResourceRelationshipIdTerms
Description

Clears the resource relationship Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsResourceRelationshipQuery
Description

Tests if a ResourceRelationshipQuery is available.

Returnboolean true if a resource relationship query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetResourceRelationshipQuery
Description

Gets the query for aa resource relationship. Multiple retrievals produce a nested OR term.

Returnosid.resource.ResourceRelationshipQuerythe resource relationship query
ErrorsUNIMPLEMENTED supportsResourceRelationshipQuery() is false
ComplianceoptionalThis method must be implemented if supportsResourceRelationshipQuery() is true.
MethodmatchAnyResourceRelationship
Description

Matches resources with any resource relationship.

Parametersbooleanmatch true to match any resource relationship, false to match resources with no relationship
CompliancemandatoryThis method must be implemented.
MethodclearResourceRelationshipTerms
Description

Clears the resource relationship terms.

CompliancemandatoryThis method must be implemented.
MethodmatchBinId
Description

Sets the bin Id for this query.

Parametersosid.id.IdbinIdthe bin Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT binId is null
CompliancemandatoryThis method must be implemented.
MethodclearBinIdTerms
Description

Clears the bin Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsBinQuery
Description

Tests if a BinQuery is available.

Returnboolean true if a bin query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetBinQuery
Description

Gets the query for a bin. Multiple retrievals produce a nested OR term.

Returnosid.resource.BinQuerythe bin query
ErrorsUNIMPLEMENTED supportsBinQuery() is false
ComplianceoptionalThis method must be implemented if supportsBinQuery() is true.
MethodclearBinTerms
Description

Clears the bin terms.

CompliancemandatoryThis method must be implemented.
MethodgetResourceQueryRecord
Description

Gets the resource query record corresponding to the given Resource record Type. Multiple retrievals produce a nested OR term.

Parametersosid.type.TyperesourceRecordTypea resource record type
Returnosid.resource.records.ResourceQueryRecordthe resource query record
ErrorsNULL_ARGUMENT resourceRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTED hasRecordType(resourceRecordType) is false
CompliancemandatoryThis method must be implemented.