Java Singleton for Selenium Webdriver Example

In my series of articles " Design Patterns in Automated Testing ", I am presenting you the most useful techniques for structuring the code of the automation tests. The today's publication is about the Singleton Design Pattern. In my previous posts, I have explained how to use the Page Object and Facade Design Patterns. If you are not familiar with them, I advise you to read my articles on the matter. The Singleton Design Pattern can be used in the automation tests to build up easier access to page objects and facades. Its usage can speed up the tests writing process dramatically. In this article, I am going to show you the best and most straightforward approaches to integrating the Singleton Design Pattern in your test automation framework.

Definition

Ensure a class has only one instance and provide a global point of access to it.

• Instance control– prevents other objects from instantiating their own copies of the Singleton object, ensuring that all objects access the single instance.
• Flexibility– since the class controls the instantiation process, the class has the flexibility to change the instantiation process.
• Lazy initialization– defers the object's creation until it is first used.

UML Class Diagram

Participants

The classes and objects participating in this pattern are:

• Page Objects (SearchEngineMainPage)- Holds the actions that can be performed on the page like Search and Navigate. Exposes an easy access to the Page Validator through the Validate() method. The best implementations of the pattern hide the usage of the Element Map, wrapping it through all action methods.
• BasePage<S, M> – Gives access to the child's page element map class and defines a standard navigation operation.
• BasePage<S, M, V> – Adds an instance to the child page's validator class through the Validate method.
• BaseSingleton – This is an abstract class that contains a static property of its child instance BaseSingleton – This is an abstract class that provides a static property of its child instance.

Singleton Design Pattern C# Code

Create Singleton in BasePage

The most straightforward way to integrate the Singleton Design Pattern in all of your existing page objects is to add a static variable and property in the BasePage class. If you are not familiar what the BasePage classes are, refer to my article- Advanced Page Object Pattern in Automation Testing.

	public class BasePage<M>
	where M : BasePageElementMap, new()
	{
	private static BasePage<M> instance;
	protected readonly string url;
	public BasePage(string url)
	{
	this.url = url;
	}
	public BasePage()
	{
	this.url = null;
	}
	public static BasePage<M> Instance
	{
	get
	{
	if (instance == null)
	{
	instance = new BasePage<M>();
	}
	return instance;
	}
	}
	protected M Map
	{
	get
	{
	return new M();
	}
	}
	public virtual void Navigate(string part = " " )
	{
	Driver.Browser.Navigate().GoToUrl(string.Concat(url, part));
	}
	}

The drawback of the above solution is that you cannot reuse the singleton implementation for your Facade classes. The answer to the mentioned problem is to create a base generic singleton class that can be derived from all pages and facades.

Non-thread-safe BaseSingleton Class

Find below, the most trivial implementation of the generic base class for the Singleton Design Pattern.

	public abstract class Nonthread-safeBaseSingleton<T>
	where T: new()
	{
	private static T instance;
	public static T Instance
	{
	get
	{
	if (instance == null)
	{
	instance = new T();
	}
	return instance;
	}
	}
	}

In most scenarios for automation tests, this solution should be sufficient. However, this implementation is not thread-safe. To be possible to execute tests in parallel, I am going to propose you other variations of the base class that are thread-safe.

For more detailed overview and usage of many more design patterns and best practices in automated testing, check my book " Design Patterns for High-Quality Automated Tests, C# Edition, High-Quality Tests Attributes, and Best Practices ".  You can read part of three of the chapters:

Defining High-Quality Test Attributes for Automated Tests

Benchmarking for Assessing Automated Test Components Performance

Generic Repository Design Pattern- Test Data Preparation

Thread-safe BaseSingleton Class with Lock

	public abstract class Thread-safeBaseSingleton<T>
	where T : new()
	{
	private static T instance;
	private static readonly object lockObject = new object();
	private thread-safeBaseSingleton()
	{
	}
	public static T Instance
	{
	get
	{
	if (instance == null)
	{
	lock (lockObject)
	{
	if (instance == null)
	{
	instance = new T();
	}
	}
	}
	return instance;
	}
	}
	}

