你真的理解Java 注解吗？

你真的理解Java 注解吗？

一、什么是注解？

官方解释：

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

我的理解：

注解≈标签

二、注解的使用场景？

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

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

三、注解原理

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

四、注解类型

• 元注解
• 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接口就是使用了该注解）

（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