org.osid.recipe

Interface DirectionSearch

All Superinterfaces:

Extensible, OsidCondition, OsidSearch, Suppliable

public interface DirectionSearch
extends OsidSearch

The search interface for governing direction searches.

Method Summary

Methods

Modifier and Type	Method and Description
DirectionSearchRecord	getDirectionSearchRecord(Type directionSearchRecordType) Gets the direction search record corresponding to the given direction search record Type.
void	orderDirectionResults(DirectionSearchOrder directionSearchOrder) Specify an ordering to the search results.
void	searchAmongDirections(IdList directionIds) Execute this search among the given list of directions.

Methods inherited from interface org.osid.OsidSearch

limitResultSet

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Method Detail

searchAmongDirections

void searchAmongDirections(IdList directionIds)

Execute this search among the given list of directions.

Parameters:

directionIds - list of directions

Throws:

NullArgumentException - directionIds is null

Compliance:

mandatory - This method must be implemented.

orderDirectionResults

void orderDirectionResults(DirectionSearchOrder directionSearchOrder)

Specify an ordering to the search results.

Parameters:

directionSearchOrder - direction search order

Throws:

NullArgumentException - directionSearchOrder is null

UnsupportedException - directionSearchOrder is not of this service

Compliance:

mandatory - This method must be implemented.

getDirectionSearchRecord

DirectionSearchRecord getDirectionSearchRecord(Type directionSearchRecordType)
                                               throws OperationFailedException,
                                                      PermissionDeniedException

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

Parameters:

directionSearchRecordType - a direction search record type

Returns:

the direction search record

Throws:

NullArgumentException - directionSearchRecordType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

UnsupportedException - hasRecordType(directionSearchRecordType) is false

Compliance:

mandatory - This method must be implemented.