org.springframework.xml.xpath
Interface XPathOperations

All Known Implementing Classes:

AbstractXPathTemplate, JaxenXPathTemplate, Jaxp13XPathTemplate

public interface XPathOperations

Interface that specifies a basic set of XPath operations, implemented by various XPathTemplates. Contains numerous evaluation methods,

The templates that implement this interface do not use precompiled XPath expressions. Consider using the XPathExpressionFactory or the XPathExpressionFactoryBean for optimal performance, but less flexibility.

Since:

1.0.0

Author:

Arjen Poutsma

See Also:

Jaxp13XPathTemplate, JaxenXPathTemplate

Method Summary

void	evaluate(java.lang.String expression, javax.xml.transform.Source context, NodeCallbackHandler callbackHandler) Evaluates the given expression, handling the result Node objects on a per-node basis with a NodeCallbackHandler.
java.util.List	evaluate(java.lang.String expression, javax.xml.transform.Source context, NodeMapper nodeMapper) Evaluates the given expression, mapping each result Node objects to a Java object via a NodeMapper.
boolean	evaluateAsBoolean(java.lang.String expression, javax.xml.transform.Source context) Evaluates the given expression as a boolean.
double	evaluateAsDouble(java.lang.String expression, javax.xml.transform.Source context) Evaluates the given expression as a double.
org.w3c.dom.Node	evaluateAsNode(java.lang.String expression, javax.xml.transform.Source context) Evaluates the given expression as a Node.
java.util.List	evaluateAsNodeList(java.lang.String expression, javax.xml.transform.Source context) Evaluates the given expression as a list of Node objects.
java.lang.Object	evaluateAsObject(java.lang.String expression, javax.xml.transform.Source context, NodeMapper nodeMapper) Evaluates the given expression, mapping a single Node result to a Java object via a NodeMapper.
java.lang.String	evaluateAsString(java.lang.String expression, javax.xml.transform.Source context) Evaluates the given expression as a String.

Method Detail

evaluateAsBoolean

boolean evaluateAsBoolean(java.lang.String expression,
                          javax.xml.transform.Source context)
                          throws XPathException

Evaluates the given expression as a boolean. Returns the boolean evaluation of the expression, or false if it is invalid.

Parameters:

expression - the XPath expression

context - the context starting point

Returns:

the result of the evaluation

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluateAsNode

org.w3c.dom.Node evaluateAsNode(java.lang.String expression,
                                javax.xml.transform.Source context)
                                throws XPathException

Evaluates the given expression as a Node. Returns the evaluation of the expression, or null if it is invalid.

Parameters:

expression - the XPath expression

context - the context starting point

Returns:

the result of the evaluation

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluateAsNodeList

java.util.List evaluateAsNodeList(java.lang.String expression,
                                  javax.xml.transform.Source context)
                                  throws XPathException

Evaluates the given expression as a list of Node objects. Returns the evaluation of the expression, or an empty list if no results are found.

Parameters:

expression - the XPath expression

context - the context starting point

Returns:

the result of the evaluation

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluateAsDouble

double evaluateAsDouble(java.lang.String expression,
                        javax.xml.transform.Source context)
                        throws XPathException

Evaluates the given expression as a double. Returns the evaluation of the expression, or Double.NaN if it is invalid.

Parameters:

expression - the XPath expression

context - the context starting point

Returns:

the result of the evaluation

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluateAsString

java.lang.String evaluateAsString(java.lang.String expression,
                                  javax.xml.transform.Source context)
                                  throws XPathException

Evaluates the given expression as a String. Returns the evaluation of the expression, or null if it is invalid.

Parameters:

expression - the XPath expression

context - the context starting point

Returns:

the result of the evaluation

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluateAsObject

java.lang.Object evaluateAsObject(java.lang.String expression,
                                  javax.xml.transform.Source context,
                                  NodeMapper nodeMapper)
                                  throws XPathException

Evaluates the given expression, mapping a single Node result to a Java object via a NodeMapper.

Parameters:

expression - the XPath expression

context - the context starting point

nodeMapper - object that will map one object per node

Returns:

the single mapped object

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluate

java.util.List evaluate(java.lang.String expression,
                        javax.xml.transform.Source context,
                        NodeMapper nodeMapper)
                        throws XPathException

Evaluates the given expression, mapping each result Node objects to a Java object via a NodeMapper.

Parameters:

expression - the XPath expression

context - the context starting point

nodeMapper - object that will map one object per node

Returns:

the result list, containing mapped objects

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification

evaluate

void evaluate(java.lang.String expression,
              javax.xml.transform.Source context,
              NodeCallbackHandler callbackHandler)
              throws XPathException

Evaluates the given expression, handling the result Node objects on a per-node basis with a NodeCallbackHandler.

Parameters:

expression - the XPath expression

context - the context starting point

callbackHandler - object that will extract results, one row at a time

Throws:

XPathException - in case of XPath errors

See Also:

XPath specification