Package org.javalite.test

Class XPathHelper

java.lang.Object
org.javalite.test.XPathHelper
public class XPathHelper extends Object
Convenience class for pulling information from XML documents. It provides a set of convenience methods for checking structure and content of XML files. Such files could be XHTML generated for web apps, or any other XML.
Author:
Igor Polevoy

  • Constructor Details

    • XPathHelper

      public XPathHelper​(String xml)
      Use constructor and instance methods to only parse once and reuse a parsed tree. Use this method in high performance applicaitons when you need to pull many values from the same document.
      Parameters:
      xml - XML to parse.

  • Method Details

    • selectText

      public String selectText​(String xpath)
      Retrieves text of a single node.
      Parameters:
      xpath - XPath pointing to a single node (not its text).
      Returns:
      text of a node.

    • attributeValue

      public String attributeValue​(String xpath)
      Returns a value of an attribute.
      Parameters:
      xpath - needs to point to an attribute of a single node.
      Returns:
      value of an attribute of a single node.

    • count

      public int count​(String xpath)
      Counts a collection selected by XPath expression.
      Parameters:
      xpath - expression which muse evaluate to a list of items.
      Returns:
      size of a collection selected by expression.

    • selectText

      public static String selectText​(String xpath, String xml)
      Selects text from a single node.
      Parameters:
      xpath - expression that points to a single node.
      xml - document.
      Returns:
      text from a selected node.

    • count

      public static int count​(String xpath, String xml)
      Counts a collection selected by XPath expression.
      Parameters:
      xpath - expression which mus evaluate to a list of items.
      xml - xml document.
      Returns:
      size of a collection selected by expression.

    • attributeValue

      public static String attributeValue​(String xpath, String xml)
      Selects a value of attribute.
      Parameters:
      xpath - expression that points to a specific attribute of a specific node. Example: /a/b[1]/@id.
      xml - document.
      Returns:
      value of selected attribute.

    • selectStrings

      public static List<String> selectStrings​(String xpath, String xml)
      Selects text nodes as list of strings
      Parameters:
      xpath - xpath expression, should end with text() function, example: "//name/text()"
      xml - xml to get strings from.
      Returns:
      list of found strings matching expression, never null. If nothing matches, list will be empty.