IAnnotationTestNG中的转换器方法说明

Question

在TestNG中实现IAnnotationTransfer接口时，有一个名为annotation的参数，它是将从测试类中读取的注释。现在，很少有方法很简单，而各种注释方法我无法理解(例如getAttributes(。有人可以指出我这些方法的示例用法(描述(，以便我知道如何使用其中一些方法。

具体来说，getAttributes 返回什么？

我尝试使用它(CustomAttribute[] cs = annotation.getAttributes((;)但我在 cs 变量中什么也没得到。

IAnnotation 接口中的所有方法都可以在下面访问：

https://javadoc.io/doc/org.testng/testng/7.1.0/org/testng/annotations/ITestAnnotation.html

Answer 1

下面是一个示例，演示如何使用CustomAttribute。其他方法都是不言自明的。

使用CustomAttribute的测试类如下所示：

import org.testng.Reporter;
import org.testng.annotations.CustomAttribute;
import org.testng.annotations.Test;
import java.util.Arrays;
import java.util.Optional;
public class SampleTestClass {
@Test(attributes = {
@CustomAttribute(name = "functionality", values = {"login", "oauth"}),
@CustomAttribute(name = "flavor", values = {"bvt", "regression"})
})
public void customAttributeEnabledTestMethod() {
System.err.println("Printing the custom attributes from test method");
CustomAttribute[] attributes = Optional
.ofNullable(
Reporter.getCurrentTestResult().getMethod().getAttributes())
.orElse(new CustomAttribute[]{});
Arrays.stream(attributes).forEach(attribute -> {
System.err.println("Attribute Name : " + attribute.name());
System.err.println("Attribute values : " + Arrays.toString(attribute.values()));
});
}
@Test
public void plainTestMethod() {
System.err.println("Hello world again");
}
}

更改此值的自定义注释转换器：

import org.testng.IAnnotationTransformer;
import org.testng.annotations.CustomAttribute;
import org.testng.annotations.ITestAnnotation;
import java.lang.annotation.Annotation;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
import java.util.Arrays;
import java.util.Optional;
public class DemoAnnotationTransformer implements IAnnotationTransformer {
@Override
public void transform(ITestAnnotation annotation, Class testClass, Constructor testConstructor, Method testMethod) {
CustomAttribute[] attributes = annotation.getAttributes();
//We need this filtering logic because there's currently a bug in TestNG 7.1.0
//which causes the annotation transfomer to be invoked multiple times.
//This should be resolved in TestNG v7.2.0
//The defect to refer to : https://github.com/cbeust/testng/issues/2312
Optional<CustomAttribute> found = Arrays.stream(attributes)
.filter(each -> each.name().equalsIgnoreCase("supported-browsers"))
.findAny();
if (found.isPresent()) {
return;
}
int size = attributes.length + 1;
CustomAttribute[] copied = new CustomAttribute[size];
System.arraycopy(attributes, 0, copied, 0, attributes.length);
copied[attributes.length] = new CustomAttribute() {
@Override
public Class<? extends Annotation> annotationType() {
return CustomAttribute.class;
}
@Override
public String name() {
return "supported-browsers";
}
@Override
public String[] values() {
return new String[]{"firefox", "chrome"};
}
};
annotation.setAttributes(copied);
}
}

下面是套件 xml 的外观：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="qn_62287783_suite" parallel="false" configfailurepolicy="continue">
<listeners>
<listener class-name="com.rationaleemotions.stackoverflow.qn62287783.DemoAnnotationTransformer"/>
</listeners>
<test name="qn_62287783_test" verbose="2">
<classes>
<class name="com.rationaleemotions.stackoverflow.qn62287783.SampleTestClass"/>
</classes>
</test>
</suite>

输出如下所示：

Printing the custom attributes from test method
Attribute Name : functionality
Attribute values : [login, oauth]
Attribute Name : flavor
Attribute values : [bvt, regression]
Attribute Name : supported-browsers
Attribute values : [firefox, chrome]

Hello world again
PASSED: customAttributeEnabledTestMethod
PASSED: plainTestMethod
===============================================
qn_62287783_test
Tests run: 2, Failures: 0, Skips: 0
===============================================

===============================================
qn_62287783_suite
Total tests run: 2, Passes: 2, Failures: 0, Skips: 0
===============================================

Process finished with exit code 0