一、并行性和超时
您可以指示TestNG以各种方式在单独的线程中运行测试。
可以通过在suite标签中使用 parallel 属性来让测试方法运行在不同的线程中。这个属性可以带有如下这样的值:
二、并行套件(suites)
如果您正在运行多个套件文件(例如“ java org.testng.TestNG testng1.xml testng2.xml”),并且希望每个套件在单独的线程中运行,则这个很有用。您可以使用以下命令行标志来指定线程池的大小:
java org.testng.TestNG -suitethreadpoolsize 3 testng1.xml testng2.xml testng3.xml
相应的ant任务名称为suitethreadpoolsize。
三、并行测试,类和方法
在并行于<suite>标记属性可以取下列值之一:
<suite name="My suite" parallel="methods" thread-count="5"> <suite name="My suite" parallel="tests" thread-count="5"> <suite name="My suite" parallel="classes" thread-count="5"> <suite name="My suite" parallel="instances" thread-count="5">
parallel =“ methods”:TestNG将在单独的线程中运行所有测试方法。依赖方法也将在单独的线程中运行,但是它们将遵循您指定的顺序。
parallel =“ tests”:TestNG将在同一线程中的同一<test>标记中运行所有方法,但是每个<test>标记将位于单独的线程中。这样,您就可以将所有不是线程安全的类归入同一个<test>中,并确保它们都将在同一线程中运行,同时利用TestNG使用尽可能多的线程来运行测试。
平行=“类”:TestNG的将运行在相同的线程相同的类的所有方法,但每个类将在单独的线程中运行。
parallel =“ instances”:TestNG将在同一线程中的同一实例中运行所有方法,但是在两个不同实例中的两个方法将在不同线程中运行。
此外,属性 thread-count允许您指定应为此执行分配多少个线程。
注意:@Test属性timeOut在并行和非并行模式下均可工作。
您还可以指定从不同的线程调用@Test方法。您可以使用属性threadPoolSize来实现以下结果:
@Test(threadPoolSize = 3, invocationCount = 10, timeOut = 10000) public void testServer() {
在此示例中,将从三个不同的线程调用函数testServer十次。此外,十秒的超时保证没有任何线程将永远在该线程上阻塞。
四、重新运行失败的测试
每当套件中的测试失败时,TestNG都会在输出目录中创建一个名为testng-failed.xml的文件。此XML文件包含必要的信息,以仅重新运行失败的这些方法,从而使您可以快速重现失败,而不必运行整个测试。因此,典型的会话如下所示:
java -classpath testng.jar;%CLASSPATH% org.testng.TestNG -d test-outputs testng.xml
java -classpath testng.jar;%CLASSPATH% org.testng.TestNG -d test-outputs test-outputs estng-failed.xml
请注意,testng-failed.xml将包含所有必需的依赖方法,因此可以确保您运行失败的方法而不会出现任何SKIP失败。
有时,您可能希望TestNG在测试失败时自动重试。在这种情况下,您可以使用重试分析器。当您将重试分析器绑定到测试时,TestNG会自动调用重试分析器,以确定TestNG是否可以再次重试测试用例,以查看是否刚刚通过的测试现在通过。这是使用重试分析器的方法:
- 构建接口org.testng.IRetryAnalyzer的实现
- 将此实现绑定到@Test注释,例如@Test(retryAnalyzer = LocalRetry.class)
以下是重试分析器的示例实现,该示例最多重试一次测试三次。
import org.testng.IRetryAnalyzer; import org.testng.ITestResult; /** * @author 北京-宏哥 * * Java自动化测试框架-08 - TestNG之 TestNG之并行性和超时篇 * * 2019年11月7日 */ public class MyRetry implements IRetryAnalyzer { private int retryCount = 0; private static final int maxRetryCount = 3; @Override public boolean retry(ITestResult result) { if (retryCount < maxRetryCount) { retryCount++; return true; } return false; } }
import org.testng.Assert; import org.testng.annotations.Test; /** * @author 北京-宏哥 * * Java自动化测试框架-08 - TestNG之 TestNG之并行性和超时篇 * * 2019年11月7日 */ public class TestclassSample { @Test(retryAnalyzer = MyRetry.class) public void test2() { Assert.fail(); } }
五、JUnit测试
TestNG可以运行JUnit 3和JUnit 4测试。所有你需要做的就是把JUnit的jar文件在类路径中,在指定JUnit测试类,testng.classNames 属性和设置testng.junit属性设置为true:
<test name="Test1" junit="true"> <classes> <!-- ... -->
在这种情况下,TestNG的行为类似于JUnit,这取决于在类路径上找到的JUnit版本:
- JUnit 3:
- 您的课程中所有以test *开头的方法都将运行
- 如果您的测试类上有一个方法setUp(),它将在每个测试方法之前调用
- 如果您的测试类上有一个方法tearDown(),它将在每个测试方法之后被调用
- 如果您的测试类包含方法suite(),则将调用此方法返回的所有测试
- JUnit 4:
- TestNG将使用org.junit.runner.JUnitCore运行程序运行测试
六、以编程的方式运行testng
您可以从自己的程序中轻松调用TestNG:
TestListenerAdapter tla = new TestListenerAdapter(); TestNG testng = new TestNG(); testng.setTestClasses(new Class[] { Run2.class }); testng.addListener(tla); testng.run();
本示例创建一个TestNG对象并运行测试类Run2。它还添加了一个TestListener。您可以使用适配器类org.testng.TestListenerAdapter或自己实现org.testng.ITestListener。此接口包含各种回调方法,可让您跟踪测试的开始时间,成功时间,失败时间等。
同样,您可以在testng.xml文件上调用TestNG,也可以自己创建一个虚拟的testng.xml文件。为此,您可以使用发现包org.testng.xml的类: XmlClass,XmlTest等。这些类中的每一个都对应于它们的XML标记对应物。
例如,假设您要创建以下虚拟文件:
<suite name="TmpSuite" > <test name="TmpTest" > <classes> <class name="test.failures.Child" /> <classes> </test> </suite>
您将使用以下代码:
XmlSuite suite = new XmlSuite(); suite.setName("TmpSuite"); XmlTest test = new XmlTest(suite); test.setName("TmpTest"); List<XmlClass> classes = new ArrayList<XmlClass>(); classes.add(new XmlClass("test.failures.Child")); test.setXmlClasses(classes) ;
然后,您可以将此XmlSuite传递给TestNG:
List<XmlSuite> suites = new ArrayList<XmlSuite>(); suites.add(suite); TestNG tng = new TestNG(); tng.setXmlSuites(suites); tng.run();
有兴趣的:请参阅JavaDocs了解整个API。
七、BeanShell和高级组选择
如果testng.xml中的<include>和<exclude>标记不足以满足您的需要,则可以使用BeanShell表达式来确定是否应在测试运行中包括某种测试方法。您可以在<test>标记下指定此表达式:
<test name="BeanShell test"> <method-selectors> <method-selector> <script language="beanshell"><![CDATA[ groups.containsKey("test1") ]]></script> </method-selector> </method-selectors> <!-- ... -->
当<SCRIPT>标记中发现的testng.xml,TestNG的将忽略随后的<包括>和<排除>在当前组和方法的<试验>标记:你的BeanShell的表达将是决定是否一个测试方法的唯一方式是否包含在内。
以下是有关BeanShell脚本的其他信息:
它必须返回一个布尔值。除了此约束之外,还允许使用任何有效的BeanShell代码(例如,您可能希望在工作日返回true,在周末返回false,这将允许您根据日期以不同的方式运行测试)
为了方便起见,TestNG定义了以下变量:
1、java.lang.reflect.Method method:当前的测试方法。
2、org.testng.ITestNGMethod testngMethod:当前测试方法的描述。
3、java.util.Map <String,String> groups:当前测试方法所属的组的映射。
您可能希望用CDATA声明包围表达式(如上所示),以避免冗长的保留XML字符引用。
八、Annotation Transformers
TestNG允许您在运行时修改所有注释的内容。如果源代码中的注释大多数时候都是正确的,则这特别有用,但是在某些情况下,您想覆盖它们的值。
为了实现此目的,您需要使用注释转换器。
Annotation Transformer是一个实现以下接口的类:
public interface IAnnotationTransformer { /** * This method will be invoked by TestNG to give you a chance * to modify a TestNG annotation read from your test classes. * You can change the values you need by calling any of the * setters on the ITest interface. * * Note that only one of the three parameters testClass, * testConstructor and testMethod will be non-null. * * @param annotation The annotation that was read from your * test class. * @param testClass If the annotation was found on a class, this * parameter represents this class (null otherwise). * @param testConstructor If the annotation was found on a constructor, * this parameter represents this constructor (null otherwise). * @param testMethod If the annotation was found on a method, * this parameter represents this method (null otherwise). */ public void transform(ITest annotation, Class testClass, Constructor testConstructor, Method testMethod); }
像所有其他TestNG侦听器一样,您可以在命令行或使用ant来指定此类:
java org.testng.TestNG -listener MyTransformer testng.xml
或以编程方式:
TestNG tng = new TestNG(); tng.setAnnotationTransformer(new MyTransformer()); // ...
调用 方法transform()时,可以在TestNG继续进行之前,调用ITest测试参数上的任何设置方法来更改其值。
例如,这是您如何重写属性invocationCount的方法,但仅在其中一个测试类的测试方法invoke()上:
/** * @author 北京-宏哥 * * Java自动化测试框架-08 - TestNG之 TestNG之并行性和超时篇 * * 2019年11月7日 */ public class MyTransformer implements IAnnotationTransformer { public void transform(ITest annotation, Class testClass, Constructor testConstructor, Method testMethod) { if ("invoke".equals(testMethod.getName())) { annotation.setInvocationCount(5); } } }
IAnnotationTransformer仅允许您修改@Test注释。如果需要修改另一个TestNG批注(配置批注@Factory或@DataProvider),请使用IAnnotationTransformer2。
九、方法拦截器
一旦TestNG 计算好了测试方法会以怎样的顺序调用,那么这些方法就会分为两组:
1.按照顺序运行的方法。这里所有的方法都有相关的依赖,并且所有这些方法按照特定顺序运行。
2.不定顺序运行的方法。这里的方法不属于第一个类别。方法的运行顺序是随机的,下一个说不准是什么(尽管如此,默认情况下TestNG会尝试通过类来组织方法)。
为了能够让你更好的控制第二种类别,TestNG定义如下接口:
方法中叫做methods的那个列表参数包含了所有以不定序运行的方法。你的 intercept 方法也要返回一个 IMethodInstance列表,它可能是下面情况之一:
1.内容与参数中接收的一致,但是顺序不同
2.一组 IMethodInstance 对象
3.更大的一组 IMethodInstance对象
一旦你定义了拦截器,就把它传递个TestNG,用下面的方式:
java -classpath "testng-jdk15.jar:test/build" org.testng.TestNG -listener test.methodinterceptors.NullMethodInterceptor
-testclass test.methodinterceptors.FooTest
有关等效的ant语法,请参见ant文档中的listeners属性。
例如,这是一个方法拦截器,它将对方法进行重新排序,以便始终首先运行属于“快速”组的测试方法:
/** * @author 北京-宏哥 * * Java自动化测试框架-08 - TestNG之 TestNG之并行性和超时篇 * * 2019年11月7日 */ public List<IMethodInstance> intercept(List<IMethodInstance> methods, ITestContext context) { List<IMethodInstance> result = new ArrayList<IMethodInstance>(); for (IMethodInstance m : methods) { Test test = m.getMethod().getConstructorOrMethod().getAnnotation(Test.class); Set<String> groups = new HashSet<String>(); for (String group : test.groups()) { groups.add(group); } if (groups.contains("fast")) { result.add(0, m); } else { result.add(m); } } return result; }
十、TestNG侦听器
有几个接口可让您修改TestNG的行为。这些接口广泛地称为“ TestNG侦听器”。以下是一些听众:
- IAnnotationTransformer(doc,javadoc)
- IAnnotationTransformer2(doc,javadoc)
- IHookable(doc,javadoc)
- IInvokedMethodListener(doc,javadoc)
- IMethodInterceptor(doc,javadoc)
- IReporter(doc,javadoc)
- ISuiteListener(doc,javadoc)
- ITestListener(doc,javadoc)
当实现这些接口之一时,可以通过以下两种方式之一让TestNG知道它:
- 在命令行上使用-listener。
- 将<listeners>与ant一起使用。
- 在您的testng.xml文件中使用<listeners> 。
- 在任何测试类上使用@Listeners批注。
- 使用ServiceLoader。
十一、使用的testng.xml或Java的指定监听器
这是在testng.xml文件中定义侦听器的方法:
<suite> <listeners> <listener class-name="com.example.MyListener" /> <listener class-name="com.example.MyMethodInterceptor" /> </listeners> ...
或者,如果您更喜欢用Java定义这些侦听器,则:
@Listeners({ com.example.MyListener.class, com.example.MyMethodInterceptor.class }) public class MyTest { // ... }
该@Listeners注释可以包含任何扩展类org.testng.ITestNGListener 除了 IAnnotationTransformer和IAnnotationTransformer2。原因是这些侦听器需要在过程的早期就知道,以便TestNG可以使用它们来重写您的注释,因此您需要在testng.xml文件中指定这些侦听器。
请注意,@ Listeners批注将应用于您的整个套件文件,就像您在testng.xml文件中指定的一样。如果要限制其范围(例如,仅在当前类上运行),则侦听器中的代码可以首先检查将要运行的测试方法,然后决定要做什么。这是可以完成的。
1、首先定义一个新的自定义注释,可用于指定此限制:
@Retention(RetentionPolicy.RUNTIME) @Target ({ElementType.TYPE}) public @interface DisableListener {}
2、在常规侦听器中添加如下所示的编辑检查:
public void beforeInvocation(IInvokedMethod iInvokedMethod, ITestResult iTestResult) { ConstructorOrMethod consOrMethod =iInvokedMethod.getTestMethod().getConstructorOrMethod(); DisableListener disable = consOrMethod.getMethod().getDeclaringClass().getAnnotation(DisableListener.class); if (disable != null) { return; } // else resume your normal operations }
3、注释测试类,其中不调用侦听器:
@DisableListener @Listeners({ com.example.MyListener.class, com.example.MyMethodInterceptor.class }) public class MyTest { // ... }
十二、使用的ServiceLoader指定侦听器
最后,JDK提供了一种非常优雅的机制,可以通过ServiceLoader类在类路径上指定接口的实现。
使用ServiceLoader,您要做的就是创建一个包含侦听器和一些配置文件的jar文件,在运行TestNG时将该jar文件放在类路径中,TestNG会自动找到它们。
这是其工作方式的具体示例。
让我们从创建一个监听器开始(任何TestNG监听器都可以工作):
package test.tmp; public class TmpSuiteListener implements ISuiteListener { @Override public void onFinish(ISuite suite) { System.out.println("Finishing"); } @Override public void onStart(ISuite suite) { System.out.println("Starting"); } }
编译该文件,然后在META-INF / services / org.testng.ITestNGListener位置创建一个文件,该文件将命名您想要此接口的实现。
您应该以以下目录结构结束,只有两个文件:
$ tree |____META-INF | |____services | | |____org.testng.ITestNGListener |____test | |____tmp | | |____TmpSuiteListener.class $ cat META-INF/services/org.testng.ITestNGListener test.tmp.TmpSuiteListener
创建此目录的jar:
$ jar cvf ../sl.jar . added manifest ignoring entry META-INF/ adding: META-INF/services/(in = 0) (out= 0)(stored 0%) adding: META-INF/services/org.testng.ITestNGListener(in = 26) (out= 28)(deflated -7%) adding: test/(in = 0) (out= 0)(stored 0%) adding: test/tmp/(in = 0) (out= 0)(stored 0%) adding: test/tmp/TmpSuiteListener.class(in = 849) (out= 470)(deflated 44%)
接下来,在调用TestNG时,将此jar文件放在类路径中:
$ java -classpath sl.jar:testng.jar org.testng.TestNG testng-single.yaml Starting f2 11 2 PASSED: f2("2") Finishing
通过此机制,您只需将jar文件添加到类路径即可将相同的一组侦听器应用于整个组织,而不是要求每个开发人员都记住在其testng.xml文件中指定这些侦听器。
十三、小结
好了,今天关于TestNG之并行性和超时,就分享到这里。