#PatatiumWebUi
**这是一个webui自动化测试框架，由webdriver中文社区创办人土豆(本人技术笔名)所创建,该web自动化测试框架是用java语言编写的，基于selenium webdriver 的开源自动化测试框架，该框架结合了testng,selenium,webdriver，jxl，jodd-http 等工具。该框架基于页面对象模型（POM）模型架构，实现了关键字驱动技术，数据驱动,无需掌握多少编程知识即可编写脚本，同时实现了数据与代码分离的功能：1、元素定位信息保存在对象库文件中 2、测试用例数据可以存储在excel中。从而实现，页面元素位置变化，无需改动脚本，只需修改对应的元素定位信息即可。 目前框架还不是特别完善，还需要写一些脚本实现自动化；学习该框架需要熟悉一定的HTML 和java基础，后续可以考虑自动编码的实现。** 1、jdk 1.8 2、idea/eclipse 3、maven ``` 用户名输入框 密码输入框 登录按钮 ``` 对象库文件编写后，运行/src/main/java/org/webdriver/patatiumwebui/PageObjectConfig/PageObjectAutoCode.java 文件生成对象库java代码 ``` package org.webdriver.patatiumwebui.action;import org.webdriver.patatiumwebui.pageObject.LoginPage; import org.webdriver.patatiumwebui.utils.ElementAction; import org.webdriver.patatiumwebui.utils.TestBaseCase;
import java.io.IOException;
/**
- Created by zhengshuheng on 2016/8/29 0029. */ public class LoginAction extends TestBaseCase{ public LoginAction(String Url,String UserName,String PassWord) throws IOException { //此driver变量继承自TestBase变量 LoginPage loginPage=new LoginPage(); loginPage.open(Url); System.out.println(driver.getCurrentUrl()); ElementAction action=new ElementAction(); action.clear(loginPage.密码输入框()); action.type(loginPage.用户名输入框(),UserName); action.clear(loginPage.密码输入框()); action.type(loginPage.密码输入框(),PassWord); action.click(loginPage.登录按钮()); } }
公共Action代码放在src/main/java/org/webdriver/patatiumwebui/Action 包下
<h2>3、驱动数据来源实例</h2>
1、在src/main/resources/data下创建loginData.xml文件
编写如下内容
<h2>4、测试用例编写</h2>
普通测试用例：
@Test(description="登录成功测试") @Parameters({"BaseUrl"})//读取testng.xml参数 public void login(String BaseUrl) throws IOException { //调用登录方法，需输入正确的用户名和密码 LoginAction loginAction=new LoginAction(BaseUrl+"/new/login.aspx","11111","abc123"); action.sleep(2); //设置检查点 Assertion.VerityTextPresentPrecision("jd_8456195","输入正确的用户名和密码，验证是否成功进入主页"); //设置用例断言，判断用例是否失败 Assertion.VerityError(); }
数据驱动测试用例：
//数据驱动案例--start @DataProvider(name="longinData") public Object[][] loginData() { //读取登录用例测试数据 String filePath="src/main/resources/data/loginData.xls"; //读取第一个sheet，第2行到第5行-第2到第4列之间的数据 return ExcelReadUtil.case_data_excel(0, 1, 4, 1, 3,filePath); } @Test(description="登录失败用例",dataProvider = "longinData") public void loginFail (String userName,String password,String message) throws IOException, DocumentException { //代替testng参数化的方法 String BaseUrl= XmlReadUtil.getTestngParametersValue("testng.xml","BaseUrl"); //调用登录方法 LoginAction loginAction=new LoginAction(BaseUrl+"/new/login.aspx",userName,password); action.sleep(1); //设置检查点 Assertion.VerityTextPresent(message,"验证是否出现预期的错误提示信息:"+message); //设置断言 Assertion.VerityError(); } //数据驱动案例--end
测试用例代码放在src/test/java 包下
<h2>5、testng.xml配置</h2>
testng.xml放在项目根目录下面。
<h2>6、执行用例</h2>
IDE：在IDE集成开发环境下右键testng.xml使用testng运行
Maven:执行mvn clean ;mvn test 命令
Jenkins：1、checkout 项目代码 2、指定pom.xml文件 3、执行mvn clean ;mvn test 命令
<h2>7、查看测试报告及日志文件</h2>
用例执行完毕，会自动发送邮件报告及生成测试报告文件
测试报告文件生成在项目根目录下test-out目录下report.html文件
报告展示如下：
邮件展示如下：
日志文件展示如下：
<h1>Xpath 详解：</h1>
注：可通过火狐浏览器安装,firebug,firepath插件校验xpath的正确性
先举个xpah例子://div[@id=’abc’]/form/div/input/span
//：从匹配选择的当前节点，选择文档中的节点，不考虑它的具体位置，例如：//div[@name=‘abc’]
查找页面中name属性为abc的div标签
/：从根节点选取元素，例如：/html/body/div[@id='myModalex']
可以是文档最根节点开始查找元素，也可以是配陪得节点为根节点往下找
例如：//*[@id='loginForm']/div[1]/label
@：@表示属性 属性可以用and,or运算符
例如：//label[@class='col-sm-2 control-label' and @for='userName'] 在定位中，如果一个属性还不能精确定位某个元素那么则可以再组合增加一个元素，使定位达到唯一性
Text（）：通过元素的文本值查找元素，例：//h2[text()='webdriver中文社区']
Contains();//input[contains(@id,'nt')] 模糊匹配，查找id包含nt的input标签
//h2[contains(text(),'华康移动医疗客服后台')] 查找文本值包含webdriver中文社区的元素
//灵活使用案例：
查找元素
八佰伴
嘎嘎嘎
综上xpath定位原则，元素id,name属性优先使用，其次是class等其他，1、在当前节点没有id,name等属性确定元素唯一性的时候，往上找，通过当前节点父亲，祖父，祖父的父亲，祖父的祖父等节点查找当前元素。2、一个元素属性不足够定位当前元素的时候，可以通过and运算符，组合属性来定位使之达到唯一性，尽可能的缩短xpath层级，使xpath定位更稳定。
例： 定位用户名输入框可以用//*[@id=’userName’]表示查找当前页面下，id属性为’userName’的所有元素，相当于id定位方式。*代表所有元素。  