自动化测试-api接口端详情参见：前言 1. TestNG使用流程 1.1TestNG安装 1.2 创建Maven项

[详情参见：] 前言

1. TestNG使用流程

1.1TestNG安装

1.2 创建Maven项目

1.3 Maven配置

1.4 项目TestNG测试类

1.5 运行TestNG

2、TestNG常用注解

3.xml方式运行

3.1 鼠标右击testng.xml运行

3.2 使用maven运行

常用的断言（assert）
TestNG预期异常测试
TestNG忽略测试
TestNG超时测试
分组测试
分suite测试
依赖测试
参数化测试
XML配置文件说明
TestNG报告
与Junit的区别

前言

TestNG是一个java中的开源自动化测试框架，其灵感来自JUnit和NUnit，TestNG还涵盖了JUnit4整个核心的功能，但引入了一些新的功能，使其功能更强大，使用更方便。

优势：支持依赖测试方法，并行测试，负载测试，局部故障，灵活的插件API，支持多线程测试。详细使用说明请参考官方链接：TestNG官方文档。

TestNG使用流程 1.1TestNG安装本文以IDEA+Maven为例介绍TestNG，IntelliJ IDEA版本为IntelliJ IDEA 2020.1.1 (Ultimate Edition)。

IntelliJ IDEA中默认集成了TestNG，点击File->Settings，如下图：

1.2 创建Maven项目点击File->new-Project，如图

创建基于Maven的项目

创建名字为MavenTest的项目，创建完成后如下图

1.3 Maven配置在工程的pom.xml中需要添加如下依赖：

4.0.0

<groupId>org.example</groupId>
<artifactId>MavenTest</artifactId>
<version>1.0-SNAPSHOT</version>

<dependencies>
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>6.10</version>
    </dependency>
</dependencies>

AI写代码 1.4 项目TestNG测试类点击类名Test，按alt+entet键，创建单元测试类

点击Create Test

OK，生成测试类

1.5 运行TestNG 添加一个测试方法，如下

运行结果如下：

2、TestNG常用注解有必要介绍一下TestNG注解的生命周期，先看一下官网支持的注解有：

注解描述 @BeforeSuite 在该套件的所有测试运行之前运行，仅运行一次 @AfterSuite 在该套件的所有测试运行之后运行，仅运行一次 @BeforeTest 注释的方法将在属于test标签内的所有类的所有测试方法运行之前运行，一个test标签内可能有多个class（类），在当前test标签内仅运行一次 @AfterTest 注释的方法将在属于test标签内的所有类的所有测试方法运行之后运行，一个test标签内可能有多个class（类），在当前test标签内仅运行一次 @BeforeClass 在调用当前类的第一个测试方法之前运行，在当前类中仅运行一次 @AfterClass 在调用当前类的第一个测试方法之后运行，在当前类中仅运行一次 @BeforeGroups 配置方法将在组列表运行之前运行。此方法保证在调用属于这些组中的任何第一个测试方法之前不久运行 @AfterGroups 此配置方法将在组列表运行之后运行。该方法保证在调用属于这些组的任何最后一个测试方法之后不久运行 @BeforeMethod 注释方法将在当前类中的每个测试方法之前运行 @AfterMethod 注释方法将在当前类中的每个测试方法之后运行 @Parameters 描述如何将参数传递给@Test方法 @DataProvider 标记一种方法来提供测试方法的数据。注释方法必须返回一个Object [] []，其中每个Object []可以被分配给测试方法的参数列表。要从该DataProvider接收数据的@Test方法需要使用与此注释名称相等的dataProvider名称 @Listeners 定义测试类上的侦听器 @Factory 将一个方法标记为工厂，返回TestNG将被用作测试类的对象。该方法必须返回Object [] @Test 将类或方法标记为测试的一部分，此标记若放在类上，则该类所有公共方法都将被作为测试方法如上列表中的@Factory、@Linsteners这两个是不常用的；前十个注解看起来不太容易区分，顺序不太容易看明白，以如下范例做简单说明，代码：

