【转载】TestNG指南5-测试方法、测试类与测试组

偏执的太偏执、 2022-05-14 09:26 211阅读 0赞

**5.1 – ****测试组****(Test groups)**

TestNG允许执行复杂的测试方法分组。不仅可以申明方法属于组，而且可以指定组包含其他组。然后TestNG可以被调用，并被要求包含某些组（或正则表达式）和排除其他的组。如果想要紧接着运行两个不同的测试配置，这将给如何划分测试的带来了最大的灵活性，且不需要重新编译。

例如，非常普遍的需要至少两种测试：

*  检入(Check-in)测试：这些测试将在提交新代码之前运行，要求测试能够快速完成，仅确信没有破坏基础功能。
 *  功能测试：这些测试应该覆盖软件的所有功能，并且每日至少运行一次，尽管理想的是持续运行。

检入测试是功能测试的子集， TestNG 允许使用测试组以非常直接的方式说明这点。例如：你可以这样构造测试，通过申明整个测试类属于“functest”组，另外两个方法属于“checkintest”组：

调用TestNG使用：

将运行测试类中的所有方法，而使用checkintest调用将只运行testMethod1() 和testMethod2().

下面是另外一个例子，这次使用了正则表达式。假设某些测试方法不能在Linux下运行，测试可能这样写：

你可以使用下面的testng.xml只运行Windows方法:

*注意: TestNG 使用[正则表达式][Link 1]，而不使用[wildmats][]。要知道这个差别（例如：用“.\*”匹配“所有”——圆点星号，而不是“\*”）。*

***方法组(Method groups******)***

*** ***

也可以排除或包括个别方法：

这在屏蔽单个方法而不用重新编译任何代码时就能派得上用场。但并不推荐用得太多，因为在你开始重构Java代码（在标签中使用的正则表达式可能不再匹配测试方法）时，它往往会破坏你的测试框架。

**5.2 – ****组中组（Groups of groups****）**

组也可以包含其他组，这些组被称为“MetaGroups”。例如：你可能想要定义一个“all”组，包括“checkintest”和 “functest”。“functest”自身将包含“windows” 和 “linux”组，而“checkintest”将只包含“windows”。在你的属性文件中应该这样定义：

<table style="color:#333333;font-size:14px;line-height:26px;text-align:left;border:medium none;border-collapse:collapse;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> &lt;test&nbsp;name="Regression1"&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;groups&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;define&nbsp;name="functest"&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;include&nbsp;name="windows"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;include&nbsp;name="linux"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/define&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;define&nbsp;name="all"&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;include&nbsp;name="functest"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;include&nbsp;name="checkintest"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/define&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;run&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;include&nbsp;name="all"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/run&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/groups&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;classes&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;class&nbsp;name="test.sample.Test1"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/classes&gt; &lt;/test&gt; </td> 
 </tr> 
 </tbody> 
</table>

**5.3 – ****排除组（Exclusion groups****）**

TestNG 允许包含组也允许排除组.

例如：因为最近的修改还没来得及修复它们时，让测试临时中断就非常有用。然而，想要干净地运行功能测试，你得屏蔽掉这些测试，但是记住它们将来需要被重新激活。

解决这个问题的简单办法是建立一个“broken”组，并让这些测试方法属于它。例如：在上例中，我知道testMethod2() 现在被破坏了，所有我想屏蔽它：

现在我所需要做的只是在运行中排除这个组：

用这种方法，我将得到一个干净的测试运行，同时记录了那些被屏蔽并需要后续修复的测试。

*注意：你也可以使用@Test和@Before/After注解的“enabled”属性，个别地屏蔽测试。*

**5.4 – ****部分组（Partial groups****）**

你可以在类级别上定义组，然后在方法级别上添加组：

在这个类中，method2() 属于“checkin-test”组，在类的级别上定义。而method1() 同时属于“checkin-test”和“func-test”组.

**5.5 – ****参数**

测试方法不一定没有参数，你可以在每个测试方法上使用任意数目的参数，并使用@Parameters注解让TestNG传递正确的参数。

设置参数有两种方式：使用testng.xml或者编码。

*5.5.1 – **用testng.xml**传递参数*

如果参数使用简单值，可以在testng.xml 中指定它:

在这段代码中，我们指定Java方法的参数firstName应该接收被称为first-name的XML参数的值，XML参数在testng.xml中定义:

上述技法同样可用于@Before/After和@Factory注解:

这次，两个Java参数*ds*和*driver* 将分别接收属性datasource和jdbc-driver的值。

使用@Optional注解，可将参数定义为可选:

如果在testng.xml文件中没有找到名为“db” 的参数，测试方法将接收由@Optional注解指定的默认值“mysql”。

@Parameters注解可用于以下情形：

*  已有@Test、@Before/After或 @Factory注解的任何一个方法.
 *  测试类有且仅有一个构造器。在该情形下，无论测试是否需要实例化，TestNG将调用带有参数的特殊构造器，初始化指定在testng.xml 的值。本特性可用来初始化类的属性值，然后在测试方法中使用。

*注意:*

·   *XML**参数被按照注解中的相同顺序映射成Java参数，如果数目不匹配TestNG将报错。*

·   *参数有范围限制。在testng.xml 中，既可以在<suite>标签也可以在<test>下定义参数。如果两个参数有相同的名称，则在<test>标签下的参数优先。这是很方便的，如果希望指定一个参数可适用于整个测试，且只在某个测试中覆盖它的值。*

*5.5.2 - **用DataProviders**传递参数*

在testng.xml中指定参数，在以下情形下可能存在不足：

*  没有使用testng.xml.
 *  需要传递复杂的参数，或者参数需要由Java创建（复杂对象、从属性文件或数据库读取对象，等等……）.

在这些情形下，可以使用数据供应者为测试提供需要的值。数据供应者是Java类中返回二维数组对象的一个方法。本方法使用@DataProvider 注解:

<table style="color:#333333;font-size:14px;line-height:26px;text-align:left;border:medium none;border-collapse:collapse;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;//This method will provide data to any test method that declares that its Data Provider &nbsp;&nbsp;&nbsp;&nbsp;//is named "test1" &nbsp;&nbsp;&nbsp;&nbsp;@DataProvider(name =&nbsp;"test1") &nbsp;&nbsp;&nbsp;&nbsp;public&nbsp;Object[][] createData1() { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;new&nbsp;Object[][] { {&nbsp;"Cedric",&nbsp;new&nbsp;Integer(36) }, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;"Anne",&nbsp;new&nbsp;Integer(37) }, }; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;//This test method declares that its data should be supplied by the Data Provider &nbsp;&nbsp;&nbsp;&nbsp;//named "test1" &nbsp;&nbsp;&nbsp;&nbsp;@Test(dataProvider =&nbsp;"test1") &nbsp;&nbsp;&nbsp;&nbsp;public&nbsp;void&nbsp;verifyData1(final&nbsp;String n1,&nbsp;final&nbsp;Integer n2) { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.out.println(n1 +&nbsp;" "&nbsp;+ n2); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

将打印：

测试方法用@Test注解的dataProvider属性指定其数据供应者。名称必须与数据供应者类中用@DataProvider(name="...")注解的名称一致.

缺少情况下，数据供应者将查找当前测试类或其基类。如果想要将数据供应者放在不同的类，则必须是一个静态方法，并在dataProviderClass 属性中指定该类:

数据供应者方法可能返回下列两种类型之一:

* 二维数组对象(Object\[\]\[\])，其第一维大小是测试方法将要调用的次数，二维大小包含一个与测试方法的参数类型一致的对象排列（如上例所示）。
 * Iterator<Object\[\]>，与Object\[\]\[\]的唯一不同是Iterator允许延迟创建测试数据。TestNG将调用迭代器，然后带参数的测试方法靠迭代器一个接一个地返回参数值。如果你有大量的参数集传递到方法并且不想像前面那样创建它们，则使用Iterator<Object\[\]>就特别有用。

下面是本特性在JDK 1.4和JDK5(注意：JDK1.4示例未使用范型)下的例子：

[Link 1]: http://en.wikipedia.org/wiki/Regular_expression
[wildmats]: http://en.wikipedia.org/wiki/Wildmat