TestNG 参数化测试实践指南

lsekfe · 发表于 2022-8-1 10:55:14

参数化测试是TestNG的一个重要特性。在很多情况下，我们会遇到业务逻辑需要大量测试的场景。参数化测试允许我们使用不同的值一次又一次地运行相同的测试。
　　本文介绍了TestNG 参数化注入的三种不同方式，并在此基础上，介绍了测试代码和测试数据、测试数据和测试环境的分离实践以及一种利用Nacos将测试代码和测试数据维护分离的有效实践。另外，本文将会引导读者完成一个实例，该示例将会较好地演示TestNG 参数的注入方式以及分离测试代码、数据与环境的有效实践。
　　示例项目准备
　　这里我们使用IDEA 社区版演示本实践全过程，读者也可以使用Eclipse和VSCode参考执行，但笔者并不推荐。

Language选择Java，Build system选择Maven，JDK选择1.8后，点“Create” 进入工程页面。
　　pom.xml里加入dependency：

<dependency>
　　 <groupId>org.testng</groupId>
　　 <artifactId>testng</artifactId>
　　 <version>7.4.0</version>
　　 <scope>test</scope>
　　</dependency>

复制代码

TestNG 参数化注入的方式
　　TestNG可以通过如下三种不同的方式将参数直接传递给测试方法：
　　·使用注解Parameters配合testng.xml
　　· 使用注解Parameters配合-D命令行参数
　　· 使用注解DataProvider
　　使用注解Parameters配合testng.xml
　　我们通过在testng.xml定义参数，然后在代码里面可以直接引用。我们先写一个测试用例如下：

　　src/test/java/com/fastjrun.example/testng/ParameterizedTest1.java

复制代码

package com.fastjrun.example.testng;
　　import org.testng.annotations.Parameters;
　　import org.testng.annotations.Test;
　　public class ParameterizedTest1 {
　　 @Test
　　 @Parameters("myName")
　　 public void parameterTest(String myName) {
　　 System.out.println("Parameterized value is : " + myName);
　　 }
　　}

复制代码

编写testng.xml如下：

<?xml version = "1.0" encoding = "UTF-8"?>
　　<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
　　<suite name = "Suite1">
　　 <test name = "test1">
　　 <parameter name = "myName" value="manisha"/>
　　 <classes>
　　 <class name = "com.fastjrun.example.testng.ParameterizedTest1" />
　　 </classes>
　　 </test>
　　</suite>

复制代码

执行测试。
　　在testng.xml编辑窗口点击鼠标右键弹出下拉菜单后，从中选择“Run .../src/test/resources/testng.xml”即可执行该单元测试用例。

执行结果如下：

Parameterized value is : manisha
　　===============================================
　　Suite1
　　Total tests run: 1, Passes: 1, Failures: 0, Skips: 0
　　===============================================

复制代码

另外我们也可以如下图所示，在ParameterizedTest1类编辑窗口选中需要测试的方法名parameterTest，点击鼠标右键弹出下拉菜单后，从中选择“Run parameterTest()”即可执行该单元测试用例。

但通过如上方式运行单元测试，结果如下：

……
　　[Utils] [ERROR] [Error] org.testng.TestNGException:
　　Parameter 'myName' is required by [url=home.php?mod=space&uid=724]@test[/url] on method parameterTest but has not been marked @Optional or defined
　　in /Users/cuiyingfeng/Library/Caches/JetBrains/IdeaIC2022.1/temp-testng-customsuite.xml

复制代码

显然如上方式触发的测试用例不能指定依赖的testng.xml，myName参数没有被初始化，导致测试失败。
　　使用testng.xml 执行测试的方式适合对测试用例批量执行的场景；如果我们在IDE中只想执行某个具体的测试方法，还是需要从类中触发测试方法的方式，也就是要通过非testng.xml配置的方式解决myName初始化的问题。
　　解决myName初始化问题的方法一共有两种，其中一种是在测试方法parameterTest输入参数前加@Optional注解，给myName一个默认的初始值如下：

package com.fastjrun.example.testng;
　　import org.testng.annotations.Optional;
　　import org.testng.annotations.Parameters;
　　import org.testng.annotations.Test;
　　public class ParameterizedTest1 {
　　 @Test
　　 @Parameters("myName")
　　 public void parameterTest(@Optional("optional") String myName) {
　　 System.out.println("Parameterized value is : " + myName);
　　 }
　　}

复制代码

另外就是使用-D命令行参数。
　　使用注解Parameters配合-D命令行参数
　　使用-D命令行参数就是让参数以系统参数的方式加载入JVM，该方式支持Java、Maven命令行执行。idea配置-D命令行参数的方式如下：

使用注解DataProvider
　　我们先写一个业务类PrimeNumberChecker如下所示，该类中只有一个方法validate，检查输入参数primeNumber是否为质数，如果是返回True，如果不是返回False。

　　src/main/java/com/fastjrun.example/testng/PrimeNumberChecker.java

复制代码

package com.fastjrun.example.testng;
　　public class PrimeNumberChecker {
　　 public Boolean validate(final Integer primeNumber) {
　　 for (int i = 2; i < (primeNumber / 2); i++) {
　　 if (primeNumber % i == 0) {
　　 return false;
　　 }
　　 }
　　 return true;
　　 }
　　}

复制代码

再写一个测试类PrimeNumberCheckerTest：
　　定义一个方法primeNumbers(), 该方法返回值是一个对象数组，该方法使用了注解DataProvider，其值为test1，方法体中只是简单返回了一个新建的对象数据。
　　新增一个方法 testPrimeNumberChecker()，该方法定义了两个输入参数整型变量inputNumber和布尔变量expectedResult。该方法体调用PrimeNumberChecker的validate方法，来验证inputNumber为质数的结果是否为expectedResult。
　　方法 testPrimeNumberChecker()其实是一个测试用例，该方法使用注解@Test(dataProvider = "test1")，表明该测试用例的dataProvider设置为test1，也就是说在执行该测试用例的时候，会使用primeNumbers()返回的对象数组为该方法的输入参数分别赋值。

　　src/test/java/com/fastjrun.example/testng/PrimeNumberCheckerTest.java

复制代码

　package com.fastjrun.example.testng;
　　import org.testng.Assert;
　　import org.testng.annotations.BeforeMethod;
　　import org.testng.annotations.DataProvider;
　　import org.testng.annotations.Test;
　　public class PrimeNumberCheckerTest {
　　 private PrimeNumberChecker primeNumberChecker;
　　 @BeforeMethod
　　 public void initialize() {
　　 primeNumberChecker = new PrimeNumberChecker();
　　 }
　　 @DataProvider(name = "test1")
　　 public Object[][] primeNumbers() {
　　 return new Object[][] {{2, true}, {6, false}, {19, true}, {22, false}, {23, true}};
　　 }
　　 // This test will run 4 times since we have 5 parameters defined
　　 @Test(dataProvider = "test1")
　　 public void testPrimeNumberChecker(Integer inputNumber, Boolean expectedResult) {
　　 System.out.println(inputNumber + " " + expectedResult);
　　 Assert.assertEquals(expectedResult, primeNumberChecker.validate(inputNumber));
　　 }
　　}

复制代码

在PrimeNumberCheckerTest类编辑窗口选中需要测试的方法名testPrimeNumberChecker，点击鼠标右键弹出下拉菜单后，从中选择“Run testPrimeNumberChecker()”即可执行该单元测试用例。

执行结果如下：

　2 true
　　6 false
　　19 true
　　22 false
　　23 true
　　===============================================
　　Default Suite
　　Total tests run: 5, Passes: 5, Failures: 0, Skips: 0
　　===============================================

复制代码

从结果可以看出，该测试用例通过DataProvider一次性注入了5组测试数据。这种特性非常有助于我们在研发过程中采用TDD（测试驱动开发）。关于TDD，并不是本文探讨的内容，这里就不展开了。

		自动登录	找回密码
密码			(注-册)加入51Testing

[转贴] TestNG 参数化测试实践指南

本帖子中包含更多资源

站长推荐 /1