java——testNG——工作复习——xml详解

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="suitename" junit="false" verbose="3" parallel="false" thread-count="5" configfailurepolicy="<span style="font-family:Arial;"><span style="font-size: 14px; line-height: 26px;">skip</span></span>" annotations="javadoc" time-out="10000" skipfailedinvocationcounts="true" data-provider-thread-count="5" object-factory="classname" allow-return-values="true">  <!-- name参数为必须 -->
    <suite-files>
        <suite-file path="/path/to/suitefile1"></suite-file>  <!-- path参数为必须 -->
        <suite-file path="/path/to/suitefile2"></suite-file>
    </suite-files>  
    <parameter name="par1" value="value1"></parameter>  <!-- name, value参数为必须 -->
    <parameter name="par2" value="value2"></parameter>
    <method-selectors>
        <method-selector>
            <selector-class name="classname" priority="1"></selector-class> <!-- name参数为必须 -->
            <script language="java"></script>  <!-- language参数为必须 -->
        </method-selector>
    </method-selectors>
    <test name="testename" junit="false" verbose="3" parallel="false" thread-count="5" annotations="javadoc" time-out="10000" enabled="true" skipfailedinvocationcounts="true" preserve-order="true" allow-return-values="true"> <!-- name参数为必须 -->
        <parameter name="par1" value="value1"></parameter>  <!-- name, value参数为必须 -->
        <parameter name="par2" value="value2"></parameter>
        <groups>
            <define name="xxx"> <!-- name参数为必须 -->
                <include name="" description="" invocation-numbers="" />  <!-- name参数为必须 -->
                <include name="" description="" invocation-numbers="" />
            </define>
            <run>
                <include name="" />  <!-- name参数为必须 -->
                <exclude name="" />  <!-- name参数为必须 -->
            </run>
            <dependencies>
                <group name="" depends-on=""></group> <!-- name,depends-on均为参数为必须 -->
                <group name="" depends-on=""></group>
            </dependencies>
        </groups>
        <classes>
            <class name="classname"> <!-- name参数为必须 -->
                <methods>
                    <parameter name="par3" value="value3"></parameter>
                    <include name="" description="" invocation-numbers=""></include>
                    <exclude name=""></exclude>
                </methods>
                <methods></methods>
            </class>
        </classes>  
        <packages>
            <package name="" />  <!-- name参数为必须 -->
            <package name="">
                <include name="" description="" invocation-numbers=""></include>
                <exclude name=""></exclude>
            </package>
        </packages>
        <listeners>
            <listener class-name="classname1" />  <!-- name参数为必须 -->
            <listener class-name="classname2" />
        </listeners>
    </test>
    <test></test>
</suite> 

 

 

testng.xml 配置文件详解

1、配置文件结构(较详细):

 
<?xml version="1.0" encoding="UTF-8"?>
<!--添加dtd约束文件,标签自动提示-->
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite>
     <suite-files>
          <suite-file path=""></suite-file>
     </suite-files>
     <parameter name="" value=""></parameter>
     <method-selectors>
          <method-selector>
               <selector-calss name=""></selector-calss>
          </mehod-selector>
     </method-selectors>
     <test name="">
          <parameter name="" value=""><parameter>
          <groups>
               <define name="">
                    <include name=""/>
                    <exclude name=""/>
               </define>
               <run>
                    <include name=""/>
                    <exclude name=""/>
               </run>
          </groups>
          <classes>
               <class name="">
                    <mehods>
                         <parameter name="" value=""></parameter>
                         <include name=""></include>
                         <exclude name=""></exclude>
                    </methods>
               </class>
               <class></class>
          </classes>
          <packages>
               <package name="">
                    <include name=""></include>
                    <exclude name=""></exclude>
               </package>
          </packages>
          <listeners>
               <listener class-name=""/>
          </listenters>
     </test>
     <test></test>
</suite>

 

 

 

2、配置文件标签说明

[suite]标签

说明:一个xml文件只能有一个<suite>, 是一个xml文件的根级

<suite> 由 <test> 和 <parameters> 组成

