Testng 简明教程

TestNG - Parameterized Test

TestNG 中另一项有趣的功能是 parametric testing 。大多数情况下，您会遇到需要大量测试的业务逻辑的情况。 Parameterized tests 允许开发人员使用不同的值反复运行同一测试。

TestNG 让您通过两种不同方式直接将参数传给测试方法 -

With testng.xml
With Data Providers

Passing Parameters with testng.xml

使用这种方法，您可以在 testng.xml 文件中定义简单参数，然后在源文件中引用这些参数。我们举一个示例来说明如何使用这种方法传递参数。

Create Test Case Class

创建一个 java 测试类，例如，ParameterizedTest1.java。
向测试类添加 test method parameterTest()。此方法以一个字符串作为输入参数。
向此方法添加注释 @Parameters("myName")。该参数将从 testng.xml 传递一个值，我们将在下一步中看到。

在 /work/testng/src 中创建名为 ParameterizedTest1.java 的 Java 类文件。

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);
   }
}

Create testng.xml

在 /work/testng/src 中创建 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 = "ParameterizedTest1" />
      </classes>

   </test>
</suite>

我们还可以在 <suite> 级别定义参数。假设我们在 <suite> 和 <test> 级别都定义了 myName。在这种情况下，常规范围规则适用。这意味着 <test> 标签内的任何类都会看到 <test> 中定义的参数值，而 testng.xml 文件中的其余类将看到 <suite> 中定义的值。

使用 javac 编译测试用例类。

/work/testng/src$ javac ParameterizedTest1.java

现在，运行 testng.xml，该文件将运行 parameterTest 方法。TestNG 将尝试首先在 <test> 标签中查找名为 myName 的参数，如果找不到，它将在包含它的 <suit> 标签中搜索。

/work/testng/src$ java org.testng.TestNG testng.xml

验证输出。

Parameterized value is : manisha

===============================================
Suite1
Total tests run: 1, Failures: 0, Skips: 0
===============================================

TestNG 会自动尝试将 testng.xml 中指定的值转换为参数的类型。以下为支持的类型 -

String
int/Integer
boolean/Boolean
byte/Byte
char/Character
double/Double
float/Float
long/Long
short/Short

Passing Parameters with Dataproviders

当您需要传递复杂参数或需要通过 Java 创建的参数（复杂对象、从属性文件或数据库读取的对象等）时，可以使用数据提供器传递参数。

数据提供器是一个用 @DataProvider 注释的方法。此注释只有一个字符串属性：其名称。如果未提供名称，则数据提供程序的名称自动默认为方法的名称。数据提供程序返回一个对象数组。

以下示例演示了如何使用数据提供程序。第一个示例是关于将 Vector、String 或 Integer 作为参数使用 @DataProvider 的，第二个示例是关于将对象作为参数使用 @DataProvider 的。

Example 1

在这里，@DataProvider 将 Integer 和 Boolean 作为参数传递。

Create Java class

创建名为 PrimeNumberChecker.java 的 Java 类。此类检查该数字是否是质数。在 /work/testng/src 中创建此类。

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

Create Test Case Class

在 /work/testng/src 中创建 Java 测试类，例如 ParamTestWithDataProvider1.java 。
定义方法 primeNumbers()，它被定义为使用注解的数据提供者。此方法返回一个对象数组。
将测试方法 testPrimeNumberChecker() 添加到你的测试类中。此方法接受一个整数和一个布尔值作为输入参数。此方法验证传递的参数是否为素数。
将注解 @Test(dataProvider = "test1") 添加到此方法。属性 dataProvider 映射到“test1”。

以下为 ParamTestWithDataProvider1.java 的内容。

import org.testng.Assert;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;

public class ParamTestWithDataProvider1 {
   private PrimeNumberChecker primeNumberChecker;

   @BeforeMethod
   public void initialize() {
      primeNumberChecker = new PrimeNumberChecker();
   }

   @DataProvider(name = "test1")
   public static 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));
   }
}

Create testng.xml

创建 /work/testng/src 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">
      <classes>
         <class name = "ParamTestWithDataProvider1" />
      </classes>
   </test>
</suite>

使用 javac 编译测试用例类。

/work/testng/src$ javac ParamTestWithDataProvider1.java PrimeNumberChecker.java

现在，运行 testng.xml。

/work/testng/src$ java org.testng.TestNG testng.xml

验证输出。

   2 true
   6 false
   19 true
   22 false
   23 true

===============================================
   Suite1
   Total tests run: 5, Failures: 0, Skips: 0
===============================================

Example 2

此处，@DataProvider 将对象作为参数传递。

Create Java class

在 /work/testng/src 中创建 Java 类 Bean.java，它是一个带有 get/set 方法的简单对象。

public class Bean {
   private String val;
   private int i;

   public Bean(String val, int i) {
      this.val = val;
      this.i = i;
   }

   public String getVal() {
      return val;
   }

   public void setVal(String val) {
      this.val = val;
   }

   public int getI() {
      return i;
   }

   public void setI(int i) {
      this.i = i;
   }
}

Create Test Case Class

创建一个 java 测试类，例如 ParamTestWithDataProvider2.java。
定义方法 primeNumbers()，它被定义为使用注解的数据提供者。此方法返回一个对象数组。
将测试方法 testMethod() 添加到你的测试类中。此方法接受一个对象 bean 作为参数。
将注解 @Test(dataProvider = "test1") 添加到此方法。属性 dataProvider 映射到“test1”。

在 /work/testng/src 中创建名为 ParamTestWithDataProvider2.java 的 Java 类文件。

import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;

public class ParamTestWithDataProvider2 {
   @DataProvider(name = "test1")
   public static Object[][] primeNumbers() {
      return new Object[][] { { new Bean("hi I am the bean", 111) } };
   }

   @Test(dataProvider = "test1")
   public void testMethod(Bean myBean) {
      System.out.println(myBean.getVal() + " " + myBean.getI());
   }
}

Create testng.xml

在 /work/testng/src 中创建 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">
      <classes>
         <class name = "ParamTestWithDataProvider2" />
      </classes>
   </test>
</suite>

使用 javac 编译测试用例类。

/work/testng/src$ javac ParamTestWithDataProvider2.java Bean.java

现在，运行 testng.xml。

/work/testng/src$ java org.testng.TestNG testng.xml

验证输出。

   hi I am the bean 111

===============================================
   Suite1
   Total tests run: 1, Failures: 0, Skips: 0
===============================================