org.osid.calendaring

Interface EventSearch

All Superinterfaces:

Extensible, OsidCondition, OsidSearch, Suppliable

public interface EventSearch
extends OsidSearch

EventSearch defines the interface for specifying event search options.

Method Summary

Methods

Modifier and Type	Method and Description
EventSearchRecord	getEventSearchRecord(Type eventSearchRecordType) Gets the event search record corresponding to the given event search record Type.
void	orderEventResults(EventSearchOrder eventSearchOrder) Specify an ordering to the search results.
void	searchAmongEvents(IdList eventIds) Execute this search among the given list of events.

Methods inherited from interface org.osid.OsidSearch

limitResultSet

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Method Detail

searchAmongEvents

void searchAmongEvents(IdList eventIds)

Execute this search among the given list of events.

Parameters:

eventIds - list of events

Throws:

NullArgumentException - eventIds is null

Compliance:

mandatory - This method must be implemented.

orderEventResults

void orderEventResults(EventSearchOrder eventSearchOrder)

Specify an ordering to the search results.

Parameters:

eventSearchOrder - event search order

Throws:

NullArgumentException - eventSearchOrder is null

UnsupportedException - eventSearchOrder is not of this service

Compliance:

mandatory - This method must be implemented.

getEventSearchRecord

EventSearchRecord getEventSearchRecord(Type eventSearchRecordType)
                                       throws OperationFailedException

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

Parameters:

eventSearchRecordType - an event search record type

Returns:

the event search record

Throws:

NullArgumentException - eventSearchRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(eventSearchRecordType) is false

Compliance:

mandatory - This method must be implemented.