TestNG中IAnnotationTransformer方法描述

Question

在TestNG中实现IAnnotationTransfer接口的时候，有一个参数叫做annotation，这个参数就是从测试类中读取的annotation。现在，有几个方法是直接的，而注释的各种方法我无法理解（如getAttributes）。谁能给我指出这些方法的使用实例（描述），让我知道如何使用其中的一些方法。

具体来说，getAttributes返回什么？

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

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

https:/javadoc.iodocorg.testngtestng7.1.0orgtestngannotationsITestAnnotation.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