org.openqa.selenium.support.pagefactory

Class DefaultElementLocator

java.lang.Object

org.openqa.selenium.support.pagefactory.DefaultElementLocator

All Implemented Interfaces:

ElementLocator

Direct Known Subclasses:

AjaxElementLocator

public class DefaultElementLocator
extends java.lang.Object
implements ElementLocator

The default element locator, which will lazily locate an element or an element list on a page. This class is designed for use with the PageFactory and understands the annotations FindBy and CacheLookup.

Field Summary

Fields

Modifier and Type	Field and Description
private org.openqa.selenium.By	by
private org.openqa.selenium.WebElement	cachedElement
private java.util.List<org.openqa.selenium.WebElement>	cachedElementList
private org.openqa.selenium.SearchContext	searchContext
private boolean	shouldCache

Constructor Summary

Constructors

Constructor and Description
DefaultElementLocator(org.openqa.selenium.SearchContext searchContext, AbstractAnnotations annotations) Use this constructor in order to process custom annotaions.
DefaultElementLocator(org.openqa.selenium.SearchContext searchContext, java.lang.reflect.Field field) Creates a new element locator.

Method Summary

Modifier and Type	Method and Description
org.openqa.selenium.WebElement	findElement() Find the element.
java.util.List<org.openqa.selenium.WebElement>	findElements() Find the element list.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

searchContext

private final org.openqa.selenium.SearchContext searchContext

shouldCache

private final boolean shouldCache

by

private final org.openqa.selenium.By by

cachedElement

private org.openqa.selenium.WebElement cachedElement

cachedElementList

private java.util.List<org.openqa.selenium.WebElement> cachedElementList

Constructor Detail

DefaultElementLocator

public DefaultElementLocator(org.openqa.selenium.SearchContext searchContext,
                             java.lang.reflect.Field field)

Creates a new element locator.

Parameters:

searchContext - The context to use when finding the element

field - The field on the Page Object that will hold the located value

DefaultElementLocator

public DefaultElementLocator(org.openqa.selenium.SearchContext searchContext,
                             AbstractAnnotations annotations)

Use this constructor in order to process custom annotaions.

Parameters:

searchContext - The context to use when finding the element

annotations - AbstractAnnotations class implementation

Method Detail

findElement

public org.openqa.selenium.WebElement findElement()

Find the element.

Specified by:

findElement in interface ElementLocator

findElements

public java.util.List<org.openqa.selenium.WebElement> findElements()

Find the element list.

Specified by:

findElements in interface ElementLocator

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object