testng.xml 配置大全

时间  2019-11-17
标签 testng.xml testng xml 配置 大全 栏目 测试自动化 繁體版
原文   原文链接

1.TestNG的运行方式以下：

1 With a testng.xml file           直接run as test suite
2 With ant                         使用ant
3 From the command line            从命令行
4 IDE                              直接在IDE中执行

在IDEA中直接运行的时候，须要说明的是：能够运行一个测试类，也能够单独运行一个测试的方法。html

在IDEA里执行，只须要右键，点击 Run xxx 便可。 若是是在某一个方法的代码块里右键，出现的是 Run methodName ，即只运行当前的方法； 若是是在类的代码块里右键，出现的是 Run className ，即运行当前类中的全部Test方法； 也能够建立testng.xml，右键出现的 Run path/testng.xml ，即运行该配置文件中须要运行的方法。java

 

2.TestNG常见的注解：

注解 描述
@DataProvider 为测试方法提供数据
@BeforeMethod 在每一个测试方法 前 执行
@AfterMethod 在每一个测试方法 后 执行
@BeforeClass 被注释的方法将在当前类的第一个测试方法调用前运行
@AfterClass 被注释的方法将在当前类的全部测试方法调用后运行
@BeforeGroups 被配置的方法将在列表中的gourp前运行。这个方法保证在第一个属于这些组的测试方法调用前当即执行
@BeforeTest 被注释的方法将在测试运行前运行
@AfterTest 被注释的方法将在测试运行后运行
@BeforeSuite 被注释的方法将在全部测试运行前运行
@AfterSuite 被注释的方法将在全部测试运行后运行

 

 

 

 

 

 

 

 

 

另外还有一些属性，shell

alwaysRun：对于每一个bufore方法(beforeSuite, beforeTest, beforeTestClass 和 beforeTestMethod, 可是不包括 beforeGroups):
                　  若是设置为true，被配置的方法将老是运行而无论它属于哪一个组。
                　  对于after方法(afterSuite, afterClass, ...): 若是设置为true，被配置的方法甚至在一个或多个先调用的方法失败或被忽略时也将运行。数组

dependsOnGroups：这个方法依赖的组列表多线程

dependsOnMethod：这个方法依赖的方法列表并发

enabled：这个类的方法是否激活框架

groups：这个类或方法所属的分组列表yii

inheritGroups：若是设置为true，这个方法被属于在类级别被@Test annotation指定的组例如：ide

例如：
1  @Test(enabled = false)    //表示该测试用例不被执行
2     public Object runTest() {
3        xxxxxx 
4 }

 

3.testNG.xml配置详解：

 testng.xml的基本格式能够在官网上查看，基本格式以下：函数

如下详细XML结构规则

suite
--tests
----parameters
----groups
------definitions
------runs
----classes
--parameters

比较详细的结构以下：

 
复制代码
复制代码 
 1 <test name="xxxx">
 2 　　<!-- 参数定义的方法 -->
 3 　　<parameter name="first-name" value="Cedric"/>
 4 
 5 　　<!-- groups的用法，前提是须要存在classes的组，不然全部方法不被运行 -->
 6 　　<groups>
 7 　　<!-- 定义组中组的方法 -->
 8 　　　　<define name="groups_name">
 9 　　　　　　<include name="group1"/>
10 　　　　　　<include name="group2"/>
11 　　　　</define>
12 
13 　　　　<run>
14 　　　　　　<!-- 此处用组名来区别 -->
15 　　　　　　<inclue name="groups_name" />
16 　　　　　　<exclue name="groups_name" />
17 　　　　　　</run>
18 　　</groups>
19 
20 　　<!-- classes的用法，classes中包含类名，类名底下能够包含方法名或排除方法名 -->
21 　　<classes>
22 　　　　<class name="class1">
23 　　　　　　<methods>
24 　　　　　　　　<!-- 此处用方法名来区别 -->
25 　　　　　　　　<inclue name="method_name" />
26 　　　　　　　　<exclue name="method_name" />
27 　　　　　　</methods>
28 　　　　</class>
29 　　</classes>
30 </test>
复制代码
复制代码

具体的元素说明：

 

<suite>   testng.xml文档中最上层的元素
说明：一个xml文件只能有一个<suites>,，是一个xml文件的根级
<suite>由<test>和<parameters>组成
参数说明：
 
参数 说明 使用方法 参数值
name 必选项，<suite>的名字，将出如今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-file>
说明：引入外部的xml文件（地址由path参数决定，path必填项），将引入的xml与当前的xml文件一块儿使用
声明方法： 
1 <suite-files>
2      <suite-file path="/path/suitefile1"></suite-file>
3 </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>下声明的同名变量
 
--<method-selectors>
说明：方法选择器定义了哪些类的方法须要去执行，类必须继承自org.testng.IMethodSelector
声明方法： 
1 <method-selectors>
2      <method-selector>
3           <selector-class name="classname" priority="1"></selector-class>
4           <script language="java"></script>    （language还能够用beanshell等）
5      </method-selector>
6 </method-selectors>

 

备注：<method-selectors>这个我没用过，因此了解，若是有错的欢迎指出来~
 
--<groups>
说明：要运行的组，能够自定义一个组，能够包括要执行的，还排除要执行的方法。必须和<classes>配套使用，从下面的类中找到对应名字的方法
<groups>由<difine>和<run>、<dependencies>三部分组成。<diffine>能够将group组成一个新组，包括要执行和不执行的大组；<run>要执行的方法；<dependencies>指定了某group须要依赖的group（好比下面的例子，group1须要依赖group2和group3先执行）。
声明方法：
 
复制代码
复制代码 
 1 <groups>
 2      <define name ="all">
 3           <include name ="testgroup1"/>
 4           <exclude name ="testgroup2'/>
 5      </define>
 6      <run>
 7           <include name ="all"/>
 8           <include name ="testmethod1"/>
 9           <exclude name="testmethod2"/>
10      </run>
11      <dependencies>
12           <group name ="group1" depends-on="goup2 group3"/>
13      </dependencies>
14 </groups>
复制代码
复制代码

 

--<classes>
说明：方法选择器，要执行的方法写在这里，参数有name和priority。
注释：
1.<classes>下必须写要执行的<class>，不然不会执行任何内容，若是填写了class没有写methods，会按照填写的class的下的注释@Test去执行全部的方法
2.<classes>下的<methods>若是填写了<include>，那只会执行所填写的方法，没有填写的方法不会去执行
 
声明方法：
复制代码
复制代码 
1 <classes>
2      <class name="要执行的class名">
3           <methods>
4                <include name ="要执行的方法名"></include>
5           </methods>
6      </class> 
7 </classes>
复制代码
复制代码
 
--<packages>
说明：<packages>指定包名代替类名。查找包下的全部包含testNG annotation的类进行测试
声明方法：
复制代码
复制代码 
1 <packages>
2      <package name="packagename"/>
3      <package name="packagename">
4           <include name="methodname"/>
5           <exclude name="methodname"/>
6      </package>
7 </packages>
复制代码
复制代码
 
<listener>
说明：指定listeners，这个class必须继承自org.testng.ITestNGListener。在java中使用@Listeners({com.example.MyListener.class,com.example.MyMethodInterceptor.class})的注释也能够有一样效果
声明方法： 
1 <listeners>
2      <listener class-name="com.example.MyListener"/>
3      <listener class-name="com.example.MyMehodIntercepor"/>
4 </listeners>

 

（3）一个简单的testng.xml文档

 

复制代码
复制代码 
 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
 3 
 4 <suite name="Suite" parallel="classes" thread-count="3">
 5     <test verbose="2" preserve-order="true" name="TestDebug">
 6 
 7         <classes>
 8             <class name="com.hera.util.MathTest" />
 9 
10         </classes>
11     </test> <!-- Test -->
12 </suite> <!-- Suite -->
复制代码
复制代码

说明：  suite定义一个测试套件，能够设置是否使用多线程，可包含多个测试用例或者测试group

             parallel = classes  每一个测试用例class级别多线程

             thread-count =3  线程数为5，可同时执行3个case
             preserve-order = true   classes和methods按照配置中的顺序执行，false为乱序执行。（If you want the classes and methods listed in this file to be run in an unpredictible order, set the preserve-order attribute to false）

             parameter 标签传递参数

4.TestNG参数化测试

testng提供测试数据的两个注释：@DataProvide和@Parameter
 
