org.osid.hold

Interface BlockSearch

All Superinterfaces:

Extensible, OsidCondition, OsidSearch, Suppliable

public interface BlockSearch
extends OsidSearch

The search interface for governing block searches.

Method Summary

Methods

Modifier and Type	Method and Description
BlockSearchRecord	getBlockSearchRecord(Type blockSearchRecordType) Gets the block search record corresponding to the given block search record Type.
void	orderBlockResults(BlockSearchOrder blockSearchOrder) Specify an ordering to the search results.
void	searchAmongBlocks(IdList blockIds) Execute this search among the given list of blocks.

Methods inherited from interface org.osid.OsidSearch

limitResultSet

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Method Detail

searchAmongBlocks

void searchAmongBlocks(IdList blockIds)

Execute this search among the given list of blocks.

Parameters:

blockIds - list of blocks

Throws:

NullArgumentException - blockIds is null

Compliance:

mandatory - This method must be implemented.

orderBlockResults

void orderBlockResults(BlockSearchOrder blockSearchOrder)

Specify an ordering to the search results.

Parameters:

blockSearchOrder - block search order

Throws:

NullArgumentException - blockSearchOrder is null

UnsupportedException - blockSearchOrder is not of this service

Compliance:

mandatory - This method must be implemented.

getBlockSearchRecord

BlockSearchRecord getBlockSearchRecord(Type blockSearchRecordType)
                                       throws OperationFailedException,
                                              PermissionDeniedException

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

Parameters:

blockSearchRecordType - a block search record type

Returns:

the block search record

Throws:

NullArgumentException - blockSearchRecordType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

UnsupportedException - hasRecordType(blockSearchRecordType) is false

Compliance:

mandatory - This method must be implemented.