Maven test集成TestNG + ExtentReports

蔚落 2023-02-14 10:51 46阅读 0赞

TestNG + ExtentReports的基础使用可以查看[《TestNG项目集成ExtentReports》][TestNG_ExtentReports]，本篇主要讲解在maven项目的单元测试中，如何直接使用`mvn test`命令来驱动测试代码。

项目结构如下：  
现在要做的是，使用 `mvn test`命令时，可以自动执行test.xml和test2.xml文件两个文件，并使用extentreport自动生成测试报告  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70]

*  POM  
    dependencies部分就是testng和extentreport的依赖，在此不做拓展，主要讲解plugin  
    pom > build > plugins

<plugin>
    	<groupId>org.apache.maven.plugins</groupId>
    	<artifactId>maven-surefire-plugin</artifactId>
    	<version>2.22.1</version>
    	<configuration>
    		<suiteXmlFiles>
    			<suiteXmlFile>${project.basedir}/src/test/resources/test/test.xml</suiteXmlFile>
    			<suiteXmlFile>${project.basedir}/src/test/resources/test/test2.xml</suiteXmlFile>
    		</suiteXmlFiles>
    		<properties>
    			<property>
    				<name>listener</name>
    				<value>com.test.config.ExtentTestNGIReporterListener</value>
    			</property>
    		</properties>
    	</configuration>
    </plugin>

suiteXmlFile指定所有需要执行的testng的xml文件  
property指定所有监听器，例如ExtentReports 或者 MultiThreadingListener进行压测等

*  ExtentTestNGIReporterListener  
    我做了如下两种修改，有需要的同学可以做个参考：  
    1.测试报告路径： 根目录/report  
    2.测试报告的生成结构，具体修改情况可以查看下方的截图

package com.test.config;
    
    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.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 = "report/";
    
        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;
                }
                //统计suite下的成功、失败、跳过的总用例数
                int suiteFailSize=0;
                int suitePassSize=0;
                int suiteSkipSize=0;
                ExtentTest suiteTest=null;
                //存在多个suite的情况下，在报告中将同一个一个suite的测试结果归为一类，创建一级节点。
                if(createSuiteNode){ 
                    suiteTest = extent.createTest(suite.getName()).assignCategory(suite.getName());
                }
                boolean createSuiteResultNode = false;
                if(result.size()>1){ 
                    createSuiteResultNode=true;
                }
                for (ISuiteResult r : result.values()) { 
                    ExtentTest resultNode;
                    ITestContext context = r.getTestContext();
                    if(createSuiteResultNode){ 
                        //没有创建suite的情况下，将在SuiteResult的创建为一级节点，否则创建为suite的一个子节点。
                        if( null == suiteTest){ 
                            resultNode = extent.createTest(r.getTestContext().getName());
                        }else{ 
                            resultNode = suiteTest.createNode(r.getTestContext().getName());
                        }
                    }else{ 
                        resultNode = suiteTest;
                    }
                    if(resultNode != null){ 
                        resultNode.getModel().setName(suite.getName()+" : "+r.getTestContext().getName());
                        if(resultNode.getModel().hasCategory()){ 
                            resultNode.assignCategory(r.getTestContext().getName());
                        }else{ 
                            resultNode.assignCategory(suite.getName(),r.getTestContext().getName());
                        }
                        resultNode.getModel().setStartTime(r.getTestContext().getStartDate());
                        resultNode.getModel().setEndTime(r.getTestContext().getEndDate());
                        //统计SuiteResult下的数据
                        int passSize = r.getTestContext().getPassedTests().size();
                        int failSize = r.getTestContext().getFailedTests().size();
                        int skipSize = r.getTestContext().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));
                    if(suiteFailSize>0){ 
                        suiteTest.getModel().setStatus(Status.FAIL);
                    }
                }
    
            }
    // for (String s : Reporter.getOutput()) { 
    // extent.setTestRunnerOutput(s);
    // }
    
            extent.flush();
        }
    
        private void init() { 
            //文件夹不存在的话进行创建
            File reportDir= new File(OUTPUT_FOLDER);
            if(!reportDir.exists()&& !reportDir .isDirectory()){ 
                reportDir.mkdir();
            }
            String FILE_NAME =  System.currentTimeMillis() + ".html";
            ExtentHtmlReporter htmlReporter = new ExtentHtmlReporter(OUTPUT_FOLDER + FILE_NAME);
            // 设置静态文件的DNS
            // 解决cdn.rawgit.com访问不了的情况
            htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
    
            htmlReporter.config().setDocumentTitle("单元测试报告");
            htmlReporter.config().setReportName("单元测试报告");
            htmlReporter.config().setChartVisibilityOnOpen(true);
            htmlReporter.config().setTestViewChartLocation(ChartLocation.TOP);
            htmlReporter.config().setTheme(Theme.STANDARD);
            htmlReporter.config().setCSS(".node.level-1 ul{ display:none;} .node.level-1.active ul{display:block;}");
    
    
            extent = new ExtentReports();
            extent.attachReporter(htmlReporter);
            extent.setReportUsesManualConfiguration(true);
        }
    
        private void buildTestNodes(ExtentTest extenttest, IResultMap tests, Status status) { 
            //存在父节点时，获取父节点的标签
            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) { 
                //调整用例排序，按时间排序
                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) { 
    
                    String name = "";
                    if (result.getMethod().getDescription() == null){ 
                        name = result.getMethod().getTestClass().getName();
                    } else { 
                        name = result.getMethod().getDescription();
                    }
                    if(extenttest==null){ 
                        test = extent.createTest(name);
                    }else{ 
                        //作为子节点进行创建时，设置同父节点的标签一致，便于报告检索。
                        test = extenttest.createNode(name).assignCategory(categories);
                    }
                    for (String group : result.getMethod().getGroups())
                        test.assignCategory(group);
    
                    List<String> outputList = Reporter.getOutput(result);
                    for(String output:outputList){ 
                        //将用例的log输出报告中
                        test.debug(output);
                    }
                    if (result.getThrowable() != null) { 
                        test.log(status, result.getThrowable());
                    }
                    else { 
                        test.log(status, "Test " + status.toString().toLowerCase() + "ed");
                    }
    
                    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();
        }
    }

*  test.xml  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 1]
 *  BaseCase  
    Application为项目启动类，所有测试case继承于此类即可

@SpringBootTest(classes = Application.class)
    public abstract class BaseCase extends AbstractTestNGSpringContextTests { 
    
    }

*  TestCase  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 2]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 3]

[TestNG_ExtentReports]: https://blog.csdn.net/lt326030434/article/details/101263221
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200602171519633.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200602172813584.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200602172854684.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20200602173007305.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x0MzI2MDMwNDM0,size_16,color_FFFFFF,t_70