Java注解

Java 注解

spring 和 springboot 中都会出现

注解的分类

一般常用的注解可以分为三类：

1、Java自带的标准注解
包括@Override、@Deprecated、@SuppressWarnings等，使用这些注解后编译器就会进行检查。

2、元注解
元注解是用于定义注解的注解，包括@Retention、@Target、@Inherited、@Documented、@Repeatable 等。
元注解也是Java自带的标准注解，只不过用于修饰注解，比较特殊。

3、自定义注解
用户可以根据自己的需求定义注解。

注解的使用

使用Java自带的注解
Java 自带的注解，就是 java.lang中定义的一套注解，以Override注解为例，使用方法如下：

@Override         //在需要注解的方法上面@Override即可
protected void onCreate() {
      
}

常用的Java注解如下：

1、@Deprecated – 所标注内容不再被建议使用；
2、@Override – 只能标注方法，表示该方法覆盖父类中的方法；
3、@Documented --所标注内容可以出现在javadoc中；
4、@Inherited – 只能被用来标注“Annotation类型”，它所标注的Annotation具有继承性；
5、@Retention – 只能被用来标注“Annotation类型”，而且它被用来指定Annotation的RetentionPolicy属性；
6、@Target – 只能被用来标注“Annotation类型”，而且它被用来指定Annotation的ElementType属性；
7、@SuppressWarnings – 所标注内容产生的警告，编译器会对这些警告保持静默；
8、@interface – 用于定义一个注解；

注解的使用

使用Java自带的注解
Java 自带的注解，就是 java.lang中定义的一套注解，以Override注解为例，使用方法如下：

@Override         //在需要注解的方法上面@Override即可
protected void onCreate() {
      
}

常用的Java注解如下：

1、@Deprecated – 所标注内容不再被建议使用；
2、@Override – 只能标注方法，表示该方法覆盖父类中的方法；
3、@Documented --所标注内容可以出现在javadoc中；
4、@Inherited – 只能被用来标注“Annotation类型”，它所标注的Annotation具有继承性；
5、@Retention – 只能被用来标注“Annotation类型”，而且它被用来指定Annotation的RetentionPolicy属性；
6、@Target – 只能被用来标注“Annotation类型”，而且它被用来指定Annotation的ElementType属性；
7、@SuppressWarnings – 所标注内容产生的警告，编译器会对这些警告保持静默；
8、@interface – 用于定义一个注解；

常用的元注解有@Retention、 @Target、 @Document、 @Inherited和@Repeatable五个。

@Retention
Retention英文意思有保留、保持的意思，它表示注解存在阶段是保留在源码（编译期），字节码（类加载）或者运行期（JVM中运行）。

在@Retention注解中使用枚举RetentionPolicy来表示注解保留时期：

• @Retention(RetentionPolicy.SOURCE)，注解仅存在于源码中，在class字节码文件中不包含
• @Retention(RetentionPolicy.CLASS)， 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得
• @Retention(RetentionPolicy.RUNTIME)， 注解会在class字节码文件中存在，在运行时可以通过反射获取到

@Target
Target的英文意思是目标，这也很容易理解，使用@Target元注解表示我们的注解作用的范围就比较具体了，可以是类，方法，方法参数变量等，同样也是通过枚举类ElementType表达作用类型：

• @Target(ElementType.TYPE) 作用接口、类、枚举、注解
• @Target(ElementType.FIELD) 作用属性字段、枚举的常量
• @Target(ElementType.METHOD) 作用方法
• @Target(ElementType.PARAMETER) 作用方法参数
• @Target(ElementType.CONSTRUCTOR) 作用构造函数
• @Target(ElementType.LOCAL_VARIABLE)作用局部变量
• @Target(ElementType.ANNOTATION_TYPE)作用于注解（@Retention注解中就使用该属性）
• @Target(ElementType.PACKAGE) 作用于包
• @Target(ElementType.TYPE_PARAMETER) 作用于类型泛型，即泛型方法、泛型类、泛型接口 （jdk1.8加入）
• @Target(ElementType.TYPE_USE) 类型使用.可以用于标注任意类型除了 class （jdk1.8加入）

@Documented
Document的英文意思是文档。它的作用是能够将注解中的元素包含到 Javadoc 中去。

@Inherited
Inherited的英文意思是继承，但是这个继承和我们平时理解的继承大同小异，一个被@Inherited注解了的注解修饰了一个父类，如果他的子类没有被其他注解修饰，则它的子类也继承了父类的注解。

@Repeatable
Repeatable的英文意思是可重复的。顾名思义说明被这个元注解修饰的注解可以同时作用一个对象多次，但是每次作用注解又可以代表不同的含义。