org.osid.workflow.rules

Interface StepProcessorSearchSession

All Superinterfaces:

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

public interface StepProcessorSearchSession
extends StepProcessorQuerySession

This session provides methods for searching among StepProcessor objects. The search query is constructed using the StepProcessoryQuery.

getStepProcessorsByQuery() is the basic search method and returns a list of StepProcessors. A more advanced search may be performed with getStepProcessorsBySearch(). It accepts a StepProcessorSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as workflow. getStepProcessorsBySearch() returns a StepProcessorSearchResults that can be used to access the resulting StepProcessorList or be used to perform a search within the result set through StepProcessorSearch.

This session defines views that offer differing behaviors for searching.

• federated office view: searches include step processor in office of which this office is an ancestor in the office hierarchy
• isolated office view: searches are restricted to step processor in this office

StepProcessors may have a query record indicated by their respective record types. Thequery record is accessed via the StepProcessorQuery.

Method Summary

Methods

Modifier and Type	Method and Description
StepProcessorQuery	getStepProcessorQueryFromInspector(StepProcessorQueryInspector stepProcessorQueryInspector) Gets a step processor query from an inspector.
StepProcessorSearchResults	getStepProcessorsBySearch(StepProcessorQuery stepProcessorQuery, StepProcessorSearch stepProcessorSearch) Gets the search results matching the given search query using the given search.
StepProcessorSearch	getStepProcessorSearch() Gets a step processor search.
StepProcessorSearchOrder	getStepProcessorSearchOrder() Gets a step processor search order.

Methods inherited from interface org.osid.workflow.rules.StepProcessorQuerySession

canSearchStepProcessors, getOffice, getOfficeId, getStepProcessorQuery, getStepProcessorsByQuery, useFederatedOfficeView, useIsolatedOfficeView

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

getStepProcessorSearch

StepProcessorSearch getStepProcessorSearch()

Gets a step processor search.

Returns:

the step processor search

Compliance:

mandatory - This method must be implemented.

getStepProcessorSearchOrder

StepProcessorSearchOrder getStepProcessorSearchOrder()

Gets a step processor search order. The StepProcessorSearchOrder is supplied to a StepProcessorSearch to specify the ordering of results.

Returns:

the step processor search order

Compliance:

mandatory - This method must be implemented.

getStepProcessorsBySearch

StepProcessorSearchResults getStepProcessorsBySearch(StepProcessorQuery stepProcessorQuery,
                                                   StepProcessorSearch stepProcessorSearch)
                                                     throws OperationFailedException,
                                                            PermissionDeniedException

Gets the search results matching the given search query using the given search.

Parameters:

stepProcessorQuery - the step processor query

stepProcessorSearch - the step processor search

Returns:

the returned search results

Throws:

NullArgumentException - stepProcessorQuery or stepProcessorSearch is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

UnsupportedException - stepProcessorQuery or stepProcessorSearch is not of this service

Compliance:

mandatory - This method must be implemented.

getStepProcessorQueryFromInspector

StepProcessorQuery getStepProcessorQueryFromInspector(StepProcessorQueryInspector stepProcessorQueryInspector)

Gets a step processor query from an inspector. The inspector is available from a StepProcessorSearchResults.

Parameters:

stepProcessorQueryInspector - a step processor query inspector

Returns:

the step processor query

Throws:

NullArgumentException - stepProcessorQueryInspector is null

UnsupportedException - stepProcessorQueryInspector is not of this service

Compliance:

mandatory - This method must be implemented.