1、经过testng.xml中设置参数
（实际上testng.xml只是一个名字，能够起任何一个名字，只要是.xml文件，而后文件格式按照testng的文档格式DTD来就能够了）
testng.xml中的内容：
<?xml version="1.0" encoding="UTF-8" ?>
<suite name = "testngframetest">
    <parameter name="para" value="test_para1"/>
    <test name="测试参数赋值">
        <classes>
            <parameters>
                <parameter name="para1" value="test_para1"/>
                <parameter name="para2" value="test_para2"/>
            </parameters>
            <class name = "paramer">
                <methods>
                    <include name ="showparamer"></include>
                </methods>
            </class>
        </classes>
    </test>
</suite>
 
.java文件的测试用例中经过parameters得到数据
使用方法1：
@Test(parameters="para1")
public void testcase(String para1){
     具体的测试用例，参数中的para1自动获取@Test中声明的变量，读取的是testng的xml文件中声明的参数para1的value值
}
若是有多个参数，可使用这种方式：@Test(parameters={"para1","para2"})
 
使用方法2：
@Parameter({"para1","para2"})
@Test
     具体的测试用例（参数@Parameter写在了@Test前面）
 
具体代码以下：
import org.testng.annotations.Test;
public class paramer {
    @Test(parameters ={"para1","para2"})
    public  void showparamer(String para11,String para22){
        System.out.println("testng得到的参数para1以下："+para11);
        System.out.println("testng得到的参数para2以下："+para22);;
    }
}
 
说明：
1.测试用例中设置的参数名随意，可是数量必定要和@Parameter中提供的数量一致，按照testng.xml中定义的顺序来取值的
2.<parameter>能够声明在<suite>或者<test>级别，在<test>下的<parameter>会覆盖在<suite>下声明的同名变量
3..java的测试用例中，能够经过@Optional("参数")来声明变量，若是没有在testng.xml中没有找到参数，会用@Optional("")中声明的参数
例以下面的代码，testng中没有声明para1和para2时，执行用例时会直接复制test1和test2
import org.testng.annotations.Optional;
import org.testng.annotations.Test;
public class paramer {
    @Test(parameters ={"para1","para2"})
    public  void showparamer(@Optional("test1") String para11, @Optional("test2") String para22){
        System.out.println("testng得到的参数para1以下："+para11);
        System.out.println("testng得到的参数para2以下："+para22);;
    }
}
 
2、经过注释@Dataprovide得到参数
（testng.xml只能传递简单的参数，若是是循环遍历的使用不一样的参数则不能够实现。这时可使用@Dataprovide来提供数据）
 
提供数据的方法：
@DataProvider(name = "dataprovider1")
public Object[][] dataprovide(){
    return new Object[][]{{1,2,3},{3,2,1}};
}
说明：
1.@DataProvide只能返回Object数组结果
2.Object的行中的每一列标识一个参数（好比上面的例子是3个参数），行数决定了调用的方法要执行的次数（好比上面的例子是执行2次）
 
调用数据方法：
@Test(dataprovide="XXX")
说明：
1.XXX为@DataProvide声明的一个名字，返回的是一个Object数组
2.方法的执行次数为赋值参数的遍数。好比提供数组为1行，则只执行一次；若是是数组为3行，则执行3次。
 
其余扩展：
1.@DataProvide写在单独的class里，加强复用性。
这时调用该数据的方法为：@Test(dataprovide="XXX",dataClass=YYY.class)
说明：读取YYY.class下的@DataProvide为XXX的Object数组数据
2.@DataProvide下定义的数组，经过其余文件读取，好比读取excel，返回一个Object数组
3.@DataProvide能够经过parallel实现并行执行线程，默认10个，能够在testng.xml中进行修改（<suite name="XXX" data-provider-thread-count="YYY">）
@DataProvider(name = "dataprovider1",parallel = true)
public Object[][] dataprovide(){
    return new Object[][]{{1,2},{2,1}};
}
@Test(dataProvider = "dataprovide")
public void showDataprovide(int a,int b,Method c){
    System.out.println("DataProvider得到的参数para1以下："+a);
    System.out.println("DataProvider得到的参数para2以下："+b);;
    System.out.println("DataProvider得到的参数para2以下："+c.getName());

}
4.@DataProvide和@Parameters不能同时声明，可是能够经过其余方法实现同时使用。
String testId = context.getCurrentXmlTest().getParameter("test_id"); 
更详细的内容能够参考testng教程： https://www.yiibai.com/testng/ 
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程