com.atlassian.jira.functest.framework.locator
Class AggregateLocator

java.lang.Object
  com.atlassian.jira.functest.framework.locator.AbstractLocator
      com.atlassian.jira.functest.framework.locator.AggregateLocator

All Implemented Interfaces:

Locator

public class AggregateLocator
extends AbstractLocator
implements Locator

AggregateLocator will "aggregate" together the results of the provided Locators

NOTE : Locators are one shot objects. A call to Locator.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.

Since:

v3.13

Nested Class Summary

Nested classes/interfaces inherited from class com.atlassian.jira.functest.framework.locator.AbstractLocator

AbstractLocator.LocatorTextOperation

Field Summary

Fields inherited from class com.atlassian.jira.functest.framework.locator.AbstractLocator

nodes, originalWebResponse, tester

Constructor Summary

AggregateLocator(Locator[] locators)
Aggregates together the values of the specified array of Locators

AggregateLocator(Locator firstLocator, Locator secondLocator)
Creates an agggregate of the firstLocator and the secondLocator

Method Summary

Node[]	getNodes() A Locator may return 0 nodes, 1 node or multiple nodes.
String	toString() A meaningful "debugging" representation of this Locator to help when test fail.

Methods inherited from class com.atlassian.jira.functest.framework.locator.AbstractLocator

allMatches, betterNode, containsNode, exists, getDOM, getHTML, getHTML, getNode, getNodesTextImpl, getNodeTextImpl, getRawText, getRawText, getText, getText, getWebResponse, hasNodes, iterator, toStringImpl

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.jira.functest.framework.locator.Locator

allMatches, exists, getHTML, getHTML, getNode, getRawText, getRawText, getText, getText, hasNodes, iterator

Constructor Detail

AggregateLocator

public AggregateLocator(Locator firstLocator,
                        Locator secondLocator)

Creates an agggregate of the firstLocator and the secondLocator

Parameters:

firstLocator - the first Locator to aggregate

secondLocator - the second Locator to aggregate

AggregateLocator

public AggregateLocator(Locator[] locators)

Aggregates together the values of the specified array of Locators

Parameters:

locators - must be non null and have a lenght > 0 and have non null array Locator members

Method Detail

getNodes

public Node[] getNodes()

Description copied from interface: Locator

A Locator may return 0 nodes, 1 node or multiple nodes.

Specified by:

getNodes in interface Locator

Returns:

a non null array of Nodes that match, or a zero sized array of no matches are made

toString

public String toString()

Description copied from interface: Locator

A meaningful "debugging" representation of this Locator to help when test fail.

Specified by:

toString in interface Locator

Overrides:

toString in class Object

Returns:

A meaningful "debugging" representation of this Locator to help when test fail.