关键字驱动框架入门教程-10-异常处理

什么是异常
 
       一个异常其实就是一个事件，特点就是在程序执行过程中出现的，会打断正常的程序设计流程。简单来说，在自动化测试中，任何一个错误，导致你执行用例失败，这个就是一个异常。
 
错误和异常的区别
 
      一个错误，一般是验证的问题，是无法通过try catch捕获的。异常是可以想象得到的报错，可以手动捕获并处理。一行代码如果发生错误，例如不符合语法规范，那么根本通不过编译，但是一个异常更多是由于没有考虑到特殊场景，而没有去处理。
 
什么是异常处理
       异常处理首先需要通过预先想到可能存在的错误，通过代码块语句，处理这个异常对象，并帮助程序开发人员对这个异常进行一些改变处理，目的是不会中断程序正常运行。
 
为什么异常处理非常重要
1) 试想一下这个场景，当你得到一个异常而且你想打印出一些自定义的消息，所以别人通过这个自定义消息内容，明白这个是什么意思。
2) 有些时候，我们需要得到某些特定异常的步骤，方便测试人员多测试这块。
3)实际一些，我们在selenium自动化测试中，你可能想处理以下异常：
ElementNotSelectableException,

ElementNotVisibleException,

NoSuchElementException。
 
Selenium中不同的异常
下面列举一些常见的异常，这些异常在selenium自动化测试中可能遇到。
1.NoSuchElementException: 意思就是当前定位元素方法无法找到元素，很有可能元素定位表达式写错了
2.StaleElementReferenceException: 意思就是这个元素不在当前DOM页面显示
3.TimeoutException：意思就是执行失败，因为在足够多默认时间内没有结束这个操作
4.ElementNotVisibleException: 意思就是，尽管元素在当前DOM页面存在，但是它是不可见的，所以无法产生交互。
5.ElementNotSelectableException:意思就是，可能元素不可用，所以无法选择到。
 
 
如何处理异常
 
在Java中使用try-catch语句进行异常处理。语法格式如下：
Try{
         //一些代码
}catch(Exception e) {
         //处理异常的代码块
}
 
多个Catch 语句块：一个try代码块可以跟着多个catch代码块。 try{   //Somecode}catch(ExceptionType1e1){    //Codefor Handling the Exception 1}catch(ExceptionType2e2){    //Codefor Handling the Exception 2  }
 
       原则上是没有catch语句块个数的限定，上面举例写了两个，实际可以写多个。出现异常就会从第一个catch里面去匹配，如果匹配到就走第一个catch的异常处理代码，如果没有，接着匹配第二个catch里面的异常名称，以此类推。
 
 
Throw：有些时候，我们希望在代码中显示生成异常。举例，在Selenium自动化测试框架中，我们很多时候都是打印自己写的log，一旦我们捕获到异常，我们需要把这个异常抛出给系统，这样测试用例才会终止执行。Throw关键字用于运行时抛出异常并处理它。
 
Throws：如果我们在抛出一个异常而且没有处理这个异常，那么我们需要使用throws关键字。掉调用程序知道这个方法可能抛出异常，但是不会处理。
 
Finally：Finally关键字用来创建代码块去处理一个分支流程，这个finally代码块永远会执行，不管有没有异常发生。
 
在框架中处理异常
 
       通过前面文章介绍，我们已经知道，我们在driverscript.java这个类中写了一个嵌套for循环，外层for循环来控制用例，内层for循环来控制每个用例下的测试步骤。那么我们怎么在这个执行过程中处理异常呢。我们是这样想的，如果在外层循环遇到执行测试用例失败，那么就在这个时刻处理异常，如果内层循环执行具体某一个步骤出现失败，也处理异常。所以，我们需要定义一个标记，类型是布尔型，如果标记为true，测试用例和测试步骤继续执行，如果遇到标记为false，那么就停下来，不继续执行后面的用例。
 
例如我在openBrowser()这个方法，这样去写异常处理。
public static void openBrowser(String object) {

// 这里，我们暂时都写死用chrome来进行自动化测试
try{
Log.info("启动chrome浏览器。");
System.setProperty("webdriver.chrome.driver",".\\libs\\chromedriver.exe");
driver = new ChromeDriver();
}catch(Exception e){
Log.info("无法启动浏览器 --- " + e.getMessage());
DriverScript.bResult = false;
}
}
       上面意思就是，一般来说bResult这个变量是true，测试用例正常被执行，如果出现异常，那么就从true改成false，这样下面其他用例看到这个标记变了就不会继续执行。
ActionsKeywords.java更新代码如下
package config;

import executionEngine.DriverScript;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import utility.Log;

import static executionEngine.DriverScript.OR;

import java.util.concurrent.TimeUnit;

public class ActionsKeywords {

public static WebDriver driver;

public static void openBrowser(String object) {

// 这里，我们暂时都写死用chrome来进行自动化测试
try{
Log.info("启动chrome浏览器。");
System.setProperty("webdriver.chrome.driver",".\\libs\\chromedriver.exe");
driver = new ChromeDriver();
}catch(Exception e){
Log.info("无法启动浏览器 --- " + e.getMessage());
DriverScript.bResult = false;
}
}

public static void openUrl(String object) {

try{
Log.info("打开测试环境地址");
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
driver.manage().window().maximize();
driver.get(Constants.URL);
}catch(Exception e){
Log.info("无法打开测试环境地址 --- " + e.getMessage());
DriverScript.bResult = false;
}

}

public static void click(String object) {
try{
Log.info("点击元素： "+ object);
driver.findElement(By.xpath(OR.getProperty(object))).click();
}catch(Exception e){
Log.error("无法点击元素--- " + e.getMessage());
DriverScript.bResult = false;
}
}

public static void inputUsername(String object){
try{
Log.info("在用户名输入框输入文字");
driver.findElement(By.xpath(OR.getProperty(object))).sendKeys(Constants.UserName);
}catch(Exception e){
Log.error("无法输入用户名 --- " + e.getMessage());
DriverScript.bResult = false;
}
}

public static void inputPassword(String object){
try{
Log.info("密码框输入...");
driver.findElement(By.xpath(OR.getProperty(object))).sendKeys(Constants.Password);
}catch(Exception e){
Log.error("密码框无法输入--- " + e.getMessage());
DriverScript.bResult = false;
}
}

public static void waitFor(String object) throws Exception{
try{
Log.info("等待五秒");
Thread.sleep(5000);
}catch(Exception e){
Log.error("无法等待 --- " + e.getMessage());
DriverScript.bResult = false;
}
}

public static void closeBrowser(String object){
try{
Log.info("关闭并退出浏览器");
driver.quit();
}catch(Exception e){
Log.error("无法关闭浏览器--- " + e.getMessage());
DriverScript.bResult = false;
}
}

}

ExeclUtils.java更新代码如下
package utility;

import config.Constants;
import executionEngine.DriverScript;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileInputStream;

public class ExcelUtils {

private static XSSFSheet ExcelWSheet;
private static XSSFWorkbook ExcelWBook;
private static XSSFCell Cell;

// 设置Excel文件路径，方便读取到文件
public static void setExcelFile(String Path) throws Exception {
try {
FileInputStream ExcelFile = new FileInputStream(Path);
ExcelWBook = new XSSFWorkbook(ExcelFile);
} catch (Exception e){
Log.error("Class Utils | Method setExcelFile | Exception desc : "+e.getMessage());
DriverScript.bResult = false;
}
}

// 读取Excel文件单元格数据
// 新增sheetname参数，这样就可以去读取Test Steps和Test Cases两个工作表的单元格数据
public static String getCellData(int RowNum, int ColNum, String SheetName ) throws Exception{
try{
ExcelWSheet = ExcelWBook.getSheet(SheetName);
Cell = ExcelWSheet.getRow(RowNum).getCell(ColNum);
String CellData = Cell.getStringCellValue();
return CellData;
}catch (Exception e){
Log.error("Class Utils | Method getCellData | Exception desc : "+e.getMessage());
DriverScript.bResult = false;
return"";
}
}

//得到一共多少行数据
public static int getRowCount(String SheetName){
int iNumber=0;
try {
ExcelWSheet = ExcelWBook.getSheet(SheetName);
iNumber=ExcelWSheet.getLastRowNum()+1;
} catch (Exception e){
Log.error("Class Utils | Method getRowCount | Exception desc : "+e.getMessage());
DriverScript.bResult = false;
}
return iNumber;
}

//得到测试用例的行号
public static int getRowContains(String sTestCaseName, int colNum,String SheetName) throws Exception{
int iRowNum=0;
try {
//ExcelWSheet = ExcelWBook.getSheet(SheetName);
int rowCount = ExcelUtils.getRowCount(SheetName);
for (; iRowNum<rowCount; iRowNum++){
if (ExcelUtils.getCellData(iRowNum,colNum,SheetName).equalsIgnoreCase(sTestCaseName)){
break;
}
}
} catch (Exception e){
Log.error("Class Utils | Method getRowContains | Exception desc : "+e.getMessage());
DriverScript.bResult = false;
}
return iRowNum;
}

//计算一个测试用例有多少个步骤
public static int getTestStepsCount(String SheetName, String sTestCaseID, int iTestCaseStart) throws Exception{
try {
for(int i=iTestCaseStart;i<=ExcelUtils.getRowCount(SheetName);i++){
if(!sTestCaseID.equals(ExcelUtils.getCellData(i, Constants.Col_TestCaseID, SheetName))){
int number = i;
return number;
}
}
ExcelWSheet = ExcelWBook.getSheet(SheetName);
int number=ExcelWSheet.getLastRowNum()+1;
return number;
} catch (Exception e){
Log.error("Class Utils | Method getRowContains | Exception desc : "+e.getMessage());
DriverScript.bResult = false;
return 0;
}
}

}

DriverScript.java代码如下
package executionEngine;
import com.sun.xml.internal.bind.v2.runtime.reflect.opt.Const;
import config.ActionsKeywords;
import config.Constants;
import org.apache.log4j.xml.DOMConfigurator;
import utility.ExcelUtils;

import java.io.FileInputStream;
import java.lang.reflect.Method;
import java.util.Properties;

/**
* create by Anthony on 2018/1/30
*/
public class DriverScript {

// 声明一个public static的类对象，所以我们可以在main方法范围之外去使用。
public static ActionsKeywords actionsKeywords;
public static String sActionKeyword;
// 下面是返回类型是方法，这里用到反射类
public static Method method[];
// 新建一个Properties对象
public static Properties OR;
public static String sPageObject;

public static int iTestStep;
public static int iTestLastStep;
public static String sTestCaseID;
public static String sRunMode;
public static boolean bResult;

// 这里我们初始化'ActionsKeywords'类的一个对象
public DriverScript() throws NoSuchMethodException, SecurityException{
actionsKeywords = new ActionsKeywords();
method = actionsKeywords.getClass().getMethods();
}

public static void main(String[] args) throws Exception {
// 这样一定要加，否则报log4j初始化的警告
DOMConfigurator.configure("log4j.xml");

ExcelUtils.setExcelFile(Constants.Path_TestData);

// 创建一个文件输入流对象，参数来源外部OR.txt文件
FileInputStream fs = new FileInputStream(Constants.Path_OR);
// 创建一个Properties对象
OR = new Properties(System.getProperties());
// 加载全部对象仓库文件
OR.load(fs);
// 执行用例
DriverScript startEngine = new DriverScript();
startEngine.execute_TestCase();
}

private void execute_TestCase() throws Exception {
//获取测试用例数量
int iTotalTestCases = ExcelUtils.getRowCount(Constants.Sheet_TestCases);
//外层for循环，有多少个测试用例就执行多少次循环
for(int iTestcase=1;iTestcase<=iTotalTestCases;iTestcase++){
//从Test Case表获取测试ID
sTestCaseID = ExcelUtils.getCellData(iTestcase, Constants.Col_TestCaseID, Constants.Sheet_TestCases);
//获取当前测试用例的Run Mode的值
sRunMode = ExcelUtils.getCellData(iTestcase, Constants.Col_RunMode,Constants.Sheet_TestCases);
// Run Mode的值控制用例是否被执行
if (sRunMode.equals("Yes")){
// 只有当Run Mode的单元格数据是Yes，下面代码才会被执行
iTestStep = ExcelUtils.getRowContains(sTestCaseID, Constants.Col_TestCaseID, Constants.Sheet_TestSteps);
iTestLastStep = ExcelUtils.getTestStepsCount(Constants.Sheet_TestSteps, sTestCaseID, iTestStep);

//下面这个for循环的次数就等于测试用例的步骤数
for (;iTestStep <= iTestLastStep;iTestStep++){
sActionKeyword = ExcelUtils.getCellData(iTestStep, Constants.Col_ActionKeyword,Constants.Sheet_TestSteps);
sPageObject = ExcelUtils.getCellData(iTestStep, Constants.Col_PageObject, Constants.Sheet_TestSteps);
execute_Actions();
}
}
}
}

private static void execute_Actions() throws Exception {

for(int i=0;i<method.length;i++){
if(method[i].getName().equals(sActionKeyword)){
method[i].invoke(actionsKeywords,sPageObject);
break;
}
}
}

}
       前面几篇提到的用户名和密码输入报错这块，这里把关键字方法调整了下，而且excel的action_keyword这列也调整了，两个地方名称保持一样。



本篇能完整运行的代码已经上传百度云，请点击这里,进去找到第十篇的压缩文档。