org.osid.offering

Interface ResultSearch

All Superinterfaces:

Extensible, OsidCondition, OsidSearch, Suppliable

public interface ResultSearch
extends OsidSearch

The search interface for governing result searches.

Method Summary

Methods

Modifier and Type	Method and Description
ResultSearchRecord	getResultSearchRecord(Type resultSearchRecordType) Gets the record corresponding to the given result search record Type.
void	orderResultResults(ResultSearchOrder resultSearchOrder) Specify an ordering to the search results.
void	searchAmongResults(IdList resultIds) Execute this search among the given list of results.

Methods inherited from interface org.osid.OsidSearch

limitResultSet

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Method Detail

searchAmongResults

void searchAmongResults(IdList resultIds)

Execute this search among the given list of results.

Parameters:

resultIds - list of results

Throws:

NullArgumentException - resultIds is null

Compliance:

mandatory - This method must be implemented.

orderResultResults

void orderResultResults(ResultSearchOrder resultSearchOrder)

Specify an ordering to the search results.

Parameters:

resultSearchOrder - result search order

Throws:

NullArgumentException - resultSearchOrder is null

UnsupportedException - resultSearchOrder is not of this service

Compliance:

mandatory - This method must be implemented.

getResultSearchRecord

ResultSearchRecord getResultSearchRecord(Type resultSearchRecordType)
                                         throws OperationFailedException

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

Parameters:

resultSearchRecordType - an result search record type

Returns:

the result search record

Throws:

NullArgumentException - resultSearchRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(resultSearchRecordType) is false

Compliance:

mandatory - This method must be implemented.