Java自动化测试框架-04 - TestNG之Test Method篇

简介
按照上一篇的计划，这一篇给小伙伴们分享一下测试方法。

一、设置参数
测试方法是可以带有参数的。每个测试方法都可以带有任意数量的参数，并且可以通过使用TestNG的@Parameters向方法传递正确的参数。

设置方式有两种方法：使用testng.xml或者Data Providers 。

（一）使用 testng.xml 设置参数
这种方法让我们在testng.xml文件中，定义简单的参数，然后在源码文件引用这些参数。

1.如果只使用相对简单的参数，可以在 testng.xml文件中指定：

package hongge;

import org.testng.annotations.Test;
import static org.testng.Assert.assertEquals;
import hongge.TestSum;

@Parameters({ “first-name” })
@Test
public void testSingleString(String firstName) {
System.out.println("Invoked testString " + firstName);
assert “Cedric”.equals(firstName);
}

在这段代码中，我们让 firstName 参数能够接到XML文件中叫做 first-name 参数的值。这个XML参数被定义在 testng.xml：

类似的，它也可以用在 @Before/After 和 @Factory 注解上：

这次有两个Java参数 ds 和 driver 会分别接收到来自属性datasource 和 jdbc-driver 所指定的值。

2.参数也可以通过 Optional 注释来声明：

如果在你的testng.xml文件中没有找到"db"，你的测试方法就会使用 @Optional 中的值：“MySQL”。

3.@Parameters 可以被放置到如下位置：

(1)在任何已经被 @Test, @Before/After 或 @Factory 注解过的地方。

(2)在测试类中至多被放到一个构造函数签。这样，TestNG才能在需要的时候使用 testng.xml 中特定的参数来实例化这个类。这个特性可以被用作初始化某些类中的值，以便稍后会被类中其他的方法所使用。

注意：

XML中的参数会按照Java参数在注解中出现的顺序被映射过去，并且如果数量不匹配，TestNG会报错。

参数是有作用范围的。在testng.xml 中，你即可以在标签下声明，也可以在下声明。如果两个参数都有相同的名字，那么，定义在中的有优先权。这在你需要覆盖某些测试中特定参数的值时，会非常方便。

（二）使用DataProviders提供参数
在testng.xml 中指定参数可能会有如下的不足：

1.如果你压根不用 testng.xml.

2.你需要传递复杂的参数，或者从Java中创建参数（复杂对象，对象从属性文件或者数据库中读取的etc…）或者在testng.xml中指定参数可能不够

这样的话，你就可以使用Data Provider来给需要的测试提供参数。所谓数据提供者，就是一个能返回对象数组的数组的方法，并且这个方法被@DataProvider注解标注：

DataProvider的定义如下：

package hongge;

import org.testng.annotations.Test;
import static org.testng.Assert.assertEquals;
import hongge.TestSum;

@DataProvider(name = “range-provider”)
public Object[][] rangeData() {
int lower = 5;
int upper = 10;
return new Object[][] {
{ lower-1, lower, upper, false },
{ lower, lower, upper, true },
{ lower+1, lower, upper, true },
{ upper, lower, upper, true},
{ upper+1, lower, upper, false },
};
}

调用DataProvider的方式如下：

package hongge;

import org.testng.annotations.Test;
import static org.testng.Assert.assertEquals;
import hongge.TestSum;

@Test(dataProvider = “range-provider”)
public void testIsBetween(int n, int lower,int upper, boolean expected){
println("Received " + n + " " + lower + “-”+ upper + " expected: " + expected);
Assert.assertEquals(expected, isBetween(n, lower, upper));
}

被@Test标注的方法通过dataProvider属性指明其数据提供商。这个名字必须与@DataProvider(name="…")中的名字相一致。

DataProvider返回的是一个Object的二维数组，二维数组中的每个一维数组都会传递给调用函数，作为参数使用。运行的时候，会发现， @Test标识的test method被执行的次数和object[][]包含的一维数组的个数是一致的，而@Test标识的函数的参数个数，也和object内一维数组内的元素数是一致的。

（三）DataProviders扩展
默认的情况下，数据提供者会查找当前的测试类或者测试类的基类。如果你希望它能够被其他的类所使用，那么就要将其指定为static，并且通过 dataProviderClass 属性指定要使用的类：

package hongge;

import org.testng.annotations.Test;
import static org.testng.Assert.assertEquals;
import hongge.TestSum;

public static class StaticProvider {
@DataProvider(name = “create”)
public static Object[][] createData() {
return new Object[][] {
new Object[] { new Integer(42) }
}
}
}
public class MyTest {
@Test(dataProvider = “create”, dataProviderClass = StaticProvider.class)
public void test(Integer n) {
// …
}
}

Data Provider方法可以返回如下两种类型中的一种：

1.含有多个对象的数组 (Object[][])，其中第一个下标指明了测试方法要调用的次数，第二个下标则完全与测试方法中的参数类型和个数相匹配。上面的例子已经说明。

2.另外一个是迭代器 Iterator<Object[]>。二者的区别是迭代器允许你延迟创建自己的测试数据。TestNG会调用迭代器，之后测试方法会一个接一个的调用由迭代器返回的值。在你需要传递很多参数组给测试组的时候，这样你无须提前创建一堆值。

下面是使用JDK5 的例子 (注意 JDK 1.4的例子不适用泛型)：

如果你声明的 @DataProvider 使用 java.lang.reflect.Method 作为第一个参数，TestNG 会把当前的测试方法当成参数传给第一个参数。这一点在你的多个测试方法使用相同的@DataProvider的时候，并且你想要依据具体的测试方法返回不同的值时，特别有用。

例如，下面的代码它内部的 @DataProvider 中的测试方法的名字：

所以会显示：

test1

test2

Data provider可以通过属性 parallel实现并行运行：

使用XML文件运行的data provider享有相同的线程池，默认的大小是10.你可以通过修改该在标签中的值来更改：

<suitename=“Suite1” data-provider-thread-count=“20” >

如果你需要让指定的几个data provider运行在不同的线程中，那么就必须通过不同的xml文件来运行。

（四）两种方法的优缺点
testng.xml
优点：值在testng.xml中指定，这方便修改，不需要重新编译代码；

缺点：你需要一个testng.xml文件，值不能够动态算出

数据提供者
优点：可以想测试方法传递任何有效的Java类型这种方法非常灵活，值可以通过Java代码动态算出，或者任何存储机制中取得

缺点：这种方法需要实现某些逻辑，以返回正确的对象

二、依赖方法
有些时候，需要按照特定顺序调用测试方法。

1.确保在进行更多的方法测试之前，有一定数量的测试方法已经成功完成。

2.在初始化测试的时候，同时希望这个初始化方法也是一个测试方法（ @Before/After 不会出现在最后生成的报告中）。

为此，你可以使用 @Test 中的 dependsOnMethods 或 dependsOnGroups 属性。

这两种依赖：

1.Harddependencies（硬依赖）。所有的被依赖方法必须成功运行。只要有一个出问题，测试就不会被调用，并且在报告中被标记为SKIP。

2.Softdependencies（软依赖）。即便是有些依赖方法失败了，也一样运行。如果你只是需要保证你的测试方法按照顺序执行，而不关心他们的依赖方法是否成功。那么这种机制就非常有用。可以通过添加 “alwaysRun=true” 到 @Test 来实现软依赖。

硬依赖的例子：

此例中，method1() 依赖于方法 serverStartedOk()，从而保证 serverStartedOk() 总是先运行。

也可以让若干方法依赖于组：

本例中,method1()依赖于匹配正则表达式"init.*"的组,由此保证了serverStartedOk()和initEnvironment()总是先于method1()被调用。

注意：正如前面所说的那样，在相同组中的调用可是在夸测试中不保证顺序的。

如果你使用硬依赖，并且被依赖方法失败(alwaysRun=false，即默认是硬依赖)，依赖方法则不是被标记为FAIL而是SKIP。被跳过的方法会被在最后的报告中标记出来（HTML既不用红色也不是绿色所表示），主要是被跳过的方法不是必然失败，所以被标出来做以区别。

无论dependsOnGroups还是dependsOnMethods都可以接受正则表达式作为参数。对于dependsOnMethods，如果被依赖的方法有多个重载，那么所有的重载方法都会被调用。如果你只希望使用这些重载中的一个，那么就应该使用dependsOnGroups。

三、类级注解
通常 @Test 也可以用来标注类，而不仅仅是方法：

处于类级的 @Test 会使得类中所有的public方法成为测试方法，而不管他们是否已经被标注。当然，你仍然可以用 @Test 注解重复标注测试方法，特别是要为其添加一些特别的属性时。

例如：

上例中 test1() 和 test2() 都被处理，不过在此之上 test2() 现在还属于组 “g1”。

Java自动化测试框架-04 - TestNG之Test Method篇 - （详细教程）相关推荐

Java自动化测试框架-09 - TestNG之依赖注入篇（详细教程）
1.-依赖注入 TestNG支持两种不同类型的依赖项注入:本机(由TestNG本身执行)和外部(由诸如Guice的依赖项注入框架执行). 1.1-本机依赖项注入 TestNG允许您在方法中声明其他参数 ...
Java自动化测试框架-10 - TestNG之测试结果篇（详细教程）
1.-测试结果 1.1-成功,失败和断言测试被认为是成功的,如果它不引发任何异常完成,还是它扔的预期异常(请参阅文档expectedExceptions属性上找到的@Test注释). 您的测试方法通 ...
Java自动化测试框架-03 - TestNG之Test Group篇 - （详细教程）
简介其实这篇文章的group宏哥在上一篇中就提到过,但是就是举例一笔带过的,因此今天专门有一篇文章来讲解Group的相关知识.希望大家茅塞顿开 ,有着更进一步认识和了解测试组. 一.Test Gro ...
java自动化测试报告_Java自动化测试框架-10 - TestNG之测试结果篇（详细教程）
1.-测试结果 1.1-成功,失败和断言测试被认为是成功的,如果它不引发任何异常完成,还是它扔的预期异常(请参阅文档expectedExceptions属性上找到的@Test注释). 您的测试方法通 ...
java testng 优化_Java自动化测试框架-10 - TestNG之测试结果篇（详细教程）
1.-测试结果 1.1-成功,失败和断言测试被认为是成功的,如果它不引发任何异常完成,还是它扔的预期异常(请参阅文档expectedExceptions属性上找到的@Test注释). 您的测试方法通 ...
Java自动化测试框架-11 - TestNG之annotation与并发测试篇（详细教程）
1.简介 TestNG中用到的annotation的快速预览及其属性. 2.TestNG基本注解(注释) 注解描述 @BeforeSuite 注解的方法只运行一次,在当前suite所有测试执行之前执 ...
Java自动化测试框架-01 - TestNG之入门篇 - （详细教程）
TestNG是什么? TestNG按照官方的定义: TestNG是一个测试框架,其灵感来自JUnit和NUnit,但引入了一些新的功能,使其功能更强大,使用更方便. TestNG是一个开源自动化测试框 ...
Java自动化测试框架-08 - TestNG之并行性和超时篇（详细教程）
一.并行性和超时您可以指示TestNG以各种方式在单独的线程中运行测试. 可以通过在suite标签中使用 parallel 属性来让测试方法运行在不同的线程中.这个属性可以带有如下这样的值: 二.并 ...
Java自动化测试框架-02 - TestNG之理论到实践 - （详细教程）
理论 TestNG,即Testing, NextGeneration,下一代测试技术,是一套根据JUnit 和NUnit思想而构建的利用注释来强化测试功能的一个测试框架,即可以用来做单元测试,也可以用 ...

Java自动化测试框架-04 - TestNG之Test Method篇 - （详细教程）

Java自动化测试框架-04 - TestNG之Test Method篇 - （详细教程）相关推荐

最新文章

热门文章