Junit5-Jupiter:composit(=“meta”）注释不能解析为注释定义

Question

我定义了自己的JUnit注释：

@ParameterizedTest
@MethodSource("myorg.qa.ccrtesting.DataProviders#standardDataProvider")
@Tags({@Tag("ccr"), @Tag("standard")})
public @interface CcrStandardTest {
}

然后，我能够在测试中使用该注释：

@CcrStandardTest
public void E0010_contact_standard (String testData) {
...

null

当我在原型测试方法上方添加@test时，它将执行，但是：

1. 似乎没有应用我在@ccrstandardtest下定义的注释
2. IDE建议可疑的组合@test和parameterized source
   （我已经知道@parameterizedtest意味着@test，只是不知道为什么IDE能够找到自定义注释，而JUnit不能？）

Answer 1

正如您所发现的，您需要将@retention(RUNTIME)添加到您的组合注释中，以便JUnit能够看到它。Java中的注释有三种不同的保留策略：

>

retentionpolicy.source

注释将被编译器丢弃。

正如我在上面强调的，如果您没有显式地添加@retention(...)，那么将使用类策略。这不适用于JUnit，因为JUnit不扫描*.class文件（即字节码）来查找注释，而是反射性地扫描加载的类来查找测试方法。如果没有runtime保留策略，您的注释就不能反射性地访问，因此JUnit永远不会看到它，因此不会执行测试。

@target注释：

指示批注类型适用的上下文。JLS 9.6.4.1中指定了可能适用注释类型的声明上下文和类型上下文，并在源代码中由java.lang.annotation.ElementType的枚举常量表示。

如果存在@target元注释，编译器将强制执行ElementType枚举常数指示的使用限制，这与JLS 9.7.4一致。

在回答你的另一个问题时，我用了：

@Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD})

因为这与@parameterizedtest使用的目标相同。我认为将其限制为method是一个好主意，因为@parameterizedtest的设计者显然认为只有方法应该由parameterized-tests扩展直接扩展（参见§5扩展模型）。包括annotation_type允许您将组合注释放置在另一个注释上，从而创建另一个组合注释。

注意，这些注释--@retention、@target和@documented-并不特定于JUnit。这些注释对于Java中的注释如何工作至关重要，每个注释都位于Java.lang.annotation包中。