博客

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

  • Post author:
  • Post category:java


<?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

属性详细说明

该参数的值

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

框架提供了支持，我没用过这个框架，所以这两个参数没看懂╮(╯▽╰)╭

[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\testwork\testNGDemo\src\main\resources\paramter.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:\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 ===============================================

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:\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)

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\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 ===============================================

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


版权声明：本文为m0_61442607原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
Tags: