org.springframework.test.util

Class XpathExpectationsHelper

java.lang.Object

org.springframework.test.util.XpathExpectationsHelper

public class XpathExpectationsHelper
extends java.lang.Object

A helper class for applying assertions via XPath expressions.

Since:

3.2

Author:

Rossen Stoyanchev

Constructor Summary

Constructors

Constructor and Description
XpathExpectationsHelper(java.lang.String expression, java.util.Map<java.lang.String,java.lang.String> namespaces, java.lang.Object... args) XpathExpectationsHelper constructor.

Method Summary

Modifier and Type	Method and Description
void	assertBoolean(byte[] content, java.lang.String encoding, boolean expectedValue) Apply the XPath expression and assert the resulting content as a Boolean.
void	assertNode(byte[] content, java.lang.String encoding, Matcher<? super org.w3c.dom.Node> matcher) Parse the content, evaluate the XPath expression as a Node, and assert it with the given Matcher<Node>.
void	assertNodeCount(byte[] content, java.lang.String encoding, int expectedCount) Apply the XPath expression and assert the resulting content as an integer.
void	assertNodeCount(byte[] content, java.lang.String encoding, Matcher<java.lang.Integer> matcher) Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.
void	assertNumber(byte[] content, java.lang.String encoding, java.lang.Double expectedValue) Apply the XPath expression and assert the resulting content as a Double.
void	assertNumber(byte[] content, java.lang.String encoding, Matcher<? super java.lang.Double> matcher) Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.
void	assertString(byte[] content, java.lang.String encoding, Matcher<? super java.lang.String> matcher) Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.
void	assertString(byte[] content, java.lang.String encoding, java.lang.String expectedValue) Apply the XPath expression and assert the resulting content as a String.
void	doesNotExist(byte[] content, java.lang.String encoding) Apply the XPath expression and assert the resulting content does not exist.
<T> T	evaluateXpath(byte[] content, java.lang.String encoding, java.lang.Class<T> targetClass) Evaluate the XPath and return the resulting value.
protected <T> T	evaluateXpath(org.w3c.dom.Document document, QName evaluationType, java.lang.Class<T> expectedClass) Apply the XPath expression to given document.
void	exists(byte[] content, java.lang.String encoding) Apply the XPath expression and assert the resulting content exists.
protected javax.xml.xpath.XPathExpression	getXpathExpression() Return the compiled XPath expression.
protected org.w3c.dom.Document	parseXmlByteArray(byte[] xml, java.lang.String encoding) Parse the given XML content to a Document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XpathExpectationsHelper

public XpathExpectationsHelper(java.lang.String expression,
                               @Nullable
                               java.util.Map<java.lang.String,java.lang.String> namespaces,
                               java.lang.Object... args)
                        throws javax.xml.xpath.XPathExpressionException

XpathExpectationsHelper constructor.

Parameters:

expression - the XPath expression

namespaces - the XML namespaces referenced in the XPath expression, or null

args - arguments to parameterize the XPath expression with using the formatting specifiers defined in String.format(String, Object...)

Throws:

javax.xml.xpath.XPathExpressionException - if expression compilation failed

Method Detail

getXpathExpression

protected javax.xml.xpath.XPathExpression getXpathExpression()

Return the compiled XPath expression.

assertNode

public void assertNode(byte[] content,
                       @Nullable
                       java.lang.String encoding,
                       Matcher<? super org.w3c.dom.Node> matcher)
                throws java.lang.Exception

Parse the content, evaluate the XPath expression as a Node, and assert it with the given Matcher<Node>.

Throws:

java.lang.Exception

exists

public void exists(byte[] content,
                   @Nullable
                   java.lang.String encoding)
            throws java.lang.Exception

Apply the XPath expression and assert the resulting content exists.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

doesNotExist

public void doesNotExist(byte[] content,
                         @Nullable
                         java.lang.String encoding)
                  throws java.lang.Exception

Apply the XPath expression and assert the resulting content does not exist.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertNodeCount

public void assertNodeCount(byte[] content,
                            @Nullable
                            java.lang.String encoding,
                            Matcher<java.lang.Integer> matcher)
                     throws java.lang.Exception

Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertNodeCount

public void assertNodeCount(byte[] content,
                            @Nullable
                            java.lang.String encoding,
                            int expectedCount)
                     throws java.lang.Exception

Apply the XPath expression and assert the resulting content as an integer.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertString

public void assertString(byte[] content,
                         @Nullable
                         java.lang.String encoding,
                         Matcher<? super java.lang.String> matcher)
                  throws java.lang.Exception

Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertString

public void assertString(byte[] content,
                         @Nullable
                         java.lang.String encoding,
                         java.lang.String expectedValue)
                  throws java.lang.Exception

Apply the XPath expression and assert the resulting content as a String.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertNumber

public void assertNumber(byte[] content,
                         @Nullable
                         java.lang.String encoding,
                         Matcher<? super java.lang.Double> matcher)
                  throws java.lang.Exception

Apply the XPath expression and assert the resulting content with the given Hamcrest matcher.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertNumber

public void assertNumber(byte[] content,
                         @Nullable
                         java.lang.String encoding,
                         java.lang.Double expectedValue)
                  throws java.lang.Exception

Apply the XPath expression and assert the resulting content as a Double.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

assertBoolean

public void assertBoolean(byte[] content,
                          @Nullable
                          java.lang.String encoding,
                          boolean expectedValue)
                   throws java.lang.Exception

Apply the XPath expression and assert the resulting content as a Boolean.

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

evaluateXpath

@Nullable
public <T> T evaluateXpath(byte[] content,
                                     @Nullable
                                     java.lang.String encoding,
                                     java.lang.Class<T> targetClass)
                              throws java.lang.Exception

Evaluate the XPath and return the resulting value.

Parameters:

content - the content to evaluate against

encoding - the encoding to use (optionally)

targetClass - the target class, one of Number, String, Boolean, org.w3c.Node, or NodeList

Throws:

java.lang.Exception - if content parsing or expression evaluation fails

Since:

5.1

parseXmlByteArray

protected org.w3c.dom.Document parseXmlByteArray(byte[] xml,
                                                 @Nullable
                                                 java.lang.String encoding)
                                          throws java.lang.Exception

Parse the given XML content to a Document.

Parameters:

xml - the content to parse

encoding - optional content encoding, if provided as metadata (e.g. in HTTP headers)

Returns:

the parsed document

Throws:

java.lang.Exception

evaluateXpath

@Nullable
protected <T> T evaluateXpath(org.w3c.dom.Document document,
                                        QName evaluationType,
                                        java.lang.Class<T> expectedClass)
                                 throws javax.xml.xpath.XPathExpressionException

Apply the XPath expression to given document.

Throws:

javax.xml.xpath.XPathExpressionException - if expression evaluation failed