TestNG教程三：TestNG中的监听

TestNG中的监听

1.使用监听的目的：

  Testng虽然提供了不少强大的功能和灵活的选项，但不能解决所有的问题，使用监听器就是用来定制额外的功能以满足我们的需求的；

2.监听器具体实现：

  监听器实际上是一些预定义的java接口，用户创建这些接口的实现类（即implements某监听接口，并实现里面的方法），并加入到testng中，testng便会在运行的不同时刻调用这些类中你自定义实现的接口方法，从而实现定制额外的功能；

3.监听器的种类：

3.1 IAnnotationTransformer（修改@Test注释属性）

大多数情况下，在运行时我们不需要改动源代码中定义的注释，但有时需要这样做。这时，我们就需要使用 IAnnotationTransformer 监听器。IAnnotationTransformer 只能用来修改 @Test 注释，如果需要修改其他 TestNG 的注释（比如，@DataProvider, @Factory 以及 @Configuration），需要使用 IAnnotationTransformer2 监听器。IAnnotationTransformer 要求实现 transform 方法，其方法签名如下：

void transform(ITest annotation, Class testClass, Constructor testConstructor, Method testMethod);

annotation 代表就是为 testMethod 定义的 @Test 注释。调用其方法可以更改 @Test 注释属性。例如，下面的代码在运行时将属性 enabled 改为 false 从而禁用了当前的测试方法。

annotation.setEnabled(false);

3.2 IAnnotationTransformer2（修改其他注解的注释属性）

用来修改除 @Test 以外的 TestNG 的注释，例如：@DataProvider 以及 @Factory 等注解的注释属性能够通过该监听器修改；

void transform(IDataProviderAnnotation annotation, java.lang.reflect.Method method)

void transform(IFactoryAnnotation annotation, java.lang.reflect.Method method)

3.3 IHookable（类似与面向切面编程（AOP）中的 Around Advice 的功能），可忽略

3.4 IInvokedMethodListener（类似与面向切面编程（AOP）中的 Before Advice 和 After Advice 的功能），可忽略

3.5 IMethodInterceptor控制列表执行循序）

TestNG 启动之后，所有的测试方法分成两类：

一类是顺序运行的测试方法；（dependsOnGroups 和 dependsOnMethods）

一类是没有特定运行顺序的测试方法。（运行顺序是随机，每次运行的顺序都可能不同）

IMethodInterceptor 监听器用来对第二类测试有更大的控制权，对列表重新排序，甚至增加或者减少测试方法；

java.util.List<IMethodInstance> intercept(java.util.List<IMethodInstance> methods, ITestContext context)

实现的intercept 方法会在所有测试方法被分类后以及所有测试方法被执行前被调用。所有的测试方法将按照 intercept 返回值列表中的顺序被执行。

3.6 IReporter（自定义测试报表）

IReporter 监听器用来自定义测试报表；

void generateReport(java.util.List<XmlSuite> xmlSuites, java.util.List<ISuite> suites, java.lang.String outputDirectory)

generateReport方法会在所有测试方法执行结束后被调用，通过遍历 xmlSuites 和 suites 能够获取所有测试方法的信息以及测试结果。outputDirectory 是默认的测试报表生成路径，当然你可以指定其他路径生成报表

3.7 ISuiteListener（suite的AOP），可忽略；

3.8 ITestListener（简便自定义测试方法执行后的后续行为）

用来在测试方法执行成功、失败或者跳过时指定不同后续行为；
IInvokedMethodListener 也可以实现，但ITestListener更简便；

void onTestFailure(ITestResult result)

void onTestSkipped(ITestResult result)

void onTestSuccess(ITestResult result)

另外：TestListenerAdapter