at.willhaben.willtest.rule

Class AbstractSeleniumProvider<P extends SeleniumProvider<P,D>,D extends org.openqa.selenium.WebDriver>

java.lang.Object

at.willhaben.willtest.rule.TestFailureAwareRule

at.willhaben.willtest.rule.AbstractSeleniumProvider<P,D>

All Implemented Interfaces:

SeleniumProvider<P,D>, org.junit.rules.TestRule

Direct Known Subclasses:

AbstractFirefoxProvider

public abstract class AbstractSeleniumProvider<P extends SeleniumProvider<P,D>,D extends org.openqa.selenium.WebDriver>
extends TestFailureAwareRule
implements SeleniumProvider<P,D>

Combines the Rule pattern with the SeleniumProvider, so in this class a webDriver is created for a test. This class implements the default cleanup after a test with a created webDriver. Registers and calls WebDriverConfigurationParticipant instances, which can influence the creation of the WebDriver.

Field Summary

Fields inherited from interface at.willhaben.willtest.config.SeleniumProvider

FIND_ELEMENT_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
AbstractSeleniumProvider()

Method Summary

Modifier and Type	Method and Description
P	addWebDriverConfigurationParticipant(WebDriverConfigurationParticipant<D> webDriverConfigurationParticipant) After creating a new WebDriver instance, a SeleniumProvider implementation should pass that instance to all WebDriverConfigurationParticipant to let them adjust it.
<T extends org.openqa.selenium.support.events.WebDriverEventListener & org.junit.rules.TestRule> P	addWebDriverEventListener(T listener) Registers a new instance of WebDriverEventListener & TestRule to the created SeleniumProvider.
protected void	after(org.junit.runner.Description description, Throwable testFailure) Closes the webDriver which was created in this rule.
protected void	before(org.junit.runner.Description description) Can do something before a test.
protected abstract D	constructWebDriver(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)
protected org.openqa.selenium.remote.DesiredCapabilities	createDesiredCapabilities(org.junit.runner.Description description)
org.openqa.selenium.WebDriver	getWebDriver()

Methods inherited from class at.willhaben.willtest.rule.TestFailureAwareRule

apply, onError

Methods inherited from class java.lang.Object

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

Methods inherited from interface at.willhaben.willtest.config.SeleniumProvider

getDefaultWebDriverWait, getThis

Constructor Detail

AbstractSeleniumProvider

public AbstractSeleniumProvider()

Method Detail

getWebDriver

public org.openqa.selenium.WebDriver getWebDriver()

Specified by:

getWebDriver in interface SeleniumProvider<P extends SeleniumProvider<P,D>,D extends org.openqa.selenium.WebDriver>

Returns:

a new WebDriver instance

addWebDriverConfigurationParticipant

public P addWebDriverConfigurationParticipant(WebDriverConfigurationParticipant<D> webDriverConfigurationParticipant)

Description copied from interface: SeleniumProvider

After creating a new WebDriver instance, a SeleniumProvider implementation should pass that instance to all WebDriverConfigurationParticipant to let them adjust it.

Specified by:

addWebDriverConfigurationParticipant in interface SeleniumProvider<P extends SeleniumProvider<P,D>,D extends org.openqa.selenium.WebDriver>

Parameters:

webDriverConfigurationParticipant - participant to be added to the list

Returns:

the provider itself to make method chaining possible

addWebDriverEventListener

public <T extends org.openqa.selenium.support.events.WebDriverEventListener & org.junit.rules.TestRule> P addWebDriverEventListener(T listener)

Description copied from interface: SeleniumProvider

Registers a new instance of WebDriverEventListener & TestRule to the created SeleniumProvider.

Specified by:

addWebDriverEventListener in interface SeleniumProvider<P extends SeleniumProvider<P,D>,D extends org.openqa.selenium.WebDriver>

Parameters:

listener - Implementation of WebDriverEventListener & TestRule added to the list of listeners

Returns:

the provider itself to make method chaining possible

before

protected void before(org.junit.runner.Description description)
               throws Throwable

Description copied from class: TestFailureAwareRule

Can do something before a test. By default it does nothing.

Overrides:

before in class TestFailureAwareRule

Parameters:

description - junit test description object

Throws:

Throwable - any error from the test

after

protected void after(org.junit.runner.Description description,
                     Throwable testFailure)
              throws Throwable

Closes the webDriver which was created in this rule. Takes care if there is an exception while closing the webDriver.

Overrides:

after in class TestFailureAwareRule

Parameters:

description - junit test description object

testFailure - in case of failed test it contains an exception. Otherwise null

Throws:

Throwable - if testFailure is null, it will fly, if testFailure is not null, it will be added to that as suppressed exception. See Throwable.addSuppressed(Throwable)

constructWebDriver

protected abstract D constructWebDriver(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)

createDesiredCapabilities

protected org.openqa.selenium.remote.DesiredCapabilities createDesiredCapabilities(org.junit.runner.Description description)