Quick Start Guide

Using Log4j in your Apache Maven build

• http://logging.apache.org/
  • http://logging.apache.org/log4j/2.x/maven-artifacts.html
  • http://logging.apache.org/log4j/2.x/runtime-dependencies.html
  • https://logging.apache.org/log4j/2.x/manual/appenders.html
  • http://logging.apache.org/log4j/2.x/articles.html
    • https://examples.javacodegeeks.com/enterprise-java/log4j/log4j-2-best-practices-example/

Imports

import java.io.FileInputStream;
import java.io.FileOutputStream;

import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

Imports

import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxProfile;
import org.openqa.selenium.firefox.internal.ProfilesIni;

Components Commonly Used

WebDriver

• Create a public class so its accessible through the application
• Create a single static object so it also can be referenced throughout the application
• This class will do the work of building up & calling the correct Browser & Profile
• Then return the driver for use with the PageObjects(which will NOT be static)

public class BrowserUtils {
    public static WebDriver driver = null;

    public static WebDriver OpenBrowser(){

            // Create web driver
            driver = new FirefoxDriver();
            return driver;
    } //end method

}

Configuration File testng.xml

• See: http://maven.apache.org/surefire/maven-surefire-plugin/examples/testng.html

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Suites" parallel="none">
       <listeners>
              <listener class-name="com.uc.test.selenium.util.Listener"></listener>
       </listeners>
      <test name="Simple Test">
        <classes>
          <class name="com.uc.test.selenium.tests.Test_Login"/>
        </classes>
      </test>
      <!-- test name="ALL">
          <packages>
              <package name="com.uc.test.selenium.tests" />
          </packages>
      </test -->
      
                          
</suite> <!-- Suite -->

Package Layout

• src
  • log4j2.xml - log4j2 Configuration
  • pom.xml - Maven Configuration
  • testng.xml - TestNG Configuration
  • com.us.test.selenium
    • Main
  • com.us.test.selenium.pageactions
    • Home_Actions
  • com.us.test.selenium.pageobjects
    • Home_Page
    • PageBaseClass
  • com.us.test.selenium.tests
    • Login_Home
  • com.us.test.selenium.tests.testdata
    • TestData.xls
  • com.us.test.selenium.util
    • BrowserUtils
    • Constant
    • ElementUtils
    • ExcelUtils
    • LIstener
    • Listeners
    • TestLog

Classes

com.uc.test.selenium

Main

Packages Schema

Best Practices

• all lower case names
• use com.<brandName>.<appType>.<project>
  • the created packages will treat the '.' as a subfolder, yielding:
    • com
      • <brandName>
        • <appType>
          • <project>
• managing packages this way ensures conflicts won't arise when including other projects for larger ecosystems