java注解

注解的概念

注解是可以被jvm所处理的代码,是对代码的描述,他就像一个修饰符一样,它可以用来修饰类、方法、成员变量，参数以及本地变量声明语句中。
用注解来映射现实生活中他就像商品的标签一样,用特定的一起扫描他就可以获取他的商品信息,而注解可以通过反射来读取注解里面的内容.

注解的原理

注解本质是一个继承了Annotation的特殊接口，其具体实现类是Java运行时生成的动态代理类。而我们通过反射获取注解时，返回的是Java运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解（接口）的方法，会最终调用AnnotationInvocationHandler的invoke方法。该方法会从memberValues这个Map中索引出对应的值。
简单的来说声明注解的时候相当于创建一个特殊的接口,使用注解(@注解名) 的时候jvm会帮我们自动创建一个注解对象。

注解的分类

内置注解

Java中有三种内置注解，这些注解用来为编译器提供指令,它们是:

@Deprecated

​ 这个元素是用来标记过时的元素，想必大家在日常开发中经常碰到。编译器在编译阶段遇到这个注解时会发出提醒警告，告诉开发者正在调用一个过时的元素比如过时的方法、过时的类、过时的成员变量

​ 可以用来标记类，方法，属性;

@Override

​ 用来修饰对父类进行重写的方法。如果一个并非重写父类的方法使用这个注解，编译器将提示错误。

​ 实际上在子类中重写父类或接口的方法，@Overide并不是必须的。但是还是建议使用这个注解，在某些情况下，假设你修改了父类的方法的名字，那么之前重写的子类方法将不再属于重写，如果没有@Overide，你将不会察觉到这个子类的方法。有了这个注解修饰，编译器则会提示你这些信息

@SuppressWarnings

​ 用来抑制编译器生成警告信息

​ 可以修饰的元素为类，方法，方法参数，属性，局部变量

​ 当我们一个方法调用了弃用的方法或者进行不安全的类型转换，编译器会生成警告。我们可以为这个方法增加@SuppressWarnings注解，来抑制编译器生成警告。

​ 注意：使用@SuppressWarnings注解，采用就近原则，比如一个方法出现警告，我们尽量使用@SuppressWarnings注解这个方法，而不是注解方法所在的类。虽然两个都能抑制编译器生成警告，但是范围越小越好，因为范围大了，不利于我们发现该类下其他方法的警告信息

//告诉编译器忽略 unchecked 警告信息，如使用List，ArrayList等未进行参数化产生的警告信息。
@SuppressWarnings(“unchecked”)

//如果编译器出现这样的警告信息：The serializable class WmailCalendar does not declare a     //static final serialVersionUID field of type long，使用这个注释将警告信息去掉。
@SuppressWarnings(“serial”)

//如果使用了使用@Deprecated注释的方法，编译器将出现警告信息。使用这个注释将警告信息去掉。
@SuppressWarnings(“deprecation”)

//rawtypes是说传参时也要传递带泛型的参数 
@SuppressWarnings(“rawtypes”) 

//抑制所有类型的警告：
@SuppressWarnings(“all”)

元注解

jdk定义好这个注解的声明，在注解上使用

​ java.lang.annotation提供了四种元注解，专门注解其他的注解（在自定义注解的时候，需要使用到元注解）.

1.@Documented-注解是否将包含在JavaDoc中

​ 一个简单的Annotations标记注解，表示是否将注解信息添加在javadoc文档中

2.@Retention –什么时候使用该注解

​ Retention 的英文意为保留期的意思。当 @Retention 应用到一个注解上的时候，它解释说明了这个注解的的存活时间

它的取值如下：

• RetentionPolicy.SOURCE 注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视。

• RetentionPolicy.CLASS 注解只被保留到编译进行的时候，它并不会被加载到 JVM 中。

• RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候，它会被加载进入到 JVM 中，所以在程序运行时可以获取到它们。

  自定义注解：保留期一定设置为runtime

  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gSY8GZeC-1661348945465)(C:\Users\emmmm\AppData\Roaming\Typora\typora-user-images\1660702155004.png)]

3.@Target–注解用于什么地方

​ 默认值为任何元素，表示该注解用于什么地方。可用的ElementType参数包括
​ ● ElementType.CONSTRUCTOR:用于描述构造器
​ ● ElementType.FIELD:成员变量、对象、属性（包括enum实例）
​ ● ElementType.LOCAL_VARIABLE:用于描述局部变量
​ ● ElementType.METHOD:用于描述方法
​ ● ElementType.PACKAGE:用于描述包
​ ● ElementType.PARAMETER:用于描述参数
​ ● ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明

注解使用注意事项

1）如果注解定义的参数是数值类型，给数值类型数组赋值

1.单个值可以直接赋值value = {ElementType.TYPE} ,value = ElementType.TYPE

2.多个值value = {ElementType.TYPE,ElementType.ANNOTATION_TYPE}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Dg16UR0t-1661348945467)(C:\Users\emmmm\AppData\Roaming\Typora\typora-user-images\1660701732601.png)]

4.@Inherited – 定义该注释和子类的关系

​ Inherited 是继承的意思，但是它并不是说注解本身可以继承，而是说如果一个超类被 @Inherited 注解过的注解进行注解的话，那么如果它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解

自定义注解

声明注解语法：@interface

public @interface 注解名{
 //成员
 
}

使用注解：在方法，属性类，成员变量、参数等

@自己定义的注解名/jdk自带的注解名            //这里创建了注解的对象。
public class Student{}

自定义注解类编写的一些规则:

1. Annotation型定义为@interface, 所有的Annotation会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口.
2. 参数成员只能用public或默认(default)(就是什么都不写的 ，默认也为public)这两个访问权修饰
3. 参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和String、Enum、Class、annotations等数据类型,以及这一些类型的数组.
4. 要获取类方法和字段的注解信息，必须通过Java的反射技术来获取 Annotation对象,因为你除此之外没有别的获取注解对象的方法
5. 注解也可以没有定义成员, 不过这样注解就没啥用了
获取该注解的对象，只能使用反射来获取。

参数的本质就是一个抽象方法；

但是我们可以使用注解的时候，给参数赋值，在声明的时候，设置默认值。

参数名（）default 参数值

如果一个参数没有设置默认返回值，在使用的时候一定要参数赋值，

如果有了默认返回值，可以给参数赋值，也可以不给参数赋值