Here, I am using a lock statement that ensures that one thread does not enter a critical section of code while another thread is in the critical section. If another thread tries to enter a locked code, it will wait, block until the object is released. As you can see the code doesn't lock the T instance, instead it locks its internal object. This is done to prevent deadlocks.

Thread-safe BaseSingleton Class with Lazy

The built-in .NET framework generic class Lazy<T> saves some code for implementing the lazy initialization. Also, it is thread-safe.

	public abstract class ThreadSafeLazyBaseSingleton<T>
	where T : new()
	{
	private static readonly Lazy<T> lazy = new Lazy<T>(() => new T());
	public static T Instance
	{
	get
	{
	return lazy.Value;
	}
	}
	}

Thread-safe BaseSingleton Class with Nested Classes

The most complicated variation of the base class implementing Singleton Design Pattern uses nested classes and reflection.

	public abstract class ThreadSafeNestedContructorsBaseSingleton<T>
	{
	public static T Instance
	{
	get
	{
	return SingletonFactory.Instance;
	}
	}
	internal static class SingletonFactory
	{
	internal static T Instance;
	static SingletonFactory()
	{
	CreateInstance(typeof(T));
	}
	public static T CreateInstance(Type type)
	{
	ConstructorInfo[] ctorsPublic = type.GetConstructors(BindingFlags.Instance | BindingFlags.Public);
	if (ctorsPublic.Length > 0)
	{
	throw new Exception(string.Concat(type.FullName, " has one or more public constructors so the property cannot be enforced." ));
	}
	ConstructorInfo nonPublicConstructor =
	type.GetConstructor(BindingFlags.Instance | BindingFlags.NonPublic, null, new Type[0], new ParameterModifier[0]);
	if (nonPublicConstructor == null)
	{
	throw new Exception(string.Concat(type.FullName, " does not have a private/protected constructor so the property cannot be enforced." ));
	}
	try
	{
	return Instance = (T)nonPublicConstructor.Invoke(new object[0]);
	}
	catch (Exception e)
	{
	throw new Exception(
	string.Concat( "The Singleton could not be constructed. Check if " , type.FullName, " has a default constructor." ), e);
	}
	}
	}
	}

The nested class contains static constructor to tell the C# compiler not to mark the type as before-field-init. Now the BasePage classes should not have constructors to follow the Singleton Design Pattern, because of that the new() class constraint is removed.

The structure of the base classes for the Page Object Pattern should be slightly changed due to the earlier mentioned reason.

	public abstract class BasePageSingletonDerived<S, M> : thread–safeNestedContructorsBaseSingleton<S>
	where M : BasePageElementMap, new()
	where S : BasePageSingletonDerived<S, M>
	{
	protected M Map
	{
	get
	{
	return new M();
	}
	}
	public virtual void Navigate(string url = " " )
	{
	Driver.Browser.Navigate().GoToUrl(string.Concat(url));
	}
	}
	public abstract class BasePageSingletonDerived<S, M, V> : BasePageSingletonDerived<S, M>
	where M : BasePageElementMap, new()
	where V : BasePageValidator<M>, new()
	where S : BasePageSingletonDerived<S, M, V>
	{
	public V Validate()
	{
	return new V();
	}
	}

One of the significant changes in the code is the new S generic parameter that represents the type of the child page which is going to be initialized. Also, you can notice the absence of constructors and that the both classes are marked as abstract.
The page object class that derives from these classes can look like the following.

	public class SearchEngineMainPage :
	BasePageSingletonDerived<
	SearchEngineMainPage,
	SearchEngineMainPageElementMap,
	SearchEngineMainPageValidator>
	{
	private SearchEngineMainPage() { }
	public void Search(string textToType)
	{
	this.Map.SearchBox.Clear();
	this.Map.SearchBox.SendKeys(textToType);
	this.Map.GoButton.Click();
	}
	public override void Navigate(string url = "searchEngineUrl" )
	{
	base.Navigate(url);
	}
	}

