TestNG提供了2种传递参数的方式
第一种: testng.xml 方式使代码和测试数据分离,方便维护
第二种:@DataProvider能够提供比较复杂的参数。 (也叫data-driven testing)
使用 testng.xml 设置参数
创建测试案例类
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="ParameterizedTest1" />
</classes>
</test>
</suite>
在这段代码中,可以让 myName 参数能够接到XML文件中叫做 myName参数的值。这个XML参数被定义在 testng.xml
或者也可以用在@Before/After和@Factory注解上:
@Parameters({ "datasource", "jdbcDriver" })
@BeforeMethod
public void beforeTest(String ds, String driver) {
m_dataSource = ...; // 查询数据源的值
m_jdbcDriver = driver;
}
有两个Java参数ds
和driver
会分别接收到来自属性datasource
和jdbc-driver
所指定的值。
参数也可以通过 Optional 注释来声明:
@Parameters("db")
@Test
public void testNonExistentParameter(@Optional("mysql") String db) { ... }
如果在你的testng.xml文件中没有找到"db"
,你的测试方法就会使用 @Optional
中的值:"mysql"
@Parameters
可以被放置到如下位置:
在任何已经被@Test, @Before/After或@Factory注解过的地方。
在测试类中至多被放到一个构造函数签。这样,TestNG才能在需要的时候使用 testng.xml 中特定的参数来实例化这个类。这个特性可以被用作初始化某些类中的值,以便稍后会被类中其他的方法所使用。
注意:
XML中的参数会按照Java参数在注解中出现的顺序被映射过去,并且如果数量不匹配,TestNG会报错。
参数是有作用范围的。在testng.xml中,即可以在<suite> 标签下声明,也可以在 <test>下声明。如果两个参数都有相同的名字,那么,定义在 <test> 中的有优先权。这在需要覆盖某些测试中特定参数的值时,会非常方便。
使用DataProviders提供参数
在 testng.xml 中指定参数可能会有如下的不足:
可能不用testng.xml.
需要传递复杂的参数,或者从Java中创建参数(复杂对象,对象从属性文件或者数据库中读取的etc...)
可以使用Data Provider来给需要的测试提供参数。
所谓数据提供者,就是一个能返回对象数组的数组的方法,
并且这个方法被@DataProvider注解标注:
//这个方法会服务于任何把它(测试方法)的数据提供者的名字为"test1"方法
@DataProvider(name = "test1")
public Object[][] createData1() {
return new Object[][] {
{ "Cedric", new Integer(36) },
{ "Anne", new Integer(37)},
};
}
//这个测试方法,声明其数据提供者的名字为“test1”
@Test(dataProvider = "test1")
public void verifyData1(String n1, Integer n2) {
System.out.println(n1 + " " + n2);
}
结果会打印
Cedric 36
Anne 37
被@Test标注的方法通过dataProvider
属性指明其数据提供商。这个名字必须与@DataProvider(name="...")
中的名字相一致
默认的情况下,数据提供者会查找当前的测试类或者测试类的基类。如果你希望它能够被其他的类所使用,那么就要将其指定为static
,并且通过 dataProviderClass
属性指定要使用的类:
public 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
方法可以返回如下两种类型中的一种:
含有多个对象的数组(Object[][]),其中第一个下标指明了测试方法要调用的次数,第二个下标则完全与测试方法中的参数类型和个数相匹配。上面的例子已经说明。
另外一个是迭代器Iterator<Object[]>。二者的区别是迭代器允许你延迟创建自己的测试数据。TestNG会调用迭代器,之后测试方法会一个接一个的调用由迭代器返回的值。在需要传递很多参数组给测试组的时候,这样就无须提前创建一堆值。
迭代器功能的例子:
@DataProvider(name = "test1")
public Iterator<Object[]> createData() {
return new MyIterator(DATA);
}
如果声明的@DataProvider使用java.lang.reflect.Method作为第一个参数,TestNG 会把当前的测试方法当成参数传给第一个参数。这一点在多个测试方法使用相同的@DataProvider的时候,并且你想要依据具体的测试方法返回不同的值时,特别有用
例如,下面的代码它内部的@DataProvider
中的测试方法的名字:
@DataProvider(name = "dp")
public Object[][] createData(Method m) {
System.out.println(m.getName()); // print test method name
return new Object[][] { new Object[] { "Cedric" }};
}
@Test(dataProvider = "dp")
public void test1(String s) {
}
@Test(dataProvider = "dp")
public void test2(String s) {
}
显示:
test1
test2
例子:
package TankLearn2.Learn;
import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;
public class DataProviderLearn {
@DataProvider(name="user")
public Object[][] Users(){
return new Object[][]{
{"root","passowrd"},
{"cnblogs.com", "tankxiao"},
{"tank","xiao"}
};
}
@Test(dataProvider="user")
public void verifyUser(String userName, String password){
System.out.println("Username: "+ userName + " Password: "+ password);
}
}
Data provider可以通过属性parallel
实现并行运行:
@DataProvider(parallel = true)
// ...
使用XML文件运行的data provider
享有相同的线程池,默认的大小是10。你可以通过修改该在<suite>标签中的值来更改:
<suite name="Suite1" data-provider-thread-count="20" >
...
如果需要让指定的几个data provider
运行在不同的线程中,那么就必须通过不同的xml文件来运行。