import org.testng.Assert; import org.testng.annotations.AfterClass; import org.testng.annotations.AfterGroups; import org.testng.annotations.AfterMethod; import org.testng.annotations.AfterSuite; import org.testng.annotations.AfterTest; import org.testng.annotations.BeforeClass; import org.testng.annotations.BeforeGroups; import org.testng.annotations.BeforeMethod; import org.testng.annotations.BeforeSuite; import org.testng.annotations.BeforeTest; import org.testng.annotations.Test;

public class NewTest {

@Test(groups="group1") public void test1() { System.out.println("test1 from group1"); Assert.assertTrue(true); }

@Test(groups="group1") public void test11() { System.out.println("test11 from group1"); Assert.assertTrue(true); }

@Test(groups="group2") public void test2() { System.out.println("test2 from group2"); Assert.assertTrue(true); }

@BeforeTest public void beforeTest() { System.out.println("beforeTest"); }

@AfterTest public void afterTest() { System.out.println("afterTest"); }

@BeforeClass public void beforeClass() { System.out.println("beforeClass"); }

@AfterClass public void afterClass() { System.out.println("afterClass"); }

@BeforeSuite public void beforeSuite() { System.out.println("beforeSuite"); }

@AfterSuite public void afterSuite() { System.out.println("afterSuite"); }

//只对group1有效，即test1和test11 @BeforeGroups(groups="group1") public void beforeGroups() { System.out.println("beforeGroups"); }

//只对group1有效，即test1和test11 @AfterGroups(groups="group1") public void afterGroups() { System.out.println("afterGroups"); }

@BeforeMethod public void beforeMethod() { System.out.println("beforeMethod"); }

@AfterMethod public void afterMethod() { System.out.println("afterMethod"); } } AI写代码运行结果如下：

=============================================== Default test Tests run: 3, Failures: 0, Skips: 0

afterSuite AI写代码由此可见，testng运行时，顺序是这样的：

@BeforeSuite->@BeforeTest->@BeforeClass->{@BeforeGroups[@BeforeMethod->@Test1->@AfterMethod，@BeforeMethod->@Test2->@AfterMethod, ...]@AfterGroups, @BeforeGroups[@BeforeMethod->@Test3->@AfterMethod，@BeforeMethod->@Test4->@AfterMethod, ...]@AfterGroups, ...}->@AfterClass->@AfterTest->@AfterSuite

其中{}内将@BeforeGroups@AfterGroups将@Test分组，每个分组内包含多个@Test。

3.xml方式运行 TestNG也可以以xml的方式运行

套件，根标签，通常由几个<test组成> 属性：　　name 套件的名称，必须属性；　　verbose 运行的级别或详细程度；　　parallel 是否运行多线程来运行这个套件；　　thread-count 如果启用多线程，用于指定开户的线程数；　　annotations 在测试中使用的注释类型；　　time-out 在本测试中的所有测试方法上使用的默认超时时间；　　测试用例，name为必须属性；用例中包含的类，子标签为; 测试类，其中属性name为必须属性；; 用例中包含的包，包中所有的方法都会执行，子标签为; 测试包，name为必须属性；指定测试类中包含或排除的方法，子类为,; 指定需要测试的方法，name为必须属性；指定类中不需要测试的方法，name为必须属性；指定测试用例中要运行或排除运行的分组，子标签为,下包含,标签，,的name指定运行、不运行的分组； AI写代码在项目下新建一个testng.xml文件，模板如下：

AI写代码

3.1 鼠标右击testng.xml运行 TestTest3的代码如下：

import org.testng.Assert; import org.testng.annotations.Test; import org.testng.annotations.*;

public class TestTest3 {

@Test(groups = "group1")
public void testC03() {
    System.out.println("testC03");
    Assert.assertTrue(true);
}

@Test(groups = "group1")
public void testC04() {
    System.out.println("testC04");
    Assert.assertTrue(true);
}

@Test(groups = "group2")
public void testC05() {
    System.out.println("testC05");
    Assert.assertTrue(true);
}

@BeforeTest
public void beforeTest() {
    System.out.println("beforeTest");
}

@AfterTest
public void afterTest() {
    System.out.println("afterTest");
}

@BeforeClass
public void beforeClass() {
    System.out.println("beforeClass");
}

@AfterClass
public void afterClass() {
    System.out.println("afterClass");
}

@BeforeSuite
public void beforeSuite() {
    System.out.println("beforeSuite");
}

@AfterSuite
public void afterSuite() {
    System.out.println("afterSuite");
}

@BeforeGroups(groups = {"group1", "group2"})
public void beforeGroups() {
    System.out.println("beforeGroups");
}

@AfterGroups(groups = {"group1", "group2"})
public void afterGroups() {
    System.out.println("afterGroups");
}


@BeforeMethod
public void beforeMethod() {
    System.out.println("beforeMethod");
}

@AfterMethod
public void afterMethod() {
    System.out.println("afterMethod");
}

} AI写代码 TestTest4的代码如下：

import org.testng.Assert; import org.testng.annotations.Test; import org.testng.annotations.*;

public class TestTest4 {

@Test(groups = "group1")
public void testD03() {
    System.out.println("testD03");
    Assert.assertTrue(true);
}

@Test(groups = "group1")
public void testD04() {
    System.out.println("testD04");
    Assert.assertTrue(true);
}

@Test(groups = "group2")
public void testD05() {
    System.out.println("testD05");
    Assert.assertTrue(true);
}

@BeforeTest
public void beforeTest() {
    System.out.println("beforeTest");
}

@AfterTest
public void afterTest() {
    System.out.println("afterTest");
}

@BeforeClass
public void beforeClass() {
    System.out.println("beforeClass");
}

@AfterClass
public void afterClass() {
    System.out.println("afterClass");
}

@BeforeGroups(groups = "group1")
public void beforeGroups() {
    System.out.println("beforeGroups");
}

@AfterGroups(groups = "group1")
public void afterGroups() {
    System.out.println("afterGroups");
}

@BeforeMethod
public void beforeMethod() {
    System.out.println("beforeMethod");
}

@AfterMethod
public void afterMethod() {
    System.out.println("afterMethod");
}

} AI写代码修改testng.xml的内容如下：

    <classes>
        <class name="TestTest3"/>
    </classes>

</test> <!-- Test -->

<test name="Test2">
    <classes>
        <class name="TestTest4"/>
    </classes>
</test> <!-- Test -->

AI写代码鼠标右键testng.xml文件，运行结果如下：

[TestNG] Running: C:\Users\HP\IdeaProjects\MavenTest\testng.xml

beforeSuite

beforeTest

beforeClass

beforeGroups

beforeMethod

testC03

afterMethod

beforeMethod

testC04

afterMethod

afterGroups

beforeGroups

beforeMethod

testC05

afterMethod

afterGroups

afterClass

afterTest

beforeTest

beforeClass

beforeGroups

beforeMethod

testD03

afterMethod

beforeMethod

testD04

afterMethod

afterGroups

beforeMethod

testD05

afterMethod

afterClass

afterTest

afterSuite

=============================================== Suite Total tests run: 6, Failures: 0, Skips: 0

Process finished with exit code 0 AI写代码 3.1 使用maven运行需要在pom文件中，指明testng.xml文件的位置。

maven使用surefire这个插件进行测试，可以执行testng或者Junit脚本。

语法为 src/test/resources/testNGFilesFolder/${testNgFileName}.xml

org.apache.logging.log4j log4j-api 2.8 org.apache.maven.plugins maven-surefire-plugin 2.19 testng.xml//该文件位于工程根目录时，直接填写名字，其它位置要加上路径。 AI写代码运行测试脚本

进入到项目工程的根目录，使用 mvn clean test -Dtestng.xml 命令。

常用的断言（assert） assertEqual ([String message], expected value, actual value) 断言两个值相等。值可能是类型有 int, short, long, byte, char or java.lang.Object. 第一个参数是一个可选的字符串消息; assertTrue([String message], boolean condition) 　　　　　　　断言一个条件为真; assertFalse([String message],boolean condition) 　　　　　　　　　　断言一个条件为假; assertNotNull([String message], java.lang.Object object) 　断言一个对象不为空(null); assertNull([String message], java.lang.Object object) 　　　　断言一个对象为空(null); assertSame([String message], java.lang.Object expected, java.lang.Object actual) 　　　断言两个对象引用相同的对象; assertNotSame([String message], java.lang.Object unexpected, java.lang.Object actual) 断言两个对象不是引用同一个对象; assertArrayEquals([String message], expectedArray, resultArray) 　　　　　　　　　　　　断言预期数组和结果数组相等。数组的类型可能是 int, long, short, char, byte or java.lang.Object.; AI写代码
TestNG预期异常测试预期异常测试通过在@Test注解后加入预期的Exception来进行添加，范例如下所示：

