selenium3 使用PageObject进行自动化测试

1、前提
做过一段时间UI层自动化，就会深深的体会到一个痛点：版本迭代太快，UI层元素的属性经常变换，导致维护人员需要花大把的时间去维护代码，为了节省维护成本及时间，就可以利用PageObject 这种设计模式，它就大大的减少了维护时间。
PageObject设计模式：是将某个页面的所有"元素（包含控件）属性"及"元素操作"封装在某个特定的类(Class)里面，目的就是测试代码与被测页面对象代码分离，后期如果有页面元素发生了更改,只需要修改相应Page类里面的获取属性的代码，测试层代码无需修改。
2、场景
使用selenium实现自动打开XXXX 首页，然后输入手机号、密码，点击登录后退出
浏览器：chrome 操作系统： OSX 10 开发工具：IntelliJ IDEA 测试框架：TestNG

3、以下以自己的一个例子作为讲下，如下截图是代码结构

*report：存放运行后的测试报告
*core：公共基础类
*pages:存放页面对象
*tests:运行测试用例
*utils:打印日志信息的一些配置格式
*resources:log4j配置以及testng 运行配置
步骤一、首先在pom.xml 里面需要引入jar包，以下实例用到selenium-java、TestNg、Log4j

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
<!-- test -->
    <groupId>webautotest</groupId>
    <artifactId>webautotest</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    <url>http://maven.apache.org</url>
<properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>6.9.6</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-firefox-driver</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-chrome-driver</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.17</version>
                <configuration>
                    <suiteXmlFiles>
                        <suiteXmlFile>src/test/java/pages/weiDianTest.xml</suiteXmlFile>
                    </suiteXmlFiles>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

步骤二、编写公共模块，初始化准备

public class TestBase {
    {
      // System.setProperty("webdriver.firefox.marionette", "/Users/chenxiaoqin/Downloads/geckodriver");
         System.setProperty("webdriver.chrome.driver", "/Users/chenxiaoqin/Downloads/chromedriver");
    }
   // protected WebDriver driver = new FirefoxDriver();//打开火狐浏览器
   ChromeOptions options =new ChromeOptions();
    protected WebDriver driver = new ChromeDriver(options);
  //获取当前类的类名传值给logger,该句的作用就是用log4j打印日志时知道是哪个类下面的打印输出信息
    public TestBase(){
        try {
            _newTest1();
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
    protected String getUrl() {
        return "https://www.XXX.com";
    }
    protected Logger logger =  LogManager.getLogger(getClass().getSimpleName());
    /**
     *
     * 程序入口，打开需要测试的url地址
     * */
    protected void _newTest1() throws MalformedURLException, InterruptedException {
        driver.get(getUrl());//打开需要测试页面的url
        Thread.sleep(2000);
        //chrome最大化
         options.addArguments("--start-maximized");
        //driver.manage().window().maximize();//获取当前窗口最大化，这个方法是不支持IE跟谷歌浏览器
        Thread.sleep(1000);
    }
    @AfterMethod
    protected void tearDown(){
        driver.quit();
    }
}

步骤三、使用PageFactory初始化pageObject对象，它存在于org.openqa.selenium.support库里面，它提供的方法都是静态的，可以直接调用，提供以下4种方法：

initElements(WebDriver driver, Class<T> pageClassToProxy)
initElements(WebDriver driver, Object page)
initElements(ElementLocatorFactory factory, Object page)
initElements(FieldDecorator decorator, Object page)

一般在实际应用中,我们可以这样使用：

PageFactory.initElements(dr, XXX.class);

或者这样使用：

PageFactory.initElements(new AjaxElementLocatorFactory(dr, 10) ,XXX.class);
后者加入了初始化元素时等待时间

通过initElements方法初始化的各个页面对象，AjaxElementLocatorFactory方法可以查找元素时都会在指定的TIMEOUT时间内不断重试，如果在指定时间内定位到元素则马上继续，如果指定时间内未找到则抛出NoSuchElementException异常。具体事例如下：

package pages;
import core.TestBase;
import org.apache.log4j.LogManager;
import org.apache.log4j.Logger;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.support.PageFactory;
import org.openqa.selenium.support.pagefactory.AjaxElementLocatorFactory;
import org.openqa.selenium.support.pagefactory.ElementLocatorFactory;

/**
 * Created by jean.
 */
public class GeneralPage {
    protected  WebDriver driver;
    public GeneralPage (WebDriver driver) {
        this.driver = driver;
        //通过initElements方法初始化的各个页面对象，AjaxElementLocatorFactory方法可以查找元素时都会在指定的TIMEOUT时间内不断重试，如果在指定时间内定位到元素则马上继续，如果指定时间内未找到则抛出NoSuchElementException异常。
        PageFactory.initElements(new AjaxElementLocatorFactory(driver, 3000), this);
    }
    /**
     * 封装sendKey文本框输入方法
     * 封装click点击事件方法
     *
     * */
    protected void sendKeys(By by, String value) {
        driver.findElement(by).sendKeys(value);
    }
    protected void click(By by) {
        driver.findElement(by).click();
    }
}

步骤四、创建LogonPage,使用@FindBy来查找页面元素，支持的类型有：id
、name、className、css、tagName、linkText、partialLinkText、xpath
package pages;

import core.TestBase;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.FindBy;
import org.testng.annotations.Test;
import java.net.MalformedURLException;
/**
 * @author jean
 *         测试场景：打开页面输入手机号、密码点击登录
 */
public class LogonPage extends GeneralPage{
  @FindBy(id="nickName0")
    private WebElement nickName;
    @FindBy(id="logPsw")
    private WebElement passWord;
    @FindBy(css="button.ant-btn.ant-btn-primary.login-btn")
    private WebElement loginButton;
public LogonPage(WebDriver driver) {
        super(driver);
    }
    public LogonPage nameInput() throws InterruptedException {             
     nickName.sendKeys("XXXXXXXXXXX");
        Thread.sleep(3000);
        return this;
    }
    public LogonPage passWordInput() throws InterruptedException {
        passWord.sendKeys("XXXXXXXXX");
        Thread.sleep(3000);
        return this;
    }
   public LogonPage buttonClick() throws InterruptedException {
        loginButton.click();
        Thread.sleep(3000);
        return this;
    }
}

步骤五、创建执行Test类

package tests;
import core.TestBase;
import org.testng.annotations.Test;
import pages.LogonPage;
/**
 * Created by chenxiaoqin on 9/10/17.
 */
public class LoginTest extends TestBase {
    @Test(priority = 0)
    public void login1() {

        try {
            LogonPage logonPage = new LogonPage(driver)
                    .nameInput()
                    .passWordInput()
                    .buttonClick();
        } catch (Exception e) {
            e.printStackTrace();
        }
       logger.info("测试成功");
    }
}

对于日志的打印输出、数据的存储、多个用例的顺序执行，后续将持续更新...