Page Object实例(二) 配合PageFactory使用

之前介绍了Page Object的概念及基本使用(这里), 虽然实现了页与页的分离, 测试与页的分离, 但有些时候可能只是改个别元素的id什么的, 不需要改动更多, PageFactory(Selenium wiki)就是Selenium用来帮助更简单高效实现Page Object的一个工具类. 

本文结合上篇给出使用了PageFactory和没使用的区别:

PageFactory: LoginPage.java:

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.CacheLookup;
import org.openqa.selenium.support.FindBy;
//需要导入PageFactory包
import org.openqa.selenium.support.PageFactory;
import java.util.List;
import java.util.concurrent.TimeUnit;

public class LoginPage {
    WebDriver driver;

    //关于元素的查找全部放page最前面, 后期如有UI修改很方便
    //@FindBy 是有一个特性是使用的时候才会调用实际上的findElement
    //如果确定此元素在当前页面不再改变, 可以加上@CacheLookup, 第一次找过此元素后不会再次查找
    @FindBy(id = "lbNormal")
    @CacheLookup
    private WebElement accoutLogin;
    @FindBy(tagName = "iframe")
    private List<WebElement> iframes;
    @FindBy(name = "email")
    private WebElement loginEmail;
    @FindBy(name = "password")
    private WebElement loginPassword;
    @FindBy(id = "dologin")
    private WebElement loginButton;

    public LoginPage(WebDriver driver) {
        this.driver = driver;
    }

    public HomePage login(String user, String pwd) {
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        accoutLogin.click();
        String id = iframes.get(0).getAttribute("id");
        if (id != null) {
            driver.switchTo().frame(id);
        }
        loginEmail.sendKeys(user);
        loginPassword.sendKeys(pwd);
        loginButton.click();
        driver.switchTo().defaultContent();
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);

        //使用PageFactory传递driver实例初始化@FindBy的元素并实例化下一个被跳转的页面
        HomePage homePage = new HomePage();
        PageFactory.initElements(driver, homePage);
        return homePage;
    }
}

PageFactory: LoginTest.java

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.PageFactory;
import org.testng.Assert;
import simple.com.faye.selenium.pages.HomePage;
import simple.com.faye.selenium.pages.LoginPage;
import simple.com.faye.selenium.utils.SeleniumInit;

public class LoginTest {
    public static void main(String[] args) {
        SeleniumInit seleniumInit = new SeleniumInit();
        WebDriver driver = seleniumInit.getFFDriver();
        String URL = "https://mail.163.com/";
        String user = "邮箱";
        String pwd = "密码";
        try {
            driver.get(URL);
            LoginPage loginPage = new LoginPage(driver);
            //注意要初始化LoginPage页面(HomePage不需要是因为login方法已经初始化了)
            PageFactory.initElements(driver, loginPage);
            HomePage homePage = loginPage.login(user, pwd);
            Assert.assertTrue(homePage.idExists(), "login failed");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            driver.quit();
        }
    }
}

 LoginPage.java对比:

class LoginPagePageObejectOnly {
    WebDriver driver;

    public HomePage loginOperation(String user, String pwd) {
        // 进入frame略, 没PageFactory若有改动需得进入所有使用此元素的方法修改
        WebElement loginEmail = driver.findElement(By.name("email"));
        loginEmail.sendKeys(user);

        //直接返回到新页面,不需要调用PageFactory.initElements, 但要传driver实例
        return new HomePage(driver);
    }
}

class LoginPageWithPageFactory {
    WebDriver driver;
    //若有改动仅需改动此一处则其他所有使用此元素的方法都无需修改
    //若加上@CacheLookup, 第一次找过此元素后不会再次查找
    @FindBy(name = "email")
    private WebElement loginEmail;

    public HomePage loginOperation(String user, String pwd) {
        // 进入frame略, 使用时去调用findElement
        loginEmail.sendKeys(user);

        //使用PageFactory传递driver实例初始化@FindBy的元素并实例化下一个被跳转的页面
        HomePage homePage = new HomePage();
        PageFactory.initElements(driver, homePage);
        return homePage;
    }
}

 以上代码可以看到使用区别以及使用方法, PageFactory还有@FindBys用以查找List<WebElement>, 以及类似以下方式的使用, 不过个人不推荐, 原因是此种方法仅适用于find by id 和 name, 且元素变量名需和页面元素的查找值一样, 还是一改全得改, 不划算:

public class HomePage {
    //先把元素id 或 name定义上
    private WebElement spnUid;

    public boolean idExists() {
        //使用时先执行 driver.findElement(By.id("spnUid"))找元素,
        //若没有则执行 driver.findElement(By.name("spnUid"))找元素
        //再没有则会抛 NoSuchElementException, 相较@FindBy可以使用findByElement的所有常用方式来说不够用
        System.out.println(spnUid.getText());
        return spnUid.isDisplayed();
    }
}