com.github.bordertech.wcomponents.test.selenium.driver

Class WebDriverCache

java.lang.Object

com.github.bordertech.wcomponents.test.selenium.driver.WebDriverCache

public final class WebDriverCache
extends Object

Static utility testing class to keep a Selenium Web Driver open between tests using the same thread. This is to prevent the expensive WebDriver creation occurring multiple times per test suite.

WebDriver implementations are not thread-safe, so the drivers opened by this class will be separated from other threads via a ThreadLocal.

Multiple concurrent instances of the same driver type can be created using a different driver id.

This class will clean up open drivers when the JVM terminates.

Since:

1.2.0

Author:

Joshua Barclay, Jonathan Austin

Method Summary

Methods

Modifier and Type	Method and Description
static void	closeDriver(WebDriverType driverType, String driverId) Close the driver of the given type and driver id.
static <T extends org.openqa.selenium.WebDriver> SeleniumWComponentsWebDriver<T>	getDriver(WebDriverType<T> driverType) Get or create the driver for the given driver type.
static <T extends org.openqa.selenium.WebDriver> SeleniumWComponentsWebDriver<T>	getDriver(WebDriverType<T> driverType, String driverId) Get or create the driver for the given driver type and unique driver id.
static void	releaseDriver(WebDriverType driverType, String driverId) Close the driver of the given type and driver id.

Methods inherited from class java.lang.Object

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

Method Detail

getDriver

public static <T extends org.openqa.selenium.WebDriver> SeleniumWComponentsWebDriver<T> getDriver(WebDriverType<T> driverType)

Get or create the driver for the given driver type.

Type Parameters:

T - the type of the WebDriver.

Parameters:

driverType - the WebDriver type wrapper.

Returns:

A shared (ThreadLocal) instance of the given WebDriver type.

getDriver

public static <T extends org.openqa.selenium.WebDriver> SeleniumWComponentsWebDriver<T> getDriver(WebDriverType<T> driverType,
                                                                                  String driverId)

Get or create the driver for the given driver type and unique driver id.

Type Parameters:

T - the type of the WebDriver.

Parameters:

driverType - the WebDriver type wrapper.

driverId - the unique identifier for this driver implementation.

Returns:

A shared (ThreadLocal) instance of the given WebDriver type and unique driver id.

closeDriver

public static void closeDriver(WebDriverType driverType,
               String driverId)

Close the driver of the given type and driver id.

Parameters:

driverType - the type of the driver to close.

driverId - the unique driver id of the driver to close

releaseDriver

public static void releaseDriver(WebDriverType driverType,
                 String driverId)

Close the driver of the given type and driver id.

Parameters:

driverType - the type of the driver to close.

driverId - the unique driver id of the driver to close