@Test(expectedExceptions = ArithmeticException.class) public void divisionWithException() { int i = 1 / 0; System.out.println("After division the value of i is :"+ i); } AI写代码运行结果如下：

[RemoteTestNG] detected TestNG version 6.10.0 [TestNG] Running: C:\Users\Administrator\AppData\Local\Temp\testng-eclipse--754789457\testng-customsuite.xml

PASSED: divisionWithException

=============================================== Default test Tests run: 1, Failures: 0, Skips: 0

=============================================== Default suite Total tests run: 1, Failures: 0, Skips: 0

[TestNG] Time taken by org.testng.reporters.JUnitReportReporter@55d56113: 0 ms [TestNG] Time taken by org.testng.reporters.SuiteHTMLReporter@1e127982: 0 ms [TestNG] Time taken by org.testng.reporters.jq.Main@6e0e048a: 32 ms [TestNG] Time taken by [FailedReporter passed=0 failed=0 skipped=0]: 0 ms [TestNG] Time taken by org.testng.reporters.XMLReporter@43814d18: 0 ms [TestNG] Time taken by org.testng.reporters.EmailableReporter2@6ebc05a6: 0 ms AI写代码

TestNG忽略测试有时候我们写的用例没准备好，或者该次测试不想运行此用例，那么删掉显然不明智，那么就可以通过注解@Test(enabled = false)来将其忽略掉，此用例就不会运行了，如下范例：

import org.testng.annotations.Test;

public class TestCase1 {

@Test(enabled=false)
public void TestNgLearn1() {
    System.out.println("this is TestNG test case1");
}

@Test
public void TestNgLearn2() {
    System.out.println("this is TestNG test case2");
}

} AI写代码运行结果：

this is TestNG test case2 PASSED: TestNgLearn2

AI写代码 7. TestNG超时测试 “超时”表示如果单元测试花费的时间超过指定的毫秒数，那么TestNG将会中止它并将其标记为失败。此项常用于性能测试。如下为一个范例：

import org.testng.annotations.Test;

public class TestCase1 {

@Test(timeOut = 5000) // time in mulliseconds
public void testThisShouldPass() throws InterruptedException {
    Thread.sleep(4000);
}

@Test(timeOut = 1000)
public void testThisShouldFail() {
    while (true){
        // do nothing
    }

}

} AI写代码结果如下：

PASSED: testThisShouldPass FAILED: testThisShouldFail org.testng.internal.thread.ThreadTimeoutException: Method com.demo.test.testng.TestCase1.testThisShouldFail() didn't finish within the time-out 1000 at com.demo.test.testng.TestCase1.testThisShouldFail(TestCase1.java:37) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:498) at org.testng.internal.MethodInvocationHelper.invokeMethod(MethodInvocationHelper.java:104) at org.testng.internal.InvokeMethodRunnable.runOne(InvokeMethodRunnable.java:54) at org.testng.internal.InvokeMethodRunnable.run(InvokeMethodRunnable.java:44) at java.util.concurrent.Executors $RunnableAdapter.call(Executors.java:511) at java.util.concurrent.FutureTask.run(FutureTask.java:266) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) at java.util.concurrent.ThreadPoolExecutor$ Worker.run(ThreadPoolExecutor.java:624) at java.lang.Thread.run(Thread.java:748)

AI写代码 8. 分组测试分组测试即为使用group，如果你使用xml的话就是里边的标签，如果是直接在class中，是通过@Test(groups="group2")这种方式来分组，如第四节的注解说明中的那个例子，分了两个group，而且@BeforeGroup是需要添加group名称才可以正确挂载到该group下的；这个group说明可以是在单个的测试方法上，也可以在class上，只要具有同样的group名称都会在同一个group中，同时group名称可以有多个，类似@Test(groups = {"mysql","database"})这种，范例如下：一个测试文件NewTest.class：