Class XpathExpectationsHelper

Constructor Detail

• XpathExpectationsHelper

  public XpathExpectationsHelper​(String expression,
                                 Map<String,​String> namespaces,
                                 Object... args)
                          throws XPathExpressionException

  XpathExpectationsHelper constructor.

  Parameters:

  expression - the XPath expression

  namespaces - 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:

  XPathExpressionException - if expression compilation failed

Method Detail

• getXpathExpression

  protected XPathExpression getXpathExpression()

  Return the compiled XPath expression.

• assertNode

  public void assertNode​(byte[] content,
                         String encoding,
                         Matcher<? super Node> matcher)
                  throws Exception

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

  Throws:

  Exception

• parseXmlByteArray

  protected Document parseXmlByteArray​(byte[] xml,
                                       String encoding)
                                throws 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:

  Exception

• evaluateXpath

  protected <T> T evaluateXpath​(Document document,
                                QName evaluationType,
                                Class<T> expectedClass)
                         throws XPathExpressionException

  Apply the XPath expression to given document.

  Throws:

  XPathExpressionException - if expression evaluation failed

• exists

  public void exists​(byte[] content,
                     String encoding)
              throws Exception

  Apply the XPath expression and assert the resulting content exists.

  Throws:

  Exception - if content parsing or expression evaluation fails

• doesNotExist

  public void doesNotExist​(byte[] content,
                           String encoding)
                    throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertNodeCount

  public void assertNodeCount​(byte[] content,
                              String encoding,
                              Matcher<Integer> matcher)
                       throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertNodeCount

  public void assertNodeCount​(byte[] content,
                              String encoding,
                              int expectedCount)
                       throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertString

  public void assertString​(byte[] content,
                           String encoding,
                           Matcher<? super String> matcher)
                    throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertString

  public void assertString​(byte[] content,
                           String encoding,
                           String expectedValue)
                    throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertNumber

  public void assertNumber​(byte[] content,
                           String encoding,
                           Matcher<? super Double> matcher)
                    throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertNumber

  public void assertNumber​(byte[] content,
                           String encoding,
                           Double expectedValue)
                    throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails

• assertBoolean

  public void assertBoolean​(byte[] content,
                            String encoding,
                            boolean expectedValue)
                     throws Exception

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

  Throws:

  Exception - if content parsing or expression evaluation fails