org.osid.recognition

Interface ConvocationSearch

All Superinterfaces:

Extensible, OsidCondition, OsidSearch, Suppliable

public interface ConvocationSearch
extends OsidSearch

The search interface for governing convocation searches.

Method Summary

Methods

Modifier and Type	Method and Description
ConvocationSearchRecord	getConvocationSearchRecord(Type convocationSearchRecordType) Gets the convocation search record corresponding to the given convocation search record Type.
void	orderConvocationResults(ConvocationSearchOrder convocationSearchOrder) Specify an ordering to the search results.
void	searchAmongConvocations(IdList convocationIds) Execute this search among the given list of convocations.

Methods inherited from interface org.osid.OsidSearch

limitResultSet

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Method Detail

searchAmongConvocations

void searchAmongConvocations(IdList convocationIds)

Execute this search among the given list of convocations.

Parameters:

convocationIds - list of convocations

Throws:

NullArgumentException - convocationIds is null

Compliance:

mandatory - This method must be implemented.

orderConvocationResults

void orderConvocationResults(ConvocationSearchOrder convocationSearchOrder)

Specify an ordering to the search results.

Parameters:

convocationSearchOrder - convocation search order

Throws:

NullArgumentException - convocationSearchOrder is null

UnsupportedException - convocationSearchOrder is not of this service

Compliance:

mandatory - This method must be implemented.

getConvocationSearchRecord

ConvocationSearchRecord getConvocationSearchRecord(Type convocationSearchRecordType)
                                                   throws OperationFailedException

Gets the convocation search record corresponding to the given convocation search record Type. This method is used to retrieve an object implementing the requested record.

Parameters:

convocationSearchRecordType - a convocation search record type

Returns:

the convocation search record

Throws:

NullArgumentException - convocationSearchRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(convocationSearchRecordType) is false

Compliance:

mandatory - This method must be implemented.