I want to emphasize that the constructor of this class is marked as private, which prevents the creation of a default constructor.

Tests Using Singleton Design Pattern

Now you can use the page objects directly in your code without the keyword new, thanks to the singleton design pattern.

	[TestClass]
	public class AdvancedSearchEngineSingletonTests
	{
	[TestInitialize]
	public void SetupTest()
	{
	Driver.StartBrowser();
	}
	[TestCleanup]
	public void TeardownTest()
	{
	Driver.StopBrowser();
	}
	[TestMethod]
	public void SearchTextInSearchEngine_Advanced_PageObjectPattern_NoSingleton()
	{
	// Usage without Singleton
	P.SearchEngineMainPage searchEngineMainPage = new P.SearchEngineMainPage();
	searchEngineMainPage.Navigate();
	searchEngineMainPage.Search( "Automate The Planet" );
	searchEngineMainPage.Validate().ResultsCount( ",000 RESULTS" );
	}
	[TestMethod]
	public void SearchTextInSearchEngine_Advanced_PageObjectPattern_Singleton()
	{
	S.SearchEngineMainPage.Instance.Navigate();
	S.SearchEngineMainPage.Instance.Search( "Automate The Planet" );
	S.SearchEngineMainPage.Instance.Validate().ResultsCount( ",000 RESULTS" );
	}
	}

Online Training

• C#

• JAVA

• NON-FUNCTIONAL

Web Test Automation Fundamentals

LEVEL: 1

• Java Level 1
• Java Unit Testing Fundamentals
• Source Control Introduction
• Selenium WebDriver- Getting Started
• Setup Continuous Integration Job

Duration: 20 hours

4 hour per day

-50% coupon code:

BELLATRIX50

Test Automation Advanced

LEVEL: 2

• Java Level 2
• WebDriver Level 2
• Appium Level 1
• WinAppDriver Level 1
• WebDriver in Docker and Cloud
• Test Reporting Solutions and Frameworks
• Behavior-Driven Development

Duration: 30 hours

4 hour per day

-20% coupon code:

BELLATRIX20

Enterprise Test Automation Framework

LEVEL: 3 (Master Class)

After discussing the core characteristics, we will start writing the core feature piece by piece.
We will continuously elaborate on why we design the code the way it is and look into different designs and compare them. You will have exercises to finish a particular part or extend it further along with discussing design patterns and best practices in programming.

Duration: 30 hours

4 hour per day

-20% coupon code:

BELLATRIX20

Web Test Automation Fundamentals

LEVEL: 1

• C# Level 1
• C# Unit Testing Fundamentals
• Source Control Introduction
• Selenium WebDriver- Getting Started
• Setup Continuous Integration Job

Duration: 20 hours

4 hour per day

-50% coupon code:

BELLATRIX50

Test Automation Advanced

LEVEL: 2

• C# Level 2
• WebDriver Level 2
• Appium Level 1
• WinAppDriver Level 1
• WebDriver in Docker and Cloud
• Test Reporting Solutions and Frameworks
• Behavior-Driven Development- SpecFlow

Duration: 30 hours

4 hour per day

-20% coupon code:

BELLATRIX20

Enterprise Test Automation Framework

LEVEL: 3 (Master Class)

After discussing the core characteristics, we will start writing the core feature piece by piece.
We will continuously elaborate on why we design the code the way it is and look into different designs and compare them. You will have exercises to finish a particular part or extend it further along with discussing design patterns and best practices in programming.

Duration: 30 hours

4 hour per day

-20% coupon code:

BELLATRIX20

Performance Testing

• Fundamentals of Performance Testing
• Fundamentals of network technologie
• Performance testing with WebPageTest
• Performance test execution and automation
• Introduction to Jmeter
• Introduction to performance monitoring and tuning
• Performance testing in the cloud

Duration: 24 hours

4 hour per day

-30% coupon code:

BELLATRIX50

Design Patterns in Automated Testing

fisherhignaist.blogspot.com

Source: https://www.automatetheplanet.com/singleton-design-pattern/

Share this post