java 注解(Annotation)
Java 注解用于为 Java 代码提供元数据,是从JDK5.0引入的一种注释机制。
先举几个我们常见的注解例子:
@Override - 检查该方法是否是重写方法。如果发现其父类,或者是引用的接口中并没有该方法时,会报编译错误。
@Deprecated - 标记过时方法。如果使用该方法,会报编译警告。
@SuppressWarnings - 指示编译器去忽略注解中声明的警告。
再来了解一下元注解:
元注解可以理解为注解的注解,它是作用在注解中,方便我们使用注解实现想要的功能。元注解包括
@Target、@Retention、 @Document、 @Inherited和@Repeatable(JDK1.8加入)五种。
1.@Target
注解作用的范围:
@Target(ElementType.TYPE) 作用于类、接口、注解、枚举
@Target(ElementType.FIELD) 作用于属性字段、枚举的常量
@Target(ElementType.METHOD) 作用于方法
@Target(ElementType.PARAMETER) 作用于方法参数
@Target(ElementType.CONSTRUCTOR) 作用于构造函数
@Target(ElementType.LOCAL_VARIABLE) 作用于局部变量
@Target(ElementType.ANNOTATION_TYPE) 作用于注解类型
@Target(ElementType.PACKAGE) 作用于包
@Target(ElementType.TYPE_PARAMETER) 作用于类型泛型,即泛型方法、泛型类、泛型接口 (jdk1.8加入)
@Target(ElementType.TYPE_USE) 类型使用.可以用于标注任意类型除了class (jdk1.8加入)
2.@Retention
用于标识注解存在的生命周期,Retention对应的RetentionPolicy枚举有三种:
RetentionPolicy.SOURCE:注解仅存在于源码中,不会写入class文件
RetentionPolicy.CLASS: 注解会存在于class字节码文件中,运行时状态下获取不到,也是默认的存在策略;
RetentionPolicy.RUNTIME:注解会一直存在于运行时状态,可通过反射获取到;
3.@Document
Document的英文意思是文档。它的作用是能够将注解中的元素包含到 Javadoc 中去。
4.@Inherited
如果是类的继承关系,则子类会继承父类使用的注解中被@Inherited修饰的注解;但如果是接口继承或类实现接口则不会继承接口中的注解。
5.@Repeatable
该注解表示可以对同一个元素多次使用相同的注解。
以上即为java注解的一些梳理知识,希望对你有所帮助。