selenium测试框架篇，页面对象和元素对象的管理

感悟时分

做自动化框架，不可避免的就是对象库。

有一个好的对象库，可以让整个测试体系：

更容易维护
大大增加代码重用
增加测试系统的稳定性
这里先了解一下我所说的对象库：



所谓的页面对象，是指每一个真是的页面是一个对象。

比如zhihu的登陆页面是一个页面对象，http://www.zhihu.com/#signin

这个页面对象主要包含一个输入邮箱的输入框（一个元素对象），一个输入密码的密码框

一个登陆框。当然，zhihu不止一个页面，有无数页面，每一个页面都可以封装为一个对象。而每个

页面的元素，也可以封装成一个个元素对象。



为什么要封装成一个个对象？

还是以这个登陆页面为例，如果有一天zhihu改版，登陆界面UI变了，（但是需要输入用户名和密码还
有登陆按钮不会消失吧）。

登陆页面的元素的位置也相应改变，如果你的测试用例没有封装过页面和元素， 每个页面都是拿webdr
iver 直接写，页面元素定位

也分布到测试用例中，这要维护起来要全部改掉测试用例。如果你封装了页面，封装了元素，再封装
一个对应的登陆Action，你的每个

测试用例是调用的login.action（）。　　这样，你只需要改变你对象库的内容就完美解决UI变化，而
不必一个个修改测试用例。

测试框架目录如下：



接下来一这个登陆为例：

首先封装一个BasePage的类，毕竟所有的页面都有共同的东西，每个页面都有元素，每个页面元素都有相应的方法

这里简单封装了几个方法，如type

1. package com.dbyl.libarary.utils;
   
2. 
   
3. import java.io.IOException;
   
4. 
   
5. import org.openqa.selenium.By;
   
6. import org.openqa.selenium.WebDriver;
   
7. import org.openqa.selenium.WebElement;
   
8. import org.openqa.selenium.interactions.Actions;
   
9. import org.openqa.selenium.support.ui.ExpectedCondition;
   
10. import org.openqa.selenium.support.ui.WebDriverWait;
    
11. 
    
12. public class BasePage {
    
13. 
    
14.     protected WebDriver driver;
    
15.     protected String[][] locatorMap;
    
16. 
    
17.     protected BasePage(WebDriver driver) throws IOException {
    
18.         this.driver = driver;
    
19.         locatorMap = ReadExcelUtil.getLocatorMap();
    
20.     }
    
21. 
    
22.     protected void type(Locator locator, String values) throws Exception {
    
23.         WebElement e = findElement(driver, locator);
    
24.         e.sendKeys(values);
    
25.     }
    
26. 
    
27.     protected void click(Locator locator) throws Exception {
    
28.         WebElement e = findElement(driver, locator);
    
29.         e.click();
    
30.     }
    
31. 
    
32.     protected void clickAndHold(Locator locator) throws IOException {
    
33.         WebElement e = findElement(driver, locator);
    
34.         Actions actions = new Actions(driver);
    
35.         actions.clickAndHold(e).perform();
    
36.     }
    
37. 
    
38.     public WebDriver getDriver() {
    
39.         return driver;
    
40.     }
    
41. 
    
42.     public void setDriver(WebDriver driver) {
    
43.         this.driver = driver;
    
44.     }
    
45. 
    
46.     public WebElement getElement(Locator locator) throws IOException {
    
47.         return getElement(this.getDriver(), locator);
    
48.     }
    
49. 
    
50.     /**
    
51.      * get by parameter
    
52.      *
    
53.      * @author Young
    
54.      * @param driver
    
55.      * @param locator
    
56.      * @return
    
57.      * @throws IOException
    
58.      */
    
59.     public WebElement getElement(WebDriver driver, Locator locator)
    
60.             throws IOException {
    
61.         locator = getLocator(locator.getElement());
    
62.         WebElement e;
    
63.         switch (locator.getBy()) {
    
64.         case xpath:
    
65.             e = driver.findElement(By.xpath(locator.getElement()));
    
66.             break;
    
67.         case id:
    
68.             e = driver.findElement(By.id(locator.getElement()));
    
69.             break;
    
70.         case name:
    
71.             e = driver.findElement(By.name(locator.getElement()));
    
72.             break;
    
73.         case cssSelector:
    
74.             e = driver.findElement(By.cssSelector(locator.getElement()));
    
75.             break;
    
76.         case className:
    
77.             e = driver.findElement(By.className(locator.getElement()));
    
78.             break;
    
79.         case tagName:
    
80.             e = driver.findElement(By.tagName(locator.getElement()));
    
81.             break;
    
82.         case linkText:
    
83.             e = driver.findElement(By.linkText(locator.getElement()));
    
84.             break;
    
85.         case partialLinkText:
    
86.             e = driver.findElement(By.partialLinkText(locator.getElement()));
    
87.             break;
    
88.         default:
    
89.             e = driver.findElement(By.id(locator.getElement()));
    
90.         }
    
91.         return e;
    
92.     }
    
93. 
    
94.     public boolean isElementPresent(WebDriver driver, Locator myLocator,
    
95.             int timeOut) throws IOException {
    
96.         final Locator locator = getLocator(myLocator.getElement());
    
97.         boolean isPresent = false;
    
98.         WebDriverWait wait = new WebDriverWait(driver, 60);
    
99.         isPresent = wait.until(new ExpectedCondition<WebElement>() {
    
100.             @Override
     
101.             public WebElement apply(WebDriver d) {
     
102.                 return findElement(d, locator);
     
103.             }
     
104.         }).isDisplayed();
     
105.         return isPresent;
     
106.     }
     
107. 
     
108.     /**
     
109.      * This Method for check isPresent Locator
     
110.      *
     
111.      * @param locator
     
112.      * @param timeOut
     
113.      * @return
     
114.      * @throws IOException
     
115.      */
     
116.     public boolean isElementPresent(Locator locator, int timeOut)
     
117.             throws IOException {
     
118.         return isElementPresent(driver,locator, timeOut);
     
119.     }
     
120. 
     
121.     /**
     
122.      *
     
123.      * @param driver
     
124.      * @param locator
     
125.      * @return
     
126.      */
     
127.     public WebElement findElement(WebDriver driver, final Locator locator) {
     
128.         WebElement element = (new WebDriverWait(driver, locator.getWaitSec()))
     
129.                 .until(new ExpectedCondition<WebElement>() {
     
130. 
     
131.                     @Override
     
132.                     public WebElement apply(WebDriver driver) {
     
133.                         try {
     
134.                             return getElement(driver, locator);
     
135.                         } catch (IOException e) {
     
136.                             // TODO Auto-generated catch block
     
137.                             return null;
     
138.                         }
     
139. 
     
140.                     }
     
141. 
     
142.                 });
     
143.         return element;
     
144. 
     
145.     }
     
146. 
     
147.     public Locator getLocator(String locatorName) throws IOException {
     
148. 
     
149.         Locator locator;
     
150.         for (int i = 0; i < locatorMap.length; i++) {
     
151.             if (locatorMap[i][0].endsWith(locatorName)) {
     
152.                 return locator = new Locator(locatorMap[i][1]);
     
153.             }
     
154.         }
     
155. 
     
156.         return locator = new Locator(locatorName);
     
157. 
     
158.     }
     
159. }

复制代码

接下来封装元素，Webdriver的元素，每个元素都有相应的定位地址（xpath路径或css或id）等待时间和定位类型，默认为By.xpath

1. package com.dbyl.libarary.utils;
   
2. 
   
3. /**
   
4. * This is for element library
   
5. *
   
6. * @author Young
   
7. *
   
8. */
   
9. public class Locator {
   
10.     private String element;
    
11. 
    
12.     private int waitSec;
    
13. 
    
14.     /**
    
15.      * create a enum variable for By
    
16.      *
    
17.      * @author Young
    
18.      *
    
19.      */
    
20.     public enum ByType {
    
21.         xpath, id, linkText, name, className, cssSelector, partialLinkText, tagName
    
22.     }
    
23. 
    
24.     private ByType byType;
    
25. 
    
26.     public Locator() {
    
27. 
    
28.     }
    
29. 
    
30.     /**
    
31.      * defaut Locator ,use Xpath
    
32.      *
    
33.      * @author Young
    
34.      * @param element
    
35.      */
    
36.     public Locator(String element) {
    
37.         this.element = element;
    
38.         this.waitSec = 3;
    
39.         this.byType = ByType.xpath;
    
40.     }
    
41. 
    
42.     public Locator(String element, int waitSec) {
    
43.         this.waitSec = waitSec;
    
44.         this.element = element;
    
45.         this.byType = ByType.xpath;
    
46.     }
    
47. 
    
48.     public Locator(String element, int waitSec, ByType byType) {
    
49.         this.waitSec = waitSec;
    
50.         this.element = element;
    
51.         this.byType = byType;
    
52.     }
    
53. 
    
54.     public String getElement() {
    
55.         return element;
    
56.     }
    
57. 
    
58.     public int getWaitSec() {
    
59.         return waitSec;
    
60.     }
    
61. 
    
62.     public ByType getBy() {
    
63.         return byType;
    
64.     }
    
65. 
    
66.     public void setBy(ByType byType) {
    
67.         this.byType = byType;
    
68.     }
    
69. 
    
70. }

复制代码

感悟时分

接下来就是登陆页面的类，这个登陆页面的元素，放在excel统一管理，要获取元素的信息，首先从excel读取。

读取excel的页面元素是使用POI开源框架

package com.dbyl.libarary.utils;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.DateUtil;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;

public class ReadExcelUtil {

static String path;

/**
* @author Young
* @return
* @throws IOException
*/
public static String[][] getLocatorMap() throws IOException {
path = "C:/Users/Young/workspace/Demo/src/com/dbyl/libarary/pageAction/UILibrary.xls";
File f1 = new File(path);
FileInputStream in = new FileInputStream(f1);
HSSFWorkbook wb = new HSSFWorkbook(new POIFSFileSystem(in));
Sheet sheet = wb.getSheetAt(0);
Row header = sheet.getRow(0);
String[][] locatorMap = new String[sheet.getLastRowNum() + 1][header
.getLastCellNum()];
for (int rownum = 0; rownum <= sheet.getLastRowNum(); rownum++) {
// for (Cell cell : row)
Row row = sheet.getRow(rownum);

if (row == null) {

continue;

}
String value;
for (int cellnum = 0; cellnum <= row.getLastCellNum(); cellnum++) {
Cell cell = row.getCell(cellnum);
if (cell == null) {
continue;
} else {
value = "";
}
switch (cell.getCellType()) {
case Cell.CELL_TYPE_STRING:
value = cell.getRichStringCellValue().getString();
break;
case Cell.CELL_TYPE_NUMERIC:
if (DateUtil.isCellDateFormatted(cell)) {
value = cell.getDateCellValue().toString();

} else {
value = Double.toString((int) cell
.getNumericCellValue());

}
break;
case Cell.CELL_TYPE_BOOLEAN:
value = Boolean.toString(cell.getBooleanCellValue());
break;
case Cell.CELL_TYPE_FORMULA:
value = cell.getCellFormula().toLowerCase();
break;
default:
value = " ";
System.out.println();
}
locatorMap[rownum][cellnum] = value;

}
}
in.close();
wb.close();

return locatorMap;
}

}

页面类

复制代码
package com.dbyl.libarary.pageAction;

import java.io.IOException;
import java.util.concurrent.TimeUnit;

import org.openqa.selenium.WebDriver;

import com.dbyl.libarary.utils.BasePage;
import com.dbyl.libarary.utils.Locator;

public class LoginPage extends BasePage {

WebDriver driver;

public WebDriver getDriver() {
return driver;
}

public LoginPage(WebDriver driver) throws IOException {
super(driver);
driver.get("http://www.zhihu.com/#signin");
}

Locator loginEmailInputBox = new Locator("loginEmailInputBox");

Locator loginPasswordInputBox = new Locator("loginPasswordInputBox");
Locator loginButton = new Locator("loginButton");
Locator profile = new Locator(
"profile");

public void typeEmailInputBox(String email) throws Exception {
type(loginEmailInputBox, email);
}

public void typePasswordInputBox(String password) throws Exception {
type(loginPasswordInputBox, password);
}

public void clickOnLoginButton() throws Exception {
click(loginButton);
}

public boolean isPrestentProfile() throws IOException {
return isElementPresent(profile, 20);

}

public void waitForPageLoad() {
super.getDriver().manage().timeouts()
.pageLoadTimeout(30, TimeUnit.SECONDS);
}


}

复制代码
接下来就是登陆的Action

复制代码
package com.dbyl.libarary.action;

import org.openqa.selenium.WebDriver;
import org.testng.Assert;

import com.dbyl.libarary.pageAction.HomePage;
import com.dbyl.libarary.pageAction.LoginPage;

public class CommonLogin {

private static WebDriver driver;

public static WebDriver getDriver() {
return driver;
}

static LoginPage loginPage;

public static HomePage login(String email, String password)
throws Exception {
loginPage = new LoginPage(getDriver());
loginPage.waitForPageLoad();
loginPage.typeEmailInputBox(email);
loginPage.typePasswordInputBox(password);
loginPage.clickOnLoginButton();
Assert.assertTrue(loginPage.isPrestentProfile(), "login failed");
return new HomePage(getDriver());
}

public static HomePage login() throws Exception {
return CommonLogin.login("seleniumcookies@126.com", "cookies123");
}

public static void setDriver(WebDriver driver) {
CommonLogin.driver = driver;
}

}

复制代码
至此为止，已经封装完毕

接下来就能在测试用例直接调用者

package com.dbyl.tests;

import org.openqa.selenium.WebDriver;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;

import com.dbyl.libarary.action.ViewHomePage;
import com.dbyl.libarary.utils.DriverFactory;
import com.dbyl.libarary.utils.UITest;

public class loginTest extends UITest{


WebDriver driver=DriverFactory.getChromeDriver();
@BeforeMethod(alwaysRun=true)
public void init()
{
super.init(driver);
ViewHomePage.setDriver(driver);
//CommonLogin.setDriver(driver);
}
@Test(groups="loginTest")
public void loginByUerName() throws Exception
{
//CommonLogin.login("seleniumcookies@126.com","cookies123");
ViewHomePage.viewMyProfile();
}

@AfterMethod(alwaysRun=true)
public void stop() {
super.stop();
}