IDEA 单元测试testng入门及testng.xml

    IDEA自带了Junit 和testng 测试框架。但默认并不包含在你的项目或者模块中。

     在使用之前需要先添加依赖，路径如下：

• JUnit libraries (junit.jar and junit-4.11.jar): <IntelliJ IDEA directory>\lib.
• TestNG library (testng-jdk15.jar): <IntelliJ IDEA directory>\plugins\testng\lib.

     

    参考链接：点击打开链接 （https://www.jetbrains.com/help/idea/2016.2/meet-intellij-idea.html）

                      testng入门教程

                               易百TestNG教程

1、创建Test类的流程和junit，类似，请参照 Junit 教程

2、编写测试函数。TestNG的运行方式有如下几种：

            

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

       在IDEA中直接运行的时候，需要说明的是：可以运行一个测试类，也可以单独运行一个测试的方法。

        在IDEA里执行，只需要右键，点击 Run xxx 即可。 如果是在某一个方法的代码块里右键，出现的是 Run methodName ，即只运行当前的方法； 如果是在类的代码块里右键，出现的是 Run className ，即运行当前类中的所有Test方法； 也可以创建testng.xml，右键出现的 Run path/testng.xml ，即运行该配置文件中需要运行的方法。

3、testng详细使用

           

TestNG的支持列表中的注解

@DataProvider	为测试方法提供数据

注解	描述
@BeforeMethod	在每个测试方法 前 执行
@AfterMethod	在每个测试方法 后 执行
@BeforeClass	被注释的方法将在当前类的第一个测试方法调用前运行
@AfterClass	被注释的方法将在当前类的所有测试方法调用后运行
@BeforeGroups	被配置的方法将在列表中的gourp前运行。这个方法保证在第一个属于这些组的测试方法调用前立即执行
@BeforeTest	被注释的方法将在测试运行前运行
@AfterTest	被注释的方法将在测试运行后运行
@BeforeSuite	被注释的方法将在所有测试运行前运行
@AfterSuite	被注释的方法将在所有测试运行后运行
alwaysRun	对于每个bufore方法(beforeSuite, beforeTest, beforeTestClass 和 beforeTestMethod, 但是不包括 beforeGroups):                 如果设置为true，被配置的方法将总是运行而不管它属于哪个组。                 对于after方法(afterSuite, afterClass, ...): 如果设置为true，被配置的方法甚至在一个或多个先调用的方法失败或被忽略时也将运行。
dependsOnGroups	这个方法依赖的组列表
dependsOnMethods	这个方法依赖的方法列表
enabled	这个类的方法是否激活
groups	这个类或方法所属的分组列表
inheritGroups	如果设置为true，这个方法被属于在类级别被@Test annotation指定的组

4、testng.xml  配置详解

        testng.xml的基本格式可以在官网上查看，基本格式如下：       

             

（1）简单的大概结构如下：

以下详细XML规则

-结-构-树

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

比较详细的结构如下：

<test name="xxxx">
　　<!-- 参数定义的方法 -->
　　<parameter name="first-name" value="Cedric"/>

　　<!-- groups的用法，前提是需要存在classes的组，否则所有方法不被运行 -->
　　<groups>
　　<!-- 定义组中组的方法 -->
　　　　<define name="groups_name">
　　　　　　<include name="group1"/>
　　　　　　<include name="group2"/>
　　　　</define>

　　　　<run>
　　　　　　<!-- 此处用组名来区别 -->
　　　　　　<inclue name="groups_name" />
　　　　　　<exclue name="groups_name" />
　　　　　　</run>
　　</groups>

　　<!-- classes的用法，classes中包含类名，类名底下可以包含方法名或排除方法名 -->
　　<classes>
　　　　<class name="class1">
　　　　　　<methods>
　　　　　　　　<!-- 此处用方法名来区别 -->
　　　　　　　　<inclue name="method_name" />
　　　　　　　　<exclue name="method_name" />
　　　　　　</methods>
　　　　</class>
　　</classes>
</test>

（2）具体的元素说明：

<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文件一起使用

声明方法：

<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>下声明的同名变量

 

--<method-selectors>

说明：方法选择器定义了哪些类的方法需要去执行，类必须继承自org.testng.IMethodSelector

声明方法：

<method-selectors>

     <method-selector>

          <selector-class name="classname" priority="1"></selector-class>

          <script language="java"></script>    （language还可以用beanshell等）

     </method-selector>

</method-selectors>

备注：<method-selectors>这个我没用过，所以了解，如果有错的欢迎指出来~

 

--<groups>

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

<groups>由<difine>和<run>、<dependencies>三部分组成。<diffine>可以将group组成一个新组，包括要执行和不执行的大组；<run>要执行的方法；<dependencies>指定了某group需要依赖的group（比如下面的例子，group1需要依赖group2和group3先执行）。

声明方法：

<groups>

     <define name ="all">

          <include name ="testgroup1"/>

          <exclude name ="testgroup2'/>

     </define>

     <run>

          <include name ="all"/>

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

 

--<packages>

说明：<packages>指定包名代替类名。查找包下的所有包含testNG annotation的类进行测试

声明方法：

<packages>

     <package name="packagename"/>

     <package name="packagename">

          <include name="methodname"/>

          <exclude name="methodname"/>

     </package>

</packages>

 

<listener>

说明：指定listeners，这个class必须继承自org.testng.ITestNGListener。在java中使用@Listeners({com.example.MyListener.class,com.example.MyMethodInterceptor.class})的注释也可以有同样效果

声明方法：

<listeners>

     <listener class-name="com.example.MyListener"/>

     <listener class-name="com.example.MyMehodIntercepor"/>

</listeners>

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

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

<suite name="Suite" parallel="classes" thread-count="3">
    <test verbose="2" preserve-order="true" name="TestDebug">

        <classes>
            <class name="com.hera.util.MathTest" />

        </classes>
    </test> <!-- Test -->
</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 标签传递参数

5、忽略测试

@Test(enabled = false)有助于禁用此测试案例。

例如:

@org.testng.annotations.Test(enabled = false)
public void testSort() throws Exception {
    int[] arr = new int[50000]; //数组长度为50000
    int arrLength = arr.length;
    //随机生成数组元素
    Random r = new Random();
    for (int i = 0; i < arrLength; i++) {
        arr[i] = r.nextInt(arrLength);
    }

    new Math().sort(arr);
}

6、TestNG参数化测试

       软件测试中，经常需要测试大量的数据集。 测试代码的逻辑完全一样，只是测试的参数不一样。  这样我们就需要一种 “传递测试参数的机制”。 避免写重复的测试代码

TestNG提供了2种传递参数的方式。

第一种: testng.xml 方式使代码和测试数据分离，方便维护

第二种：@DataProvider能够提供比较复杂的参数。 (也叫data-driven testing)

          方法一：通过testng.xml传递参数给测试代码，在testng.xml文件中定义的简单参数，然后在源文件中引用这些参数。

下面是支持的类型：
String
int/Integer
boolean/Boolean
byte/Byte
char/Character
double/Double
float/Float
long/Long
short/Short

例子：

          

            

           

方法二：通过DataProvider传递参数，当你需要通过复杂的参数或参数需要创建从Java（复杂的对象，对象读取属性文件或数据库等..），在这种情况下，可以将参数传递使用数据提供者。数据提供者@DataProvider的批注的方法。

   （可以通过excel来管理case数据）

@DataProvider(name = "dataProvider_entities")
private Object[][] dataProvider_testEntities() throws Exception{
    return ExcelReaderForTestngDataProvider.getDataFrom("Case_Tag_LoginRisk.xlsx", "entities");
}