org.osid.search

Interface EngineSearchSession

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, EngineQuerySession, OsidSession

public interface EngineSearchSession
extends EngineQuerySession

This session provides methods for searching Engine objects. The search query is constructed using the EngineQuery. The engine record Type also specifies the record for the engine query.

getEnginesByQuery() is the basic search method and returns a list of Engine elements. A more advanced search may be performed with getEnginesBySearch(). It accepts an EngineSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getEnginesBySearch() returns an EngineSearchResults that can be used to access the resulting EngineList or be used to perform a search within the result set through EngineSearch.

Engines may have a query record indicated by their respective record types. The query record is accessed via the EngineQuery. The returns in this session may not be cast directly to these interfaces.

Method Summary

Methods

Modifier and Type	Method and Description
EngineQuery	getEngineQueryFromInspector(EngineQueryInspector engineQueryInspector) Gets an engine query from an inspector.
EngineSearchResults	getEnginesBySearch(EngineQuery engineQuery, EngineSearch engineSearch) Gets the search results matching the given search.
EngineSearch	getEngineSearch() Gets an engine search.
EngineSearchOrder	getEngineSearchOrder() Gets an engine search order.

Methods inherited from interface org.osid.search.EngineQuerySession

canSearchEngines, getEngineQuery, getEnginesByQuery

Methods inherited from interface org.osid.OsidSession

getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions

Methods inherited from interface org.osid.binding.java.OsidSession

close

Methods inherited from interface java.io.Closeable

close

Method Detail

getEngineSearch

EngineSearch getEngineSearch()

Gets an engine search.

Returns:

the engine search

Compliance:

mandatory - This method must be implemented.

getEngineSearchOrder

EngineSearchOrder getEngineSearchOrder()

Gets an engine search order. The EngineSearchOrder is supplied to an EngineSearch to specify the ordering of results.

Returns:

the engine search order

Compliance:

mandatory - This method must be implemented.

getEnginesBySearch

EngineSearchResults getEnginesBySearch(EngineQuery engineQuery,
                                     EngineSearch engineSearch)
                                       throws OperationFailedException,
                                              PermissionDeniedException

Gets the search results matching the given search.

Parameters:

engineQuery - the engine query

engineSearch - the engine search

Returns:

the search results

Throws:

NullArgumentException - engineQuery or engineSearch is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

UnsupportedException - engineQuery or engineSearch is not of this service

Compliance:

mandatory - This method must be implemented.

getEngineQueryFromInspector

EngineQuery getEngineQueryFromInspector(EngineQueryInspector engineQueryInspector)

Gets an engine query from an inspector. The inspector is available from an EngineSearchResults.

Parameters:

engineQueryInspector - a query inspector

Returns:

the engine query

Throws:

NullArgumentException - engineQueryInspector is null

UnsupportedException - engineQueryInspector is not of this service

Compliance:

mandatory - This method must be implemented.