标签属性说明:

属性说明使用方法参数值
name 必选项,的名字,将出现在reports里 name="XXX" suite名字
junit 是否执行Junit模式(识别setup()等) junit="true" true和false,默认false
verbose 控制台输出的详细内容等级,0-10级(0无,10最详细) verbose="5" 0到10
parallel 是否在不同的线程并行进行测试,要与thread-count配套使用 parallel="mehods" 详见表格下内容,默认false
parent-module 和Guice框架有关,只运行一次,创建一个parent injector给所有guice injectors    
guice-stage 和Guice框架有关 guice-stage="DEVELOPMENT" DEVELOPMENT,PRODUCTION,TOOL,默认"DEVELOPMENT"
configfailurepolicy 测试失败后是再次执行还是跳过,值skip和continue configfailurepolicy="skip" skip、continue,默认skip
thread-count 与parallel配套使用,线程池的大小,决定并行线程数量 thread-count="10" 整数,默认5
annotations 获取注解,值为javadoc时,使用JavaDoc的注释;否则用JDK5注释 annotations="javadoc" javadoc
time-out 设置parallel时,终止执行单元之前的等待时间(毫秒) time-out="10000" 整数,单位毫秒
skipfailedinvocationcounts 是否跳过失败的调用 skipfailedinvocationcounts="true" true和false,默认false
data-provider-thread-count 并发时data-provider的线程池数量 data-provider-thread-count="5" 整数
object-factory 一个实现IObjectFactory接口的类,实例化测试对象 object-factory="classname" 类名
allow-return-values 是否允许返回函数值 all-return-values="true" true和false
preserve-order 是否按照排序执行 preserve-order="true" true和false,默认true
group-by-instances 按照实例分组 group-by-instances="true" true和false,默认false

parallel 属性详细说明

该参数的值falsemethodstestsclassesinstances。默认false

parallel 必须和 thread-count 配套使用,否则相当于无效参数,thread-count 决定了并行测试时开启的线程数量

parallel="mehods" TestNG将并行执行所有的测试方法在不同的线程里

parallel="tests" TestNG将并行执行在同一个<test>下的所有方法在不同线程里

parallel="classes" TestNG将并行执行在相同<class>下的方法在不同线程里

parallel="instances" TestNG将并行执行相同实例下的所有方法在不同的县城里

parent-module 和guice-stage 和 Guice 框架有关,testNG 6对 Guice 框架提供了支持,我没用过这个框架,所以这两个参数没看懂╮(╯▽╰)╭

 

 

 

[suite-files]标签

说明:引入外部的xml文件(地址由path参数决定,path必填项),将引入的xml与当前的xml文件一起使用

声明方法:

 
<suite-files>

   <suite-file path="/path/suitefile1"></suite-file>

</suite-files>

 

 

 

[test]标签

说明:一个<suite>下可以有多个<test>,可以通过<suite>parallel="tests"来进行并行测试,必须和thread-count配套使用,否则是无效参数

<test><parameters>、<groups>、<classes>三部分组成

标签属性说明:

参数说明使用方法参数值
name test的名字,将出现在报告里 name="testname" test的名字
junit 是否按照Junit模式运行 junit="true" true和false,默认false
verbose 控制台输出的详细内容等级,0-10级(0无,10最详细),不在报告显示 verbose="5" 0到10
parallel 是否在不同的线程并行进行测试,要与thread-count配套使用 parallel="mehods" 与suite的parallel一致,默认false
thread-count 与parallel配套使用,线程池的大小,决定并行线程数量 thread-count="10" 整数,默认5
annotations 获取注解,值为javadoc时,使用JavaDoc的注释;否则用JDK5注释 annotations="javadoc" javadoc
time-out 设置parallel时,终止执行单元之前的等待时间(毫秒) time-out="10000" 整数,单位毫秒
enabled 标记是否执行这个test enabled="true" true和false,默认true
skipfailedinvocationcounts 是否跳过失败的调用 skipfailedinvocationcounts="true" true和false,默认false
preserve-order 是否按照排序执行,如果是true,将按照xml文件中的顺序去执行 preserve-order="true" true和false,默认true
allow-return-values 是否允许返回函数值 all-return-values="true" true和false,默认false

 

 

 

[parameter] 标签

说明:提供测试数据,有name和value两个参数

声明方法:<parameter name = "parameter_name" value = "parameter_value "/>

testng.xml 文件中的<parameter>可以声明在<suite>或者<test>级别,在<test>下的<parameter>会覆盖在<suite>下声明的同名变量

 

 

 

[groups] 标签

说明:要运行的组,可以自定义一个组,可以包括要执行的,还排除要执行的方法。必须和<classes>配套使用,从下面的类中找到对应名字的方法

<groups> 由<difine> 和 <run>、<dependencies> 三部分组成。

<diffine>可以将 group 组成一个新组,包括要执行和不执行的大组;

<run>要执行的方法;

<dependencies> 指定了某 group 需要依赖的 group(比如下面的例子,group1 需要依赖 group2 和 group3 先执行)。

声明方法:

 
<groups>
            
    <define name ="all">
        <include name ="testgroup1"/>
    </define>

    <run>
        <include name ="testmethod1"/>
        <exclude name="testmethod2"/>
    </run>

    <dependencies>
        <group name ="group1" depends-on="goup2 group3"/>
    </dependencies>

</groups>

 

 

 

 

[classes] 标签

说明:方法选择器,要执行的方法写在这里,参数有name和priority。

注释:

1.<classes>下必须写要执行的<class>,否则不会执行任何内容,如果填写了 class 没有写 methods,会按照填写的 class 的下的注释 @Test 去执行所有的方法

2.<classes>下的<methods>如果填写了<include>,那只会执行所填写的方法,没有填写的方法不会去执行

声明方法:

 
<classes>

   <class name="要执行的class名">
       <methods>
           <include name ="要执行的方法名"></include>
       </methods>
   </class> 

</classes>

 

 

 

testng 中方法参数传递

1、使用 @Parameters 注解从测试配置 xml 文件获取参数

(1)创建测试类:PatamterTest.java

 
package com.ggf.testng.paramter;

import org.testng.annotations.Parameters;
import org.testng.annotations.Test;

/**
 * @Description: testNG的参数化配置,通过xml文件进行方法的赋值操作
 * @Author: ggf
 * @Date: 2019/12/29
 */
public class PatamterTest {
    @Test
    @Parameters({"name","age"})
    public void showInfo(String name, int age) {
        System.out.println("name="+ name + " age=" + age);
    }

}

(2)创建配置文件

 
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name="paramterTest">
    <test name="transfer">
        <classes>
            <class name="com.ggf.testng.paramter.PatamterTest"/>
            <parameter name="name" value="张三"/>
            <parameter name="age" value="11"/>
        </classes>
    </test>
    
</suite>

(3)运行结果:

 
[TestNG] Running:
  D:workspace	estwork	estNGDemosrcmain
esourcesparamter.xml

name=张三 age=11

===============================================
paramterTest
Total tests run: 1, Failures: 0, Skips: 0
===============================================

2、使用@DataProvider传送参数,@DataProvider可以传递一些比较复杂的参数#

示例:

 
package com.ggf.testng.paramter;

import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;

import java.util.HashMap;
import java.util.Map;

/**
 * @Description:  主要是对DataProvider注解的学习,通过这个注解的标识,来给测试类进行赋值。
 * @Author: ggf
 * @Date: 2019/12/29
 * 首先定义一个数据源的方法,通过@DataProvider注解来标识。
 * 然后定义一个测试方法,通过@Test(dataProvider="")属性来获取数据
 */
public class DataProviderTest {
    /**
     * 数据源,是方法提供数据,返回必须是一个二维数组
     * @DataProvider(name = "data") 通过该注解来标识这个为数据源,name为数据源的名称。
     * @return 返回一个二维数组
     */
    @DataProvider(name = "data")
    public Object[][] providerData() {
        Object[][] data = new Object[][] {
                {"zhangsan",12},
                {"lisi",22},
                {"wangwu",32}
        };

        return data;
    }

    /**
     * 通过dataProvider来获取数据,执行的次数会根据数据源提供数据的数量
     * 例如上面的二维数组长度为3,则该方法会执行三次。
     * @param name
     * @param age
     */
    @Test(dataProvider = "data")
    public void testDataProvider(String name, int age) {
        System.out.println("name=" + name + " age=" + age);
    }


}

运行结果:

 
[TestNG] Running:
  C:UsersAdministrator.IntelliJIdea2019.2system	emp-testng-customsuite.xml
  
name=zhangsan age=12

name=lisi age=22

name=wangwu age=32

===============================================
Default Suite
Total tests run: 3, Failures: 0, Skips: 0
===============================================

 

 

testng 多线程测试

1、使用注解实现多线程测试

invocationCount:线程调用的次数,默认1次。

threadPoolSize:线程池大小,和 invocationCount 一起使用,如果没有定义 invocationCount ,定义了threadPoolSize,是没有效果的。

@Test(invocationCount = 10,threadPoolSize = 3)

invocationCount 默认这个属性的值是 1, 即只会执行一次,当从新赋值时,该方法就会执行多次。

这里就是,定义了三个线程,来执行这个方法10次。

示例:

 
package com.course.testng.multiThread;

import org.testng.annotations.Test;

public class MultiThreadOnAnnotion {

    @Test(invocationCount = 10,threadPoolSize = 3)
    public void test(){
        System.out.println(1);
        System.out.printf("Thread Id : %s%n",Thread.currentThread().getId());
    }

}

运行结果:

 
[TestNG] Running:
  C:UsersAdministrator.IntelliJIdea2019.2system	emp-testng-customsuite.xml
  
1
1
1
Thread Id : 12
Thread Id : 11
1
Thread Id : 11
Thread Id : 13
1
Thread Id : 12
1
Thread Id : 12
1
Thread Id : 11
1
Thread Id : 12
1
Thread Id : 12
1
Thread Id : 13

===============================================
Default Suite
Total tests run: 10, Failures: 0, Skips: 0
===============================================

从输出结果可以看出,一共有三条线程在执行,一共执行了10次(输出了10个1)

 

 

 

2、使用 xml 配置文件实现多线程测试

(1)创建测试类:MultiThreadOnXml.java

 
package com.ggf.testng.multithread;

import org.testng.annotations.Test;

/**
 * @Description: 使用配置文件来实现testng的多线程
 * @Author: ggf
 * @Date: 2020/02/01
 */
public class MultiThreadOnXml {
    @Test
    public void test1() {
        System.out.printf("Thread id: %s%n", Thread.currentThread().getId());
    }

    @Test
    public void test2() {
        System.out.printf("Thread id: %s%n", Thread.currentThread().getId());
    }

    @Test
    public void test3() {
        System.out.printf("Thread id: %s%n", Thread.currentThread().getId());
    }
}

(2)配置文件编写

 
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite name="thread" parallel="methods" thread-count="3">
    <!--
    tests级别:不同的test tag下的用例可以在不同的线程下执行
            相同的test tag下的用例只能在同一个线程中去执行
    classs级别:相同的class tag 下的用例在同一个线程中执行
                不同的class tag 下的用例可以在不同的线程中执行
    methods级别:所有用例都可以在不同的线程下去执行

    thread-count:代表了最大并发线程数

    xml文件配置这种方式不能指定线程池,只有方法上才可以指定线程池
    -->
    <test name="test1">
        <classes>
            <class name="com.ggf.testng.multithread.MultiThreadOnXml"/>
        </classes>
    </test>
</suite>

(3) 运行结果

 
[TestNG] Running:
  D:workspace	estwork	estNGDemosrcmain
esourcesmultithread.xml

Thread id: 11
Thread id: 13
Thread id: 12

===============================================
thread
Total tests run: 3, Failures: 0, Skips: 0
===============================================

输出结果可以看出,有三条线程分别执行了不同的方法。

原文地址:https://www.cnblogs.com/xiaobaibailongma/p/15063787.html