你真的理解Java 注解吗?

时间:2023-11-10 09:32:56

你真的理解Java 注解吗?

1、什么是注解?

官方解释:

Java 注解用于为 Java 代码提供元数据。作为元数据,注解不直接影响你的代码执行,但也有一些类型的注解实际上可以用于这一目的。Java 注解是从 Java5 开始添加到 Java 的。

个人理解:

注解≈标签

2、注解的使用场景?

我们先不谈如何实现注解,我们从需求出发,先看看注解该如何使用。

  • 生成文档。这是最常见的,也是java 最早提供的注解。常用的有@param @return 等
  • 跟踪代码依赖性,实现替代配置文件功能。比如Dagger 2依赖注入,未来java开发,将大量注解配置,具有很大用处;
  • 在编译时进行格式检查。如@override 放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出。

3、注解原理

  注解本质是一个继承了Annotation的特殊接口,其具体实现类是Java运行时生成的动态代理类。而我们通过反射获取注解时,返回的是Java运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解(接口)的方法,会最终调用AnnotationInvocationHandler的invoke方法。该方法会从memberValues这个Map中索引出对应的值。而memberValues的来源是Java常量池。

4、注解类型

  • 元注解
  • Java 内置注解
  • 自定义注解

(1)元注解

  • @Retention:描述注解生命周期,例如@Retention(RetentionPolicy.RUNTIME)
  • @Documented:将注解中的元素包含到 Javadoc文档中
  • @Target:限定了注解作用的目标范围,包括类、方法等等
  • @Inherited:使得一个 被@Inherited注解的注解 作用的类的子类可以继承该类的注解
  • @Repeatable:使得作用的注解可以取多个值(Java1.8)

(2)Java 内置注解

  • @Deprecated:标记已过时 & 被抛弃的元素(类、方法等)
  • @Override:标记该方法需要被子类复写
  • @SuppressWarnings:标记的元素会阻止编译器发出警告提醒 (主要应用于开发者需要忽略警告时)
  • @SafeVarargs:提醒开发者不要用参数做不安全的操作 & 阻止编译器产生 unchecked警告(1.7引入)
  • @FunctionalInterface:表示该接口 = 函数式接口(1.8引入,例如Runnable 接口就是使用了该注解)

你真的理解Java 注解吗?

(3)自定义注解

定义一个注解

// 通过 @interface 关键字进行定义
// 形式类似于接口,区别在于多了一个 @ 符号
public @interface MyAnnotation {
// 注解的属性 = 成员变量
// 注解只有成员变量,没有方法 // 注解@MyAnnotation中有2个属性:id 和 msg
int id();
String msg() default "Hi" ; // 说明:
// 注解的属性以 “无形参的方法” 形式来声明
// 方法名 = 属性名
// 方法返回值 = 属性类型 = 8 种基本数据类型 + 类、接口、注解及对应数组类型
// 用 default 关键值指定 属性的默认值,如上面的msg的默认值 = ”Hi“
}

Demo地址如下:

https://github.com/Taoey/DAS/tree/master/JavaBase/src/main/java/annotation