Java中的 getDeclaredAnnotations() 方法

Java中的getDeclaredAnnotations()方法是一个反射方法，它返回一个包含当前类或接口声明的所有注释的数组。它不包含继承的注释。

public Annotation[] getDeclaredAnnotations()

语法说明

Java中的getDeclaredAnnotations()方法是一个成员方法，它可以使用以下语法来调用:

class MyClass {
    @MyAnnotation(description = "This is my annotation")
    public void myMethod() {
        // method implementation
    }
}

MyClass obj = new MyClass();
Method method = obj.getClass().getMethod("myMethod");
Annotation[] annotations = method.getDeclaredAnnotations();

返回值说明

Java中的getDeclaredAnnotations()方法返回一个Annotation数组，其中包含当前对象中声明的所有注释。如果没有任何注释，则返回长度为0的空数组。

MyAnnotation[] annotations = method.getDeclaredAnnotationsByType(MyAnnotation.class);

示例使用

下面是使用getDeclaredAnnotations()方法的示例代码:

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

public class MyClass {

    @Deprecated
    public void deprecatedMethod() {
        System.out.println("This method is deprecated!");
    }

    @SuppressWarnings("unchecked")
    public void uncheckedMethod() {
        System.out.println("This method uses unchecked or unsafe operations!");
    }

    public static void main(String[] args) throws NoSuchMethodException {

        Method deprecated = MyClass.class.getMethod("deprecatedMethod");
        Method unchecked = MyClass.class.getMethod("uncheckedMethod");

        System.out.println("Annotations for deprecated method:");
        Annotation[] deprecatedAnnotations = deprecated.getDeclaredAnnotations();
        for (Annotation annotation : deprecatedAnnotations) {
            System.out.println(annotation);
        }

        System.out.println("Annotations for unchecked method:");
        Annotation[] uncheckedAnnotations = unchecked.getDeclaredAnnotations();
        for (Annotation annotation : uncheckedAnnotations) {
            System.out.println(annotation);
        }
    }
}

以上代码将输出以下结果:

Annotations for deprecated method:
@java.lang.Deprecated()
Annotations for unchecked method:
@java.lang.SuppressWarnings(value=unchecked)

这个例子展示了如何获取方法的注释并打印出来。注意， Deprecated和SuppressWarnings注释不在同一个包中，并且需要分别导入它们。

总结

Java中的getDeclaredAnnotations()方法提供了一种简单的方式来获取类、方法或字段上定义的注释。它非常有用，特别是在使用反射技术时，因为它允许开发人员在运行时检测和分析对象的元数据。建议在处理Java反射时学习和理解这个方法。