Java高级技术——注解

1. 概述、自定义注解

注解概述、作用

• Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。
• Java语言中的类、构造器、方法、成员变量、参数等都可以被注解进行标注。

自定义注解 — 格式

• 自定义注解就是自己做一个注解来使用。
  

示例（自定义注解）：

示例（使用自定义注解）：

注解的作用是什么呢？

• 对Java中类、方法、成员变量做标记，然后进行特殊处理，至于到底做何种处理由业务需求来决定。
• 例如：JUnit框架中，标记了注解@Test的方法就可以被当成测试方法执行，而没有标记的就不能当成测试方法执行。

特殊属性

• value属性，如果只有一个value属性的情况下，使用value属性的时候可以省略value名称不写!!
• 但是如果有多个属性, 且多个属性没有默认值，那么value名称是不能省略的。

示例（自定义注解）：

示例（使用自定义注解）：

2. 元注解

元注解

• 元注解：注解注解的注解。

元注解有两个：

• @Target: 约束自定义注解只能在哪些地方使用，
• @Retention：申明注解的生命周期

@Target中可使用的值定义在ElementType枚举类中，常用值如下

• TYPE，类，接口
• FIELD, 成员变量
• METHOD, 成员方法
• PARAMETER, 方法参数
• CONSTRUCTOR, 构造器
• LOCAL_VARIABLE, 局部变量

@Retention中可使用的值定义在RetentionPolicy枚举类中，常用值如下

• SOURCE： 注解只作用在源码阶段，生成的字节码文件中不存在
• CLASS： 注解作用在源码阶段，字节码文件阶段，运行阶段不存在，默认值.
• RUNTIME：注解作用在源码阶段，字节码文件阶段，运行阶段（开发常用）

示例（自定义注解）：

示例（使用自定义注解）：

3. 注解的解析

注解的解析

• 注解的操作中经常需要进行解析，注解的解析就是判断是否存在注解，存在注解就解析出内容。

与注解解析相关的接口

• Annotation: 注解的顶级接口，注解都是Annotation类型的对象
• AnnotatedElement:该接口定义了与注解解析相关的解析方法
  
• 所有的类成分Class, Method , Field ,
  Constructor，都实现了AnnotatedElement接口他们都拥有解析注解的能力

解析注解的技巧

• 注解在哪个成分上，我们就先拿哪个成分对象。
• 比如注解作用成员方法，则要获得该成员方法对应的Method对象，再来拿上面的注解
• 比如注解作用在类上，则要该类的Class对象，再来拿上面的注解
• 比如注解作用在成员变量上，则要获得该成员变量对应的Field对象，再来拿上面的注解

示例（自定义注解）：

示例（使用自定义注解）

示例（解析自定义注解）：

注解解析的案例

需求：注解解析的案例

分析

1、定义注解Book，要求如下：

• 包含属性：String value() 书名
• 包含属性：double price() 价格，默认值为 100
• 包含属性：String[] authors() 多位作者
• 限制注解使用的位置：类和成员方法上
• 指定注解的有效范围：RUNTIME

2、定义BookStore类，在类和成员方法上使用Book注解

3、定义AnnotationDemo01测试类获取Book注解上的数据

示例（自定义注解）：

示例（使用自定义注解）：

示例（解析自定义注解）：

4. 应用场景

模拟Junit框架

需求

• 定义若干个方法，只要加了MyTest注解，就可以在启动时被触发执行

分析

• 定义一个自定义注解MyTest，只能注解方法，存活范围是一直都在。
• 定义若干个方法，只要有@MyTest注解的方法就能在启动时被触发执行，没有这个注解的方法不能执行

示例（自定义注解）：

示例（使用自定义注解）：

示例（解析/实现自定义注解）：