org.fluentlenium.core.components

Class ComponentsManager

java.lang.Object

org.fluentlenium.core.components.AbstractComponentInstantiator

org.fluentlenium.core.components.ComponentsManager

All Implemented Interfaces:

ComponentInstantiator, ComponentsAccessor, ProxyElementListener

public class ComponentsManager
extends AbstractComponentInstantiator
implements ComponentInstantiator, ComponentsAccessor, ProxyElementListener

Manage living components for a WebDriver instance.

A component is an Object implementing no particular interface, but capable a wrapping a WebElement.

FluentWebElement is the most common component.

Constructor Summary

Constructors

Constructor and Description
ComponentsManager(FluentControl control) Creates a new components manager.

Method Summary

Modifier and Type	Method and Description
<L extends List<T>,T> L	asComponentList(Class<L> listClass, Class<T> componentClass, Iterable<org.openqa.selenium.WebElement> elementList) Create and register a new list of component from the given element iterable.
Set<Object>	getComponents(org.openqa.selenium.WebElement element) Get the related components from the given element.
ComponentInstantiator	getInstantiator() Get the component instantiator used by this components manager.
boolean	isComponentClass(Class<?> componentClass) Check if this class is a component class.
boolean	isComponentListClass(Class<? extends List<?>> componentListClass) Check if this class is a component list class.
<T> T	newComponent(Class<T> componentClass, org.openqa.selenium.WebElement element) Create and register a new component from the given element.
<L extends List<T>,T> L	newComponentList(Class<L> listClass, Class<T> componentClass, List<T> componentsList) Create and register a new list of component from the given component list.
void	proxyElementFound(Object proxy, org.openqa.selenium.support.pagefactory.ElementLocator locator, List<org.openqa.selenium.WebElement> elements) Invoked when proxy element search is over and elements were found.
void	proxyElementSearch(Object proxy, org.openqa.selenium.support.pagefactory.ElementLocator locator) Invoked when proxy element search is starting.
void	release() Release this manager.

Methods inherited from class org.fluentlenium.core.components.AbstractComponentInstantiator

asComponentList, asComponentList, asComponentList, asComponentList, asComponentList, asFluentList, asFluentList, asFluentList, asFluentList, asFluentList, asFluentList, newComponentList, newComponentList, newComponentList, newComponentList, newComponentList, newFluent, newFluentList, newFluentList, newFluentList, newFluentList, newFluentList, newFluentList

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.fluentlenium.core.components.ComponentInstantiator

asComponentList, asComponentList, asComponentList, asComponentList, asComponentList, asFluentList, asFluentList, asFluentList, asFluentList, asFluentList, asFluentList, newComponentList, newComponentList, newComponentList, newComponentList, newComponentList, newFluent, newFluentList, newFluentList, newFluentList, newFluentList, newFluentList, newFluentList

Constructor Detail

ComponentsManager

public ComponentsManager(FluentControl control)

Creates a new components manager.

Parameters:

control - control interface

Method Detail

getInstantiator

public ComponentInstantiator getInstantiator()

Get the component instantiator used by this components manager.

Returns:

component instantiator

getComponents

public Set<Object> getComponents(org.openqa.selenium.WebElement element)

Description copied from interface: ComponentsAccessor

Get the related components from the given element.

Specified by:

getComponents in interface ComponentsAccessor

Parameters:

element - selenium element

Returns:

components wrapping the given selenium element

isComponentClass

public boolean isComponentClass(Class<?> componentClass)

Description copied from interface: ComponentInstantiator

Check if this class is a component class.

Specified by:

isComponentClass in interface ComponentInstantiator

Parameters:

componentClass - class to check

Returns:

true if this class is a component class, false otherwise

isComponentListClass

public boolean isComponentListClass(Class<? extends List<?>> componentListClass)

Description copied from interface: ComponentInstantiator

Check if this class is a component list class.

Specified by:

isComponentListClass in interface ComponentInstantiator

Parameters:

componentListClass - class to check

Returns:

true if this class is a component list class, false otherwise

newComponent

public <T> T newComponent(Class<T> componentClass,
                          org.openqa.selenium.WebElement element)

Description copied from interface: ComponentInstantiator

Create and register a new component from the given element.

Specified by:

newComponent in interface ComponentInstantiator

Type Parameters:

T - type of the component

Parameters:

componentClass - type of the component

element - wrapped element

Returns:

new instance of the component

newComponentList

public <L extends List<T>,T> L newComponentList(Class<L> listClass,
                                                Class<T> componentClass,
                                                List<T> componentsList)

Description copied from interface: ComponentInstantiator

Create and register a new list of component from the given component list.

Specified by:

newComponentList in interface ComponentInstantiator

Type Parameters:

L - type of the list

T - type of the component

Parameters:

listClass - type of the list

componentClass - type of the component

componentsList - components list

Returns:

new list of components

asComponentList

public <L extends List<T>,T> L asComponentList(Class<L> listClass,
                                               Class<T> componentClass,
                                               Iterable<org.openqa.selenium.WebElement> elementList)

Description copied from interface: ComponentInstantiator

Create and register a new list of component from the given element iterable.

Specified by:

asComponentList in interface ComponentInstantiator

Overrides:

asComponentList in class AbstractComponentInstantiator

Type Parameters:

L - type of the list

T - type of the component

Parameters:

listClass - type of the list

componentClass - type of the component

elementList - elements

Returns:

new list of components

proxyElementSearch

public void proxyElementSearch(Object proxy,
                               org.openqa.selenium.support.pagefactory.ElementLocator locator)

Description copied from interface: ProxyElementListener

Invoked when proxy element search is starting.

Specified by:

proxyElementSearch in interface ProxyElementListener

Parameters:

proxy - proxy

locator - element locator

proxyElementFound

public void proxyElementFound(Object proxy,
                              org.openqa.selenium.support.pagefactory.ElementLocator locator,
                              List<org.openqa.selenium.WebElement> elements)

Description copied from interface: ProxyElementListener

Invoked when proxy element search is over and elements were found.

Specified by:

proxyElementFound in interface ProxyElementListener

Parameters:

proxy - proxy

locator - element locator

elements - found elements

release

public void release()

Release this manager.