5.6 - Dependent methods
有些时候,你需要你的测试方法按照一个特定的顺序被调用。这非常有用,比如:
* 在运行更多测试方法前确认特定数量的测试方法调用完成并且成功
* 初始化测试并希望这个初始化方法也作为测试方法(被标记为@Before/After的方法将不作为最终报告的一部分)
为了做到这点,需要使用@Test注解的dependsOnMethods属性或者dependsOnGroups属性。
有两种依赖:
* 强依赖。在运行你的测试方法前所有依赖方法必须运行并且成功。哪怕有一个依赖方法失败,测试方法都不会被调用,在报告中将被标记为SKIP。
* 软依赖。测试方法在依赖方法运行后总是会被运行,即使某些依赖方法失败。对于只想确认测试方法是按照特定顺序运行,而测试方法并不真正依赖其他方法是否成功的情况,非常有用。软依赖通过在@Test注解中增加"alwaysRun=true"来实现。
这里有一个强依赖的例子:
@Test
public void serverStartedOk() {}
@Test(dependsOnMethods = { "serverStartedOk" })
public void method1() {}
在这个例子中,method1()被申明依赖于方法serverStartedOk(),这保证serverStartedOk() 方法将总是首先被调用。
也可以让方法依赖于完整的测试组:
@Test(groups = { "init" })
public void serverStartedOk() {}
@Test(groups = { "init" })
public void initEnvironment() {}
@Test(dependsOnGroups = { "init.* })
public void method1() {}
在这里例子中,method1()被申明依赖于任何匹配正则表达式"init.*"的组,这保证了方法serverStartedOk()和initEnvironment()总是在method1()前被调用。
注意:前面说明说,在测试运行期间,属于同一个组的方法的调用顺序并不保证相同。如果一个方法的依赖失败了,而且是强依赖(默认alwaysRun=false),这个方法将不被标记为FAIL而是SKIP。被跳过的方法在最终的报告中报告(在HTML中用红和绿之外的其他颜色),这很重要,因为被跳过的方法并不一定是失败。
dependsOnGroups和dependsOnMethods都接受正则表达式作为参数。对于dependsOnMethods, 如果你依赖的方法巧合有多个重载的版本,所有装载的方法都将被调用。如果你只想调用重载的方法中的一个,请使用dependsOnGroups。
有关方法依赖的更高级的例子,请参考本文档,将使用继承来提供一个优雅的解决方案来处理多重依赖的问题。
5.7 - Factories
工厂类容许你动态创建测试案例。例如,想象你需要创建一个测试方法,访问一个web站点上的页面很多次,而你希望用不同的值来调用它:
public class TestWebServer {
@Test(parameters = { "number-of-times" })
public void accessPage(int numberOfTimes) {
while (numberOfTimes-- > 0) {
// access the web page
}
}
}
testng.xml:
<test name="T1">
<parameter name="number-of-times" value="10"/>
<class name= "TestWebServer" />
</test>
<test name="T2">
<parameter name="number-of-times" value="20"/>
<class name= "TestWebServer"/>
</test>
<test name="T3">
<parameter name="number-of-times" value="30"/>
<class name= "TestWebServer"/>
</test>
这种方式很快就会变的难于管理,所以作为替换品,你可以使用factory:
public class WebTestFactory {
@Factory
public Object[] createInstances() {
Object[] result = new Object[10];
for (int i = 0; i < 10; i++) {
result[i] = new WebTest(i * 10);
return result;
}
}
而新的测试类是这样:
public class WebTest {
private int m_numberOfTimes;
public WebTest(int numberOfTimes) {
m_numberOfTimes = numberOfTimes;
}
@Test
public void testServer() {
for (int i = 0; i < m_numberOfTimes; i++) {
// access the web page
}
}
}
testng.xml只需要引用简单引用这个包含factory方法的类,因为测试实例将在运行时被创建。
<class name="WebTestFactory" />
工厂类将像@Test和@Before/After一样接收参数,必须返回Object[]。返回的对象可以是任何类(不一定要求是和factory类一样),并且他们甚至都不需要包含TestNG的注解(这种情况下他们将被testNG忽略)。