前言
前面介紹了為什么要使用監(jiān)聽器和testng中監(jiān)聽器的本質(zhì)，那在實際的接口自動化或者ui自動化中testng的監(jiān)聽器究竟能幫我們干嘛呢？？？一起來看看把~
一，用例失敗重試
在實際的接口自動化過程中，有時候會面臨調(diào)用服務(wù)時，有部分接口偶爾不穩(wěn)定或者超時的情況，但第二次運行又正常，每次接口失敗都需要花費時間排查，但實際沒有問題，為了排除不穩(wěn)定帶來的干擾，節(jié)約排查維護時間，那怎讓用例鏈接超時后自動重試呢？
那就要用到TestNG監(jiān)聽器中的IRetryAnalyzer接口了，創(chuàng)建一個TestRetry.class，代碼很簡單，如下：
package api.listener;
import api.exception.ErrorRespStatusException;
import org.testng.IRetryAnalyzer;
import org.testng.ITestResult;
public class TestRetry implements IRetryAnalyzer {
private static int retryCount = 1;
private static int maxRetryCount = 3;//最大重試次數(shù)
@Override
public boolean retry(ITestResult iTestResult) {
if(retryCount<maxRetryCount && iTestResult.getThrowable()instanceof java.net.ConnectException){
//判斷用例執(zhí)行中拋出的異常如果屬于鏈接超時異常的子類，就重試三次；此處判斷條件可根據(jù)自身需求來設(shè)定重試的條件
retryCount++;
return true;
}
return false;
}
}
想要使用失敗重試的功能也很簡單，只需要在Annotation里面加上retryAnalyzer屬性即可，此處寫一個測試類，用restassured寫兩個test分別調(diào)用谷歌和百度，如下
package Testcase.example;
import api.listener.TestRetry;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;
import static io.restassured.RestAssured.given;
import static org.hamcrest.core.IsEqual.equalTo;
public class googletest {
@BeforeTest
public void bfTest() {
System.out.println("TestNGHelloWorld1 beforTest!");
}
@Test(retryAnalyzer = TestRetry.class)//自動重試retryAnalyzer屬性
public void googletest() {
given().log().all()
.queryParam("wd", "mp3")
.when()
.get("https://www.google.com.hk/")//訪問谷歌，超時用例
.then()
.log().all()
.statusCode(200)
.body("html.head.title", equalTo("谷歌搜索"));
}
@Test(retryAnalyzer = TestRetry.class)//自動重試retryAnalyzer屬性
public void baidu(){
given().log().all()
.queryParam("wd", "mp3")
.when()
.get("http://www.baidu.com/s")//訪問百度，不超時用例
.then()
.log().all()
.statusCode(200)
.body("html.head.title", equalTo("mp3_百度搜索"));
}
@AfterTest
public void AfTest() {
System.out.println("TestNGHelloWorld1 AfterTest!");
}
}
運行測試類，結(jié)果如下：
image.png
由圖可見，googletest在鏈接超時后，自動重試了三次，雖然第三次也鏈接超時了，但達(dá)到了我們希望用例連接超時后自動重試三次的機制；
*可根據(jù)自身項目特點去定義重試的條件（不一定是連接超時），而且在不需要自動重試的用例，則不使用retryAnalyzer屬性，可以很方便自由的使用重試機制；
二，失敗自動截圖
當(dāng)我們在組織appium，selenium等UI自動化的測試用例的時候，經(jīng)常在測試用例失敗時，需要對失敗情況進行截圖保存，方便后面去定位和排查；
此處的是繼承TestNG監(jiān)聽器中的TestListenerAdapter對象了，由于父類已經(jīng)實現(xiàn)了很多方法，當(dāng)我們需要定制時，只需要重寫父類的該方法就可以了；如下：
package api.listener;
import org.testng.ITestContext;
import org.testng.ITestResult;
import org.testng.TestListenerAdapter;
import lombok.extern.slf4j.Slf4j;
import java.io.File;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
@Slf4j
public class TestListener extends TestListenerAdapter {
@Override
public void onTestFailure(ITestResult tr) {
super.onTestFailure(tr);//用例失敗時
log.info(tr.getName() + " Failure");
getScreen();//調(diào)用自動截圖的方法，一般已封裝好的截圖方法，以appium為例
}
@Override
public void onTestSkipped(ITestResult tr) {
super.onTestSkipped(tr);//用例跳過時
log.info(tr.getName() + " Skipped");
}
@Override
public void onTestSuccess(ITestResult tr) {
super.onTestSuccess(tr);//用例成功時
log.info(tr.getName() + " Success");
}
@Override
public void onTestStart(ITestResult tr) {
super.onTestStart(tr);
log.info(tr.getName() + " Start");
}
@Override
public void onFinish(ITestContext testContext) {
super.onFinish(testContext);
}
private void getScreen(ITestResult tr) {
SimpleDateFormat formatter = new SimpleDateFormat("yyyy_MM_dd_HH_mm_ss");
String mDateTime = formatter.format(new Date());
String fileName = mDateTime + "_" + tr.getName();
String filePath =base.getScreenshotAs(fileName);
Reporter.setCurrentTestResult(tr);
Reporter.log(filePath);
//這里實現(xiàn)把圖片鏈接直接輸出到結(jié)果文件中，通過郵件發(fā)送結(jié)果則可以直接顯示圖片
Reporter.log("<img src=\"../" + filePath + "\"/>");
}
封裝的截圖方法如下：
public class snkrs{
private static AndroidDriver<MobileElement> driver;
public static void startApp() throws MalformedURLException {
DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("platformName", "Android");
desiredCapabilities.setCapability("platformVersion", "6.0");
desiredCapabilities.setCapability("deviceName", "192.168.111.101:5555");
desiredCapabilities.setCapability("noReset", true);
desiredCapabilities.setCapability("app", "D:\\apk\\base.apk");
desiredCapabilities.setCapability("unicodeKeyboard", "True");//中文鍵盤輸入
desiredCapabilities.setCapability("resetKeyboard", "True");//重置鍵盤
desiredCapabilities.setCapability("autoAcceptAlerts", true);// 自動接受提示信息
//設(shè)置瀏覽器類型，如果為空，建議取用appium中設(shè)定的瀏覽器
desiredCapabilities.setCapability(CapabilityType.BROWSER_NAME, "Firefox");
URL remoteUrl = new URL("http://localhost:4723/wd/hub");
driver = new AndroidDriver<MobileElement>(remoteUrl, desiredCapabilities);
driver.manage().timeouts().implicitlyWait(40, TimeUnit.SECONDS); //超時設(shè)置
return driver;
}
public static String getScreen() {
startApp();
String fileRoute = "D:\\apk\\snkrs\\";
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH mm ss");
String picname = fileRoute + df.format(new Date()).toString() + ".png";
File screen = driver.getScreenshotAs(OutputType.FILE);
System.out.println(picname);
File screenFile = new File(picname);
try {
FileUtils.copyFile(screen, screenFile);
String time = df.format(new Date()).toString();
System.out.println("當(dāng)前時間" + time);
return time;
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
三，生成自定義測試報告
testng是有自帶的測試報告的，但是樣式很簡陋，展示的信息也不多，并不利于我們?nèi)ズ笃诙ㄎ缓团挪閱栴}，所以根據(jù)自身項目的需求去自定義測試報告就顯得很有必要了（ps看到好看的報告心情也會變好啊）
此處的就要去實現(xiàn)TestNG監(jiān)聽器中的IReporter接口了，并且根據(jù)自身需求去實現(xiàn)其generateReport（）方法；如下：
package api.listeners;
import api.utils.ReportUtil;
import com.aventstack.extentreports.ExtentReports;
import com.aventstack.extentreports.ExtentTest;
import com.aventstack.extentreports.ResourceCDN;
import com.aventstack.extentreports.Status;
import com.aventstack.extentreports.model.Log;
import com.aventstack.extentreports.model.TestAttribute;
import com.aventstack.extentreports.reporter.ExtentHtmlReporter;
import com.aventstack.extentreports.reporter.configuration.ChartLocation;
import com.aventstack.extentreports.reporter.configuration.Theme;
import org.testng.*;
import org.testng.xml.XmlSuite;
import java.io.File;
import java.util.*;
public class ExtentTestNGIReporterListener implements IReporter {
//生成的路徑以及文件名
private static final String OUTPUT_FOLDER = "test-output/";
private static final String FILE_NAME = "index.html";
private ExtentReports extent;
@Override
public void generateReport(List<XmlSuite> xmlSuites, List<ISuite> suites, String outputDirectory) {
init();
boolean createSuiteNode = false;
if(suites.size()>1){
createSuiteNode=true;
}
for (ISuite suite : suites) {
Map<String, ISuiteResult> result = suite.getResults();
//如果suite里面沒有任何用例，直接跳過，不在報告里生成
if(result.size()==0){
continue;
}
//統(tǒng)計suite下的成功、失敗、跳過的總用例數(shù)
int suiteFailSize=0;
int suitePassSize=0;
int suiteSkipSize=0;
ExtentTest suiteTest=null;
//存在多個suite的情況下，在報告中將同一個一個suite的測試結(jié)果歸為一類，創(chuàng)建一級節(jié)點。
if(createSuiteNode){
suiteTest = extent.createTest(suite.getName()).assignCategory(suite.getName());
}
boolean createSuiteResultNode = false;
if(result.size()>1){
createSuiteResultNode=true;
}
Date suiteStartTime = null,suiteEndTime=new Date();
for (ISuiteResult r : result.values()) {
ExtentTest resultNode;
ITestContext context = r.getTestContext();
if(createSuiteResultNode){
//沒有創(chuàng)建suite的情況下，將在SuiteResult的創(chuàng)建為一級節(jié)點，否則創(chuàng)建為suite的一個子節(jié)點。
if( null == suiteTest){
resultNode = extent.createTest(context.getName());
}else{
resultNode = suiteTest.createNode(context.getName());
}
}else{
resultNode = suiteTest;
}
if(resultNode != null){
resultNode.assignCategory(suite.getName(),context.getName());
if(suiteStartTime == null){
suiteStartTime = context.getStartDate();
}
suiteEndTime = context.getEndDate();
resultNode.getModel().setStartTime(context.getStartDate());
resultNode.getModel().setEndTime(context.getEndDate());
//統(tǒng)計SuiteResult下的數(shù)據(jù)
int passSize = context.getPassedTests().size();
int failSize = context.getFailedTests().size();
int skipSize = context.getSkippedTests().size();
suitePassSize += passSize;
suiteFailSize += failSize;
suiteSkipSize += skipSize;
if(failSize>0){
resultNode.getModel().setStatus(Status.FAIL);
}
resultNode.getModel().setDescription(String.format("Pass: %s ; Fail: %s ; Skip: %s ;",passSize,failSize,skipSize));
}
buildTestNodes(resultNode,context.getFailedTests(), Status.FAIL);
buildTestNodes(resultNode,context.getSkippedTests(), Status.SKIP);
buildTestNodes(resultNode,context.getPassedTests(), Status.PASS);
}
if(suiteTest!= null){
suiteTest.getModel().setDescription(String.format("Pass: %s ; Fail: %s ; Skip: %s ;",suitePassSize,suiteFailSize,suiteSkipSize));
suiteTest.getModel().setStartTime(suiteStartTime==null?new Date():suiteStartTime);
suiteTest.getModel().setEndTime(suiteEndTime);
if(suiteFailSize>0){
suiteTest.getModel().setStatus(Status.FAIL);
}
}
}
extent.flush();
}
private void init() {
//文件夾不存在的話進行創(chuàng)建
File reportDir= new File(OUTPUT_FOLDER);
if(!reportDir.exists()&& !reportDir .isDirectory()){
reportDir.mkdir();
}
ExtentHtmlReporter htmlReporter = new ExtentHtmlReporter(OUTPUT_FOLDER + FILE_NAME);
htmlReporter.config().setDocumentTitle(ReportUtil.getReportName());
htmlReporter.config().setReportName(ReportUtil.getReportName());
htmlReporter.config().setChartVisibilityOnOpen(true);
htmlReporter.config().setTestViewChartLocation(ChartLocation.TOP);
htmlReporter.config().setTheme(Theme.STANDARD);
//設(shè)置點擊效果：.node.level-1 ul{ display:none;} .node.level-1.active ul{display:block;}
//設(shè)置系統(tǒng)信息樣式：.card-panel.environment th:first-child{ width:30%;}
htmlReporter.config().setCSS(".node.level-1 ul{ display:none;} .node.level-1.active ul{display:block;} .card-panel.environment th:first-child{ width:30%;}");
// 移除按鍵監(jiān)聽事件
htmlReporter.config().setJS("$(window).off(\"keydown\");");
//設(shè)置靜態(tài)文件的DNS 如果cdn.rawgit.com訪問不了，可以設(shè)置為：ResourceCDN.EXTENTREPORTS 或者ResourceCDN.GITHUB
htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
extent = new ExtentReports();
extent.attachReporter(htmlReporter);
extent.setReportUsesManualConfiguration(true);
// 設(shè)置系統(tǒng)信息
Properties properties = System.getProperties();
extent.setSystemInfo("os.name",properties.getProperty("os.name","未知"));
extent.setSystemInfo("os.arch",properties.getProperty("os.arch","未知"));
extent.setSystemInfo("os.version",properties.getProperty("os.version","未知"));
extent.setSystemInfo("java.version",properties.getProperty("java.version","未知"));
extent.setSystemInfo("java.home",properties.getProperty("java.home","未知"));
extent.setSystemInfo("user.name",properties.getProperty("user.name","未知"));
extent.setSystemInfo("user.dir",properties.getProperty("user.dir","未知"));
}
private void buildTestNodes(ExtentTest extenttest,IResultMap tests, Status status) {
//存在父節(jié)點時，獲取父節(jié)點的標(biāo)簽
String[] categories=new String[0];
if(extenttest != null ){
List<TestAttribute> categoryList = extenttest.getModel().getCategoryContext().getAll();
categories = new String[categoryList.size()];
for(int index=0;index<categoryList.size();index++){
categories[index] = categoryList.get(index).getName();
}
}
ExtentTest test;
if (tests.size() > 0) {
//調(diào)整用例排序，按時間排序
Set<ITestResult> treeSet = new TreeSet<ITestResult>(new Comparator<ITestResult>() {
@Override
public int compare(ITestResult o1, ITestResult o2) {
return o1.getStartMillis()<o2.getStartMillis()?-1:1;
}
});
treeSet.addAll(tests.getAllResults());
for (ITestResult result : treeSet) {
Object[] parameters = result.getParameters();
String name="";
//如果有參數(shù)，則使用參數(shù)的toString組合代替報告中的name
for(Object param:parameters){
name+=param.toString();
}
if(name.length()>0){
if(name.length()>50){
name= name.substring(0,49)+"...";
}
}else{
name = result.getMethod().getMethodName();
}
if(extenttest==null){
test = extent.createTest(name);
}else{
//作為子節(jié)點進行創(chuàng)建時，設(shè)置同父節(jié)點的標(biāo)簽一致，便于報告檢索。
test = extenttest.createNode(name).assignCategory(categories);
}
//test.getModel().setDescription(description.toString());
//test = extent.createTest(result.getMethod().getMethodName());
for (String group : result.getMethod().getGroups())
test.assignCategory(group);
List<String> outputList = Reporter.getOutput(result);
for(String output:outputList){
//將用例的log輸出報告中
test.debug(output.replaceAll("<","<").replaceAll(">",">"));
}
if (result.getThrowable() != null) {
test.log(status, result.getThrowable());
}
else {
test.log(status, "Test " + status.toString().toLowerCase() + "ed");
}
//設(shè)置log的時間，根據(jù)ReportUtil.log()的特定格式進行處理獲取數(shù)據(jù)log的時間
Iterator logIterator = test.getModel().getLogContext().getIterator();
while (logIterator.hasNext()){
Log log = (Log) logIterator.next();
String details = log.getDetails();
if(details.contains(ReportUtil.getSpiltTimeAndMsg())){
String time = details.split(ReportUtil.getSpiltTimeAndMsg())[0];
log.setTimestamp(getTime(Long.valueOf(time)));
log.setDetails(details.substring(time.length()+ReportUtil.getSpiltTimeAndMsg().length()));
}else{
log.setTimestamp(getTime(result.getEndMillis()));
}
}
test.getModel().setStartTime(getTime(result.getStartMillis()));
test.getModel().setEndTime(getTime(result.getEndMillis()));
}
}
}
private Date getTime(long millis) {
Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(millis);
return calendar.getTime();
}
}
當(dāng)我們在testng.xml文件中添加要執(zhí)行的測試用例suite并執(zhí)行testng.xml文件，執(zhí)行完的結(jié)果就在項目的test-output/index.html路徑下，然后選擇用瀏覽器打開就可以看到了測試結(jié)果啦~ 如下：
image.png
以上就是對testng監(jiān)聽器在測試自動化中的常見使用啦~ 對你有幫助的話，點個喜歡??吧～～
