org.eurogrid.broker.server.gt3
Interface XPathSearcher

All Superinterfaces:

NamedPlugin

All Known Implementing Classes:

IndexServiceSearcher

public interface XPathSearcher

extends NamedPlugin

Encapsulation of what it means to perform an XPath search.

Version:

$Revision: 1.2 $

Author:

Donal K. Fellows

See Also:

GT3LocalResourceChecker

Method Summary

Element[]

search(String xpath, String[] namespaceMap, List log) Search for elements matching the given XPath expression.

Methods inherited from interface org.eurogrid.broker.server.NamedPlugin

getFormalName, getName

Method Detail

search

public Element[] search(String xpath,
                        String[] namespaceMap,
                        List log)
                 throws Exception

Search for elements matching the given XPath expression.

Parameters:

xpath - The XPath search term.

namespaceMap - Mapping of namespace abbreviations to namespace URIs. Each item in the list should be formatted as an xmlns:...=... pseudo-attribute, except that quotation marks are not needed.

log - List (of strings) that log messages will be added to.

Returns:

Array of elements that are matched by the XPath search term.

Throws:

Exception - There is no constraint on what may fail; it depends purely on the implementation of the interface.