aquality.selenium.core.elements

Class ElementFactory

java.lang.Object

aquality.selenium.core.elements.ElementFactory

All Implemented Interfaces:

IElementFactory

public class ElementFactory
extends Object
implements IElementFactory

Constructor Summary

Constructors

Constructor and Description
ElementFactory(IConditionalWait conditionalWait, IElementFinder elementFinder, ILocalizationManager localizationManager)

Method Summary

Modifier and Type	Method and Description
protected String	extractXPathFromLocator(org.openqa.selenium.By locator) Extracts XPath from passed locator.
<T extends IElement> T	findChildElement(IElement parentElement, org.openqa.selenium.By childLoc, String name, Class<T> clazz, ElementState state) Finds child element by its locator relative to parent element.
<T extends IElement> T	findChildElement(IElement parentElement, org.openqa.selenium.By childLoc, String name, IElementSupplier<T> supplier, ElementState state) Finds child element by its locator relative to parent element.
<T extends IElement> List<T>	findChildElements(IElement parentElement, org.openqa.selenium.By childLoc, String name, Class<T> clazz, ElementsCount count, ElementState state) Finds child elements by their locator relative to parent element.
<T extends IElement> List<T>	findChildElements(IElement parentElement, org.openqa.selenium.By childLoc, String name, IElementSupplier<T> supplier, ElementsCount count, ElementState state) Finds child elements by their locator relative to parent element.
<T extends IElement> List<T>	findElements(org.openqa.selenium.By locator, String name, Class<T> clazz, ElementsCount count, ElementState state) Find list of elements.
<T extends IElement> List<T>	findElements(org.openqa.selenium.By locator, String name, IElementSupplier<T> supplier, ElementsCount count, ElementState state) Find list of elements.
protected org.openqa.selenium.By	generateAbsoluteChildLocator(org.openqa.selenium.By parentLoc, org.openqa.selenium.By childLoc) Generates absolute child locator for target element.
protected org.openqa.selenium.By	generateXpathLocator(org.openqa.selenium.By multipleElementsLocator, org.openqa.selenium.WebElement webElement, int elementIndex) Generates xpath locator for target element.
<T extends IElement> T	getCustomElement(Class<T> clazz, org.openqa.selenium.By locator, String name, ElementState state) Create custom element according to passed parameters.
<T extends IElement> T	getCustomElement(IElementSupplier<T> elementSupplier, org.openqa.selenium.By locator, String name, ElementState state) Create custom element according to passed parameters.
protected <T extends IElement> IElementSupplier<T>	getDefaultElementSupplier(Class<T> clazz)
protected Map<Class<? extends IElement>,Class<? extends IElement>>	getElementTypesMap() Gets map between elements interfaces and their implementations.
protected boolean	isLocatorSupportedForXPathExtraction(org.openqa.selenium.By locator) Defines is the locator can be transformed to xpath or not.
protected <T extends IElement> Class<T>	resolveElementClass(Class<T> clazz)
protected void	waitForElementsCount(org.openqa.selenium.By locator, ElementsCount count, ElementState state)

Methods inherited from class java.lang.Object

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

Methods inherited from interface aquality.selenium.core.elements.interfaces.IElementFactory

findChildElement, findChildElement, findChildElement, findChildElement, findChildElement, findChildElement, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findChildElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, findElements, getCustomElement, getCustomElement

Constructor Detail

ElementFactory

@Inject
public ElementFactory(IConditionalWait conditionalWait,
                              IElementFinder elementFinder,
                              ILocalizationManager localizationManager)

Method Detail

getCustomElement

public <T extends IElement> T getCustomElement(IElementSupplier<T> elementSupplier,
                                               org.openqa.selenium.By locator,
                                               String name,
                                               ElementState state)

Description copied from interface: IElementFactory

Create custom element according to passed parameters.

Specified by:

getCustomElement in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

elementSupplier - Delegate that defines constructor of element.

locator - Locator of the target element.

name - Name of the target element.

state - Visibility state of the target element.

Returns:

Instance of custom element.

getCustomElement

public <T extends IElement> T getCustomElement(Class<T> clazz,
                                               org.openqa.selenium.By locator,
                                               String name,
                                               ElementState state)

Description copied from interface: IElementFactory

Create custom element according to passed parameters.

Specified by:

getCustomElement in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

clazz - Class or interface of the element to be obtained.

locator - Locator of the target element.

name - Name of the target element.

state - Visibility state of the target element.

Returns:

Instance of custom element.

findChildElement

public <T extends IElement> T findChildElement(IElement parentElement,
                                               org.openqa.selenium.By childLoc,
                                               String name,
                                               Class<T> clazz,
                                               ElementState state)

Description copied from interface: IElementFactory

Finds child element by its locator relative to parent element.

Specified by:

findChildElement in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

parentElement - Parent element for relative search of child element.

childLoc - Locator of child element relative to its parent.

name - Child element name.

clazz - Class or interface of the element to be obtained.

state - Visibility state of target element.

Returns:

Child element.

findChildElement

public <T extends IElement> T findChildElement(IElement parentElement,
                                               org.openqa.selenium.By childLoc,
                                               String name,
                                               IElementSupplier<T> supplier,
                                               ElementState state)

Description copied from interface: IElementFactory

Finds child element by its locator relative to parent element.

Specified by:

findChildElement in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

parentElement - Parent element for relative search of child element.

childLoc - Locator of child element relative to its parent.

name - Child element name.

supplier - Required element's supplier.

state - Visibility state of child element.

Returns:

Child element.

findChildElements

public <T extends IElement> List<T> findChildElements(IElement parentElement,
                                                      org.openqa.selenium.By childLoc,
                                                      String name,
                                                      Class<T> clazz,
                                                      ElementsCount count,
                                                      ElementState state)

Description copied from interface: IElementFactory

Finds child elements by their locator relative to parent element.

Specified by:

findChildElements in interface IElementFactory

Type Parameters:

T - Type of the target elements.

Parameters:

parentElement - Parent element for relative search of child elements.

childLoc - Locator of child elements relative to its parent.

name - Child elements name.

clazz - Class or interface of the elements to be obtained.

count - Expected number of elements that have to be found (zero, more then zero, any).

state - Visibility state of target elements.

Returns:

List of child elements.

findChildElements

public <T extends IElement> List<T> findChildElements(IElement parentElement,
                                                      org.openqa.selenium.By childLoc,
                                                      String name,
                                                      IElementSupplier<T> supplier,
                                                      ElementsCount count,
                                                      ElementState state)

Description copied from interface: IElementFactory

Finds child elements by their locator relative to parent element.

Specified by:

findChildElements in interface IElementFactory

Type Parameters:

T - Type of the target elements.

Parameters:

parentElement - Parent element for relative search of child elements.

childLoc - Locator of child elements relative to its parent.

name - Child elements name.

supplier - Required elements' supplier.

state - Visibility state of child elements.

Returns:

List of child elements.

findElements

public <T extends IElement> List<T> findElements(org.openqa.selenium.By locator,
                                                 String name,
                                                 IElementSupplier<T> supplier,
                                                 ElementsCount count,
                                                 ElementState state)

Description copied from interface: IElementFactory

Find list of elements.

Specified by:

findElements in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

locator - Elements selector.

name - Child element name.

supplier - Required elements' supplier.

count - Expected number of elements that have to be found (zero, more then zero, any).

state - Visibility state of target elements.

Returns:

List of elements.

waitForElementsCount

protected void waitForElementsCount(org.openqa.selenium.By locator,
                                    ElementsCount count,
                                    ElementState state)
                             throws TimeoutException

Throws:

TimeoutException

findElements

public <T extends IElement> List<T> findElements(org.openqa.selenium.By locator,
                                                 String name,
                                                 Class<T> clazz,
                                                 ElementsCount count,
                                                 ElementState state)

Description copied from interface: IElementFactory

Find list of elements.

Specified by:

findElements in interface IElementFactory

Type Parameters:

T - Type of the target element.

Parameters:

locator - Elements selector.

name - Child element name.

clazz - Class or interface of the element to be obtained.

count - Expected number of elements that have to be found (zero, more then zero, any).

state - Visibility state of target elements.

Returns:

List of elements.

generateXpathLocator

protected org.openqa.selenium.By generateXpathLocator(org.openqa.selenium.By multipleElementsLocator,
                                                      org.openqa.selenium.WebElement webElement,
                                                      int elementIndex)

Generates xpath locator for target element.

Parameters:

multipleElementsLocator - locator used to find elements. Currently only By.ByXPath locators are supported.

webElement - target element.

elementIndex - index of target element.

Returns:

target element's locator

extractXPathFromLocator

protected String extractXPathFromLocator(org.openqa.selenium.By locator)

Extracts XPath from passed locator. Current implementation works only with ByXPath.class and ByTagName locator types, but you can implement your own for the specific WebDriver type.

Parameters:

locator - locator to get xpath from.

Returns:

extracted XPath.

generateAbsoluteChildLocator

protected org.openqa.selenium.By generateAbsoluteChildLocator(org.openqa.selenium.By parentLoc,
                                                              org.openqa.selenium.By childLoc)

Generates absolute child locator for target element.

Parameters:

parentLoc - parent locator

childLoc - child locator relative to parent

Returns:

absolute locator of the child

isLocatorSupportedForXPathExtraction

protected boolean isLocatorSupportedForXPathExtraction(org.openqa.selenium.By locator)

Defines is the locator can be transformed to xpath or not. Current implementation works only with ByXPath.class and ByTagName locator types, but you can implement your own for the specific WebDriver type.

Parameters:

locator - locator to transform

Returns:

true if the locator can be transformed to xpath, false otherwise.

getElementTypesMap

protected Map<Class<? extends IElement>,Class<? extends IElement>> getElementTypesMap()

Gets map between elements interfaces and their implementations. Can be extended for custom elements with custom interfaces.

Returns:

Map where key is interface and value is its implementation.

resolveElementClass

protected <T extends IElement> Class<T> resolveElementClass(Class<T> clazz)

getDefaultElementSupplier

protected <T extends IElement> IElementSupplier<T> getDefaultElementSupplier(Class<T> clazz)