org.eclipse.smila.search.api

Interface SearchService

All Known Implementing Classes:

SearchServiceImpl

public interface SearchService

Interface of SMILA search services. A search service takes processes a search based on an input query object and creates the search result Record object. There are two alternatives for processing a search: Methods having a 'workflow' parameter use a BPEL workflow for processing the search. Methods having a 'script' parameter (search...WithScript) use the Scripting engine for processing the search. For the structure of the query record see the Search API specification page in the Eclipse Wiki: http://wiki.eclipse.org/SMILA/Specifications/Search_API.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAMESPACE_SEARCH namespace of search specific elements in XML result.
static java.lang.String	TAG_DETAILS local name of XML result's error details element.
static java.lang.String	TAG_ERROR local name of XML result's error root element.
static java.lang.String	TAG_MESSAGE local name of XML result's error message element.
static java.lang.String	TAG_SCRIPT_NAME local name of XML result's element containing the script name.
static java.lang.String	TAG_SEARCHRESULT local name of XML result's root element.
static java.lang.String	TAG_WORKFLOWNAME local name of XML result's element containing the pipeline name.

Method Summary

Methods

Modifier and Type	Method and Description
Record	search(java.lang.String workflowName, Record query) Execute a query using the named workflow and create a SearchResult from the workflow result.
org.w3c.dom.Document	searchAsXml(java.lang.String workflowName, Record query) Execute a query using the named workflow and return the search result as an XML document.
java.lang.String	searchAsXmlString(java.lang.String workflowName, Record query) Execute a query using the named workflow and return the search result as an XML string.
java.lang.String	searchAsXmlStringWithScript(java.lang.String script, Record query) Execute a query using the named script and return the search result as an XML string.
org.w3c.dom.Document	searchAsXmlWithScript(java.lang.String script, Record query) Execute a query using the named script and return the search result as an XML document.
Record	searchWithScript(java.lang.String script, Record query) Execute a query using the named script and create a SearchResult from the script result.

Field Detail

NAMESPACE_SEARCH

static final java.lang.String NAMESPACE_SEARCH

namespace of search specific elements in XML result.

See Also:

Constant Field Values

TAG_SEARCHRESULT

static final java.lang.String TAG_SEARCHRESULT

local name of XML result's root element.

See Also:

Constant Field Values

TAG_WORKFLOWNAME

static final java.lang.String TAG_WORKFLOWNAME

local name of XML result's element containing the pipeline name.

See Also:

Constant Field Values

TAG_SCRIPT_NAME

static final java.lang.String TAG_SCRIPT_NAME

local name of XML result's element containing the script name.

See Also:

Constant Field Values

TAG_ERROR

static final java.lang.String TAG_ERROR

local name of XML result's error root element.

See Also:

Constant Field Values

TAG_MESSAGE

static final java.lang.String TAG_MESSAGE

local name of XML result's error message element.

See Also:

Constant Field Values

TAG_DETAILS

static final java.lang.String TAG_DETAILS

local name of XML result's error details element.

See Also:

Constant Field Values

Method Detail

search

Record search(java.lang.String workflowName,
            Record query)
              throws ProcessingException

Execute a query using the named workflow and create a SearchResult from the workflow result.

Parameters:

workflowName - name of workflow to process the search.

query - query object describing the search.

Returns:

search result record

Throws:

ProcessingException - error while processing the request or preparing the input message or search result.

searchAsXml

org.w3c.dom.Document searchAsXml(java.lang.String workflowName,
                               Record query)
                                 throws javax.xml.parsers.ParserConfigurationException

Execute a query using the named workflow and return the search result as an XML document.

Parameters:

workflowName - name of workflow to process the search.

query - query object describing the search.

Returns:

search result as DOM document, or description of ProcessingException

Throws:

javax.xml.parsers.ParserConfigurationException - error creating the XML result.

searchAsXmlString

java.lang.String searchAsXmlString(java.lang.String workflowName,
                                 Record query)
                                   throws javax.xml.parsers.ParserConfigurationException

Execute a query using the named workflow and return the search result as an XML string.

Parameters:

workflowName - name of workflow to process the search.

query - query object describing the search.

Returns:

search result as XML string, or description of ProcessingException

Throws:

javax.xml.parsers.ParserConfigurationException - error creating the XML result.

searchWithScript

Record searchWithScript(java.lang.String script,
                      Record query)
                        throws ProcessingException

Execute a query using the named script and create a SearchResult from the script result.

Parameters:

script - name of the script function to process the search (e.g. search.process)

query - query object describing the search.

Returns:

search result record

Throws:

ProcessingException - error while processing the request or preparing the input message or search result.

searchAsXmlWithScript

org.w3c.dom.Document searchAsXmlWithScript(java.lang.String script,
                                         Record query)
                                           throws javax.xml.parsers.ParserConfigurationException

Execute a query using the named script and return the search result as an XML document.

Parameters:

script - name of the script function to process the search (e.g. search.process)

query - query object describing the search.

Returns:

search result as DOM document, or description of ProcessingException

Throws:

javax.xml.parsers.ParserConfigurationException - error creating the XML result.

searchAsXmlStringWithScript

java.lang.String searchAsXmlStringWithScript(java.lang.String script,
                                           Record query)
                                             throws javax.xml.parsers.ParserConfigurationException

Execute a query using the named script and return the search result as an XML string.

Parameters:

script - name of the script function to process the search (e.g. search.process)

query - query object describing the search.

Returns:

search result as XML string, or description of ProcessingException

Throws:

javax.xml.parsers.ParserConfigurationException - error creating the XML result.