<?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>
<?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>
说明:一个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
属性详细说明
该参数的值false
,methods
,tests
,classes
,instances
。默认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
框架提供了支持,我没用过这个框架,所以这两个参数没看懂╮(╯▽╰)╭
说明:引入外部的xml文件(地址由path参数决定,path必填项),将引入的xml与当前的xml文件一起使用
声明方法:
<suite-files> <suite-file path="/path/suitefile1"></suite-file> </suite-files>
说明:一个<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 |
说明:提供测试数据,有name和value两个参数
声明方法:<parameter name = "parameter_name" value = "parameter_value "/>
testng.xml
文件中的<parameter>
可以声明在<suite>
或者<test>
级别,在<test>
下的<parameter>
会覆盖在<suite>
下声明的同名变量
说明:要运行的组,可以自定义一个组,可以包括要执行的,还排除要执行的方法。必须和<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>
说明:方法选择器,要执行的方法写在这里,参数有name和priority。
注释:
1.<classes>
下必须写要执行的<class>
,否则不会执行任何内容,如果填写了 class 没有写 methods,会按照填写的 class 的下的注释 @Test 去执行所有的方法
2.<classes>
下的<methods>
如果填写了<include>
,那只会执行所填写的方法,没有填写的方法不会去执行
声明方法:
<classes> <class name="要执行的class名"> <methods> <include name ="要执行的方法名"></include> </methods> </class> </classes>
(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\testwork\testNGDemo\src\main\resources\paramter.xml name=张三 age=11 =============================================== paramterTest Total tests run: 1, Failures: 0, Skips: 0 ===============================================
示例:
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:\Users\Administrator\.IntelliJIdea2019.2\system\temp-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 ===============================================
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:\Users\Administrator\.IntelliJIdea2019.2\system\temp-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)
(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\testwork\testNGDemo\src\main\resources\multithread.xml Thread id: 11 Thread id: 13 Thread id: 12 =============================================== thread Total tests run: 3, Failures: 0, Skips: 0 ===============================================
输出结果可以看出,有三条线程分别执行了不同的方法。