TestNG 参数化测试实践指南

发表于:2022-8-01 09:45

字体: | 上一篇 | 下一篇 | 我要投稿

 作者:崔莹峰    来源:51CTO博客

  参数化测试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 &apos;myName&apos; is required by @Test 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小编(021-64471599-8017),我们将立即处理
《2023软件测试行业现状调查报告》独家发布~

关注51Testing

联系我们

快捷面板 站点地图 联系我们 广告服务 关于我们 站长统计 发展历程

法律顾问:上海兰迪律师事务所 项棋律师
版权所有 上海博为峰软件技术股份有限公司 Copyright©51testing.com 2003-2024
投诉及意见反馈:webmaster@51testing.com; 业务联系:service@51testing.com 021-64471599-8017

沪ICP备05003035号

沪公网安备 31010102002173号