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

java.lang.Object
  extended by com.atlassian.jira.functest.framework.locator.AbstractLocator
      extended by 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.


Copyright © 2002-2013 Atlassian. All Rights Reserved.