XPathLocator

Class Overview

A Locator that uses XPath to locate org.w3c.dom.Node's

For more information on XPath look here:

http://www.w3.org/TR/xpath

For a tutorial on XPath look here:

http://www.w3schools.com/xpath/default.asp

http://www.zvon.org/xxl/XPathTutorial/General/examples.html

NOTE : Locators are one shot objects. A call to getNodes() should return the same Nodes every time it is called. Even if the underlying data source has changed (for example the WebTester page has changed) the Locator MUST return the same data.

Summary

[Expand] Inherited Fields
From class com.atlassian.jira.functest.framework.locator.AbstractLocator protected Node[] nodes protected WebResponse originalWebResponse protected WebTester tester

[Expand] Inherited Methods
From class com.atlassian.jira.functest.framework.locator.AbstractLocator Iterable<LocatorEntry> allMatches() Get all matches of this locator as an iterable collection of locator entries Node betterNode(Node node) static boolean containsNode(Locator locator, Node node) boolean exists() Return true at least one element will be matches by this locator. Document getDOM(WebTester tester) Returns the DOM Document from the WebTester. String getHTML() Returns the HTML that a called to getNodes() represent, including the top level nodes themselves. String getHTML(Node node) Returns the HTML of the specified node. Node getNode() This convenience methods is the the equivalent of getNodes()[0] except when the number of nodes found is zero, in which case it should return null. String getNodeTextImpl(Node node, AbstractLocator.LocatorTextOperation textOperation) Called to get the test or HTML of an org.w3c.dom.Node String getNodesTextImpl(Node[] nodes, AbstractLocator.LocatorTextOperation textOperation) Called to get all the text or HTML of a set of org.w3c.dom.Node's. String getRawText() Returns the combined raw text of the Nodes that getNodes() would return or empty string. String getRawText(Node node) Returns the raw text of the specified Node. String getText() Returns the combined collapsed text of the Nodes that getNodes() would return or empty string. String getText(Node node) Returns the collapsed text of the specified Node. WebResponse getWebResponse(WebTester tester) boolean hasNodes() This will return true if the Locator found some org.w3c.dom.Node's. Iterator<LocatorEntry> iterator() This will return a Iterator that returns LocatorEntry objects synchronized String toStringImpl(String concreteImplementationName)
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
From interface com.atlassian.jira.functest.framework.locator.Locator Iterable<LocatorEntry> allMatches() Get all matches of this locator as an iterable collection of locator entries boolean exists() Return true at least one element will be matches by this locator. String getHTML() Returns the HTML that a called to getNodes() represent, including the top level nodes themselves. String getHTML(Node node) Returns the HTML of the specified node. Node getNode() This convenience methods is the the equivalent of getNodes()[0] except when the number of nodes found is zero, in which case it should return null. Node[] getNodes() A Locator may return 0 nodes, 1 node or multiple nodes. String getRawText() Returns the combined raw text of the Nodes that getNodes() would return or empty string. String getRawText(Node node) Returns the raw text of the specified Node. String getText() Returns the combined collapsed text of the Nodes that getNodes() would return or empty string. String getText(Node node) Returns the collapsed text of the specified Node. boolean hasNodes() This will return true if the Locator found some org.w3c.dom.Node's. Iterator<LocatorEntry> iterator() This will return a Iterator that returns LocatorEntry objects String toString() A meaningful "debugging" representation of this Locator to help when test fail.