Question

我正在使用 reflection 编写一些单元测试，而我在从方法参数中检索注释时遇到了问题。

我宣布了这个界面：

private interface Provider {
    void mock(@Email String email);
}

我正试图反映这种方法，如下所示：

Class stringClass = String.class;
Method method = Provider.class.getDeclaredMethod("mock", String.class);
AnnotatedType annotatedType = method.getAnnotatedParameterTypes()[0];
Annotation annotation = annotatedType.getAnnotation(Annotation.class);

我希望annotation变量包含@Email注释的实例，但相反，它的值为null。

即使这个简单的检查也会返回false：

method.isAnnotationPresent(Email.class)

那么，当反映方法时，如何检索特定参数的注释？

更新

似乎为了检索参数注释，我需要调用method.getParameterAnnotations()。但问题是我不知道注释属于哪种方法。

Answer 1

如果希望在程序执行期间显示注释，则需要使用@Retention(RetentionPolicy.RUNTIME)对其进行注释：

private interface Provider {
    void mock(@Email String email);
}

@Retention(RetentionPolicy.RUNTIME)
public @interface Email{}

@Test
public void test_annotation_existence() throws NoSuchMethodException {

    Method method = Provider.class.getDeclaredMethod("mock", String.class);

    Annotation[] firstParameterAnnotationsArray = method.getParameterAnnotations()[0];
    boolean isAnnotationPresent = isAnnotationPresent(firstParameterAnnotationsArray, Email.class);

    Assert.assertTrue("Annotation not present!", isAnnotationPresent);

}

private boolean isAnnotationPresent(Annotation[] annotationsArray, Class clazz) {
    if (annotationsArray == null)
        throw new IllegalArgumentException("Please pass a non-null array of Annotations.");
    for(int i = 0; i < annotationsArray.length; i++ ) {
        if (annotationsArray[i].annotationType().equals(clazz))
            return true;
    }
    return false;
}

Answer 2

您必须区分Java 8 类型注释和（自Java 5）参数注释。关于类型注释的关键是，你必须声明显式使用注释作为类型注释的可能性。

考虑以下示例：

public class AnnoTest {
    @Retention(RetentionPolicy.RUNTIME)
    @interface Email {}

    void example(@Email String arg) {}

    public static void main(String[] args) throws ReflectiveOperationException {
        Method method=AnnoTest.class.getDeclaredMethod("example", String.class);
        System.out.println("parameter type annotations:");
        AnnotatedType annotatedType = method.getAnnotatedParameterTypes()[0];
        //Annotation annotation = annotatedType.getAnnotation(Annotation.class);
        System.out.println(Arrays.toString(annotatedType.getAnnotations()));
        System.out.println("parameter annotations:");
        System.out.println(Arrays.toString(method.getParameterAnnotations()[0]));
    }
}

它会打印

parameter type annotations:
[]
parameter annotations:
[@AnnoTest$Email()]

在这种情况下，注释是参数的属性。

现在将其更改为（请注意@Target）

public class AnnoTest {
    @Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.TYPE_USE)
    @interface Email {}

    void example(@Email String arg) {}

    public static void main(String[] args) throws ReflectiveOperationException {
        Method method=AnnoTest.class.getDeclaredMethod("example", String.class);
        System.out.println("parameter type annotations:");
        AnnotatedType annotatedType = method.getAnnotatedParameterTypes()[0];
        //Annotation annotation = annotatedType.getAnnotation(Annotation.class);
        System.out.println(Arrays.toString(annotatedType.getAnnotations()));
        System.out.println("parameter annotations:");
        System.out.println(Arrays.toString(method.getParameterAnnotations()[0]));
    }
}

将打印

parameter type annotations:
[@AnnoTest$Email()]
parameter annotations:
[]

代替。所以现在，注释是参数 type 的一个特征，即String。在概念上，方法的参数类型现在是@Email String（这似乎是最合乎逻辑的选择，因为它允许声明像List<@Email String>这样的类型，但您必须了解这些新类型注释的工作原理和它不能与Java 8之前的库一起工作。）

在为参数和类型使用启用注释时必须小心，因为这会产生不明确的注释。如果发生这种情况，编译器将记录参数和类型的注释，例如：当您将示例中的目标更改为@Target({ElementType.TYPE_USE, ElementType.PARAMETER})时，它将打印

parameter type annotations:
[@AnnoTest$Email()]
parameter annotations:
[@AnnoTest$Email()]

在方法返回类型中可能会出现类似的问题。为“类型使用”和方法启用注释时的字段类型。字段。

使用class.getDeclaredMethod反映方法时不会出现注释

更新

2 个答案: