JAVA注解Annotation介绍-优快云博客

本文深入解析Java自带注解的功能及用途，例如@Deprecated、@Override和@SuppressWarnings，并介绍了自定义注解的方法及其元注解的使用，包括@Documented、@Retention、@Target和@Inherited。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Java自带的注解

@Deprecated 表明当前的元素已经不推荐使用
@Override 表明当前方法是覆盖了父类方法
@SuppressWarnings 关闭不当的编译器警告信息

自定义注解

@interface Empty{
    String field1() default "it's empty"; //default 设置默认值
}
@Empty   //使用 default默认值"it's empty"
class C{
}

//如果没有使用default设置默认值的话，field必须显式传入参数,如下
@Empty(field1="empty A")
class A{
}

@interface Value{
    String value();
    String other() default "it's great";
}
@Value("empty B") //当注解有一个方法value时，没有其他方法或者其他方法有默认值，不需要指明具体方法
class B{
}

元注解

@Documented

被修饰的注解会生成到javadoc中

@Documented
@interface DocumentedAnnotation{ 
}
@interface UnDocumentedAnnotation{
}
@DocumentedAnnotation
@UnDocumentedAnnotation
class A{}

@Retention

可以设置注解的级别

//RetentionPolicy是一个枚举类，默认是CLASS，此外还可选择SOURCE,RUNTIME
@Retention(RetentionPolicy.CLASS) 
@interface ClassRetentionAnnotation{}

SOURCE代表源码级别，注解只存在源码中，其功能是与编译器交互，用于代码检测，如@Override,@SuppressWarings，许多框架如Dragger就是使用这个级别的注解，这个级别的框架额外效率损耗发生在编译时
CLASS代表字节码级别，注解存在源码与字节码文件中，主要用于编译时生成而外的文件，如XML，Java文件等，这个级别需要添加JVM加载时候的代理（javaagent ），使用代理来动态修改字节码文件（由于Android虚拟机并不支持所以本专题不会再做介绍，在Android中可以使用aspectJ来实现类似这个级别的功能）
RUNTIME代表运行时级别，注解存在源码，字节码与Java虚拟机中，主要用于运行时反射获取相关信息，许多框架如OrmLite就是使用这个级别的注解，这个级别的框架额外的效率损耗发生在程序运行时

@Target

限制注解的元素种类

@Target(ElementType.METHOD) //限制了注解只能修饰方法，ElementType是一个枚举类
@Retention(RetentionPolicy.SOURCE)
public @interface Override{
}

@Inherited

让子类类对象使用getAnnotations（）反射获取父类被@Inherited修饰的注解

@Inherited
@Retention(RetentionPolicy.Runtime)
@interface Inheritable{
}
@interface UnInheritable{
}
public class Test{
    @UnInheritable
    @Inheritable
    public static class Super{
    }
    public static class Sub extends  Super {
    }
    public static void main(String... args){
        Super instance=new Sub();
        System.out.println(Arrays.toString(instance.getClass().getAnnotations()));
    }
}