自动化设计模式 POM (Page Object Model)

本文将使用Maven + TestNG + Java + Selenium 的项目来作为例子来讲解如何实现POM。

1.POM是什么

Page Object Model 是一种自动化测试的设计模式，为Web UI元素创建Object Repository。它的优点就是减少了代码的重复，提高了测试维护。

一般情况下，POM的项目需要包括3部分：

• PageModle：每个页面都应该有自己的的PageClass文件，这个PageClass将标识该页面的Web元素，并包含对这些Web元素执行操作的方法
• TestCase：测试用例管理部分，一个功能点可以对应一个或者多个case，尽可能的提高覆盖率
• Utilities：可以包含一些报告等内容

按照上边的解释，我们可以把项目分为三部分，在项目中创建三个packages： pages，tests，utilities，如下图所示：

2.使用POM的好处

1. POM模式使得测试用例和页面元素操作分开，这样可以使我们的代码更干净，更容易理解，且更容易维护；
2. 对象存储库独立于测试用例，因此我们可以使用不同的工具为不同的目的使用相同的对象存储库。 例如，我们可以将POM与用于功能测试的Test NG/JUnit集成，同时与用于验收测试的JBehave/Cucumber集成；
3. 测试用例更加简短，而且可重用页面元素和方法，代码变得更少，更简洁；
4. 方法使用更真实的名称，这些名称可以很容易地与UI中发生的操作映射。例如：如果单击按钮后，回返回主页面，方法名称将类似于gotoHomePage()，易于理解。

3.如何创建一个POM项目

接下来我们通过一个简单的测试用例(登录账户的验证)来进行扩展，一步一步演变成POM的模式的项目。

最原始的代码如下：

    @Test
    public void ValidPasswordLogin(){

        //1. Open browser and open test url
        System.setProperty("webdriver.chrome.driver", "Driver/chromedriver");
        WebDriver driver;
        driver = new ChromeDriver();
        driver.manage().window().maximize();
        driver.get("http://jinshuju.com");

        //2. Test part

            //2. 1 Home page: Click login button go to login page
        driver.findElement(By.cssSelector(".login-link")).click();

            //2. 2 Login page: Input username and password to login
        driver.findElement(By.id("auth_key")).sendKeys("131****8959");
        driver.findElement(By.cssSelector(".gd-btn.gd-btn-primary-solid")).click();
        driver.findElement(By.id("password")).sendKeys("Abcdef");
        driver.findElement(By.cssSelector(".gd-btn.gd-btn-primary-solid")).click();
        Assert.assertEquals(driver.findElement(By.className("validate-invalid")).getText(),"密码错误，请输入正确的密码（还剩余4次）");

        //3. Quite browser
        driver.quit();
    }

1. 首先，通过上述代码，可以看到一些common的方法例如：sendKeys， click， getText， assert，几乎在每个页面，都会频繁使用这些方法。如果单纯的使用Selenium自己的这些方法，可能会遇到一些问题，例如因为加载慢某个按钮还没有加载完成，但是已经触发了点击事件，此时会因为找不到按钮而失败，等等很多类似的问题。基于这些问题，我们首先可以对selenium这些最基本的方法进行重写。在pages package下边创建一个BasePage.java文件来重写这些方法，之后所有的页面都继承于BasePage类。

BasePage.java

package pages;
import org.junit.Assert;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;

public class BasePage {

    public WebDriver driver;
    public WebDriverWait wait;

    //Constructor
    public BasePage (WebDriver driver){
        this.driver = driver;
        wait = new WebDriverWait(driver,20);
    }

    //Wait
    public void waitVisibility(By elementBy) {
        wait.until(ExpectedConditions.visibilityOfAllElementsLocatedBy(elementBy));
    }

    //Click
    public void click(By elementBy){
        waitVisibility(elementBy);
        driver.findElement(elementBy).click();
    }

    //Write Text
    public void writeText (By elementBy, String text) {
        waitVisibility(elementBy);
        driver.findElement(elementBy).sendKeys(text);
    }

    //Read Text
    public String readText (By elementBy) {
        waitVisibility(elementBy);
        return driver.findElement(elementBy).getText();
    }

    //Assert
    public void assertEquals (By elementBy, String expectedText) {
        waitVisibility(elementBy);
        Assert.assertEquals(readText(elementBy), expectedText);
    }
}

2. 接下来，分析整个代码块，可以分为三部分：

1. 在执行测试步骤之前，我们需要先打开浏览器，输入测试的地址；
2. 执行测试用例；
3. 执行完测试用例之后，关闭浏览器。

• 第1和3这两部分：
  分析： 因为每条测试用例都会打开浏览器和关闭浏览器，所以我们可以将他们放在一个BaseTest类中，使用@BeforeMethod和@AfterMethod注解(这个是TestNG的注解，如果不知道请学习TestNG的注解)，在每一个测试方法执行之前都会先执行@BeforeMethod，在每一个测试方法执行之后都会执行@AfterMethod。
  做法： 在tests的Package下边创建一个BaseTest.java类，将1和3 两部分写在这个BaseTest类中：

BaseTest.java

package tests;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.annotations.*;

public class BaseTest {
    public WebDriver driver;

    @BeforeMethod
    public void setUp() {
        //1. Open browser and open test url
        System.setProperty("webdriver.chrome.driver", "Driver/chromedriver");
        driver = new ChromeDriver();
        driver.manage().window().maximize();
        driver.get("http://jinshuju.com");
    }

    @AfterMethod
    public void quiteBrowser() {
        //3. Quite browser
        driver.quit();
    }
}

• 第2部分
  分析： 第2部分是测试代码部分，可以看到 1). 要对两个页面(Home page 和Login page)进行操作；2). 每个页面都有各自的元素和方法。所以我们可以按照页面进行拆分，每个页面为一个类，每个页面的类中包含对应页面的元素部分和方法部分，这样就比较清晰，而且当添加新的Case的时候也可以去复用现有的方法。
  做法： 在pages这个package下边创建一个HomePage.java 类和一个LoginPage.java 类，将各自页面的方法也在各自页面中。 然后在每个page类中分为定位元素和方法两部分：

HomePage.java

package pages;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;

public class HomePage extends BasePage{

    //Constructor
    public HomePage(WebDriver driver) {
        super(driver);
    }

    //Elements
    By loginButton = By.cssSelector(".btn-outline");

    //Actions
    public void clickLogin(){
        click(loginButton);
    }
}

LoginPage.java

package pages;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.testng.Assert;

public class LoginPage extends BasePage{

    //Constructor
    public LoginPage(WebDriver driver) {
        super(driver);
    }

    //Elements
    By userNameInput = By.id("auth_key");
    By loginButton = By.cssSelector(".btn-lg");
    By passwordInput = By.id("password");
    By errorMessage = By.cssSelector(".alert");

    //Actions
    public void inputUsernamePwd(String userName, String password){
        writeText(userNameInput,userName);
        writeText(passwordInput,password);
        click(loginButton);
    }

    public void verifyErrorMessage(String expectedErrorMessage){
        Assert.assertEquals(readText(errorMessage),expectedErrorMessage);
    }
}

3. 此时，已经给每个页面创建了自己的类，而且每个页面类包含自己的元素定位和方法。接下来，需要创建测试用例来调用每个页面的方法，在tests package 下创建 loginTests.java 类，内容如下。注释部分是之前的代码，已经被新的代码代替。这样测试用例部分就很清晰，很简洁。
   loginTests.java

package tests;
import org.openqa.selenium.WebDriver;
import org.testng.annotations.Test;
import pages.HomePage;
import pages.LoginPage;

public class loginTests extends BaseTest{

    public static WebDriver driver;
    public static LoginPage loginPage = new LoginPage(driver);
    public static HomePage homePage = new HomePage(driver);

    @Test
    public void InvalidPasswordLogin(){
        
        //driver.findElement(By.cssSelector(".btn-outline")).click();
        homePage.clickLogin();
        
        //driver.findElement(By.id("auth_key")).sendKeys("131****8959");
        //driver.findElement(By.id("password")).sendKeys("Abcdef");
        //driver.findElement(By.cssSelector(".btn-lg")).click();
        loginPage.inputUsernamePwd("131****8959","Abcdef");
        
        //Assert.assertEquals(driver.findElement(By.cssSelector(".alert")).getText(),"账号密码不正确");
        loginPage.verifyErrorMessage("账号密码不正确");
    }
}

4. 分析结束后，我们的代码结构如下图：