目录
注解
介绍
功能
分类
注解处理器类库
自定义注解
常用元注解
自定义
-
注解
-
介绍
- 提供一种为程序元素设置元数据的方法
- 用来将任何的信息或元数据（metadata）与程序元素（类、方法、成员变量等）进行关联
- 元数据是指数据的数据，即对数据的描述
- 元数据是添加到程序元素如方法、字段、类和包上的额外信息
- 注解是一种分散式的元数据设置方式，XML是集中式的设置方式
- 注解不能直接干扰程序代码的运行
- 通俗的讲注解就是将需要的信息保存起来，等我们需要的时候（编译时、运行时）调用
- 注解本质是一个继承了Annotation 的特殊接口
- 其具体实现类是Java 运行时生成的动态代理类
-
功能
- 作为特定的标记,用于告诉编译器一些信息
- 编译时动态处理,如动态生成代码（例如Lombok的@Data 生成实体类的get…方法）
- 运行时动态处理,作为额外信息的载体,如获取注解信息（将路径等信息写入注解类里获取）
-
分类
- 标准注解:
- Override、Deprecated（不被鼓励使用的，不在维护了）、 SuppressWarnings（需要忽略某项）
- 元注解:
- @Retention（生命周期）、@Target（作用目标）、 @Inherited、 @Documented
- 元注解是用于修饰注解的注解，通常用在注解的定义上
- 所有元注解定义在java.lang.annotation包下面
- 其中Annotation是注解的基本接口，所有的注解都继承这个接口
-
注解处理器类库
- AnnotatedElement 接口是所有程序元素（Class、Method和Constructor）的父接口
- 所以程序通过反射获取了某个类的AnnotatedElement对象之后，程序就可以调用该对象的如下方法来访问Annotation信息：
- 方法1：<T extends Annotation> T getAnnotation(Class<T> annotationClass):
- 返回该程序元素上存在的、指定类型的注解，如果该类型注解不存在，则返回null
- 方法2：Annotation[] getAnnotations():
- 返回该程序元素上存在的所有注解
- 方法3：boolean isAnnotationPresent(Class<?extends Annotation> annotationClass):
- 判断该程序元素上是否包含指定类型的注解，存在则返回true，否则返回false
- 方法4：Annotation[] getDeclaredAnnotations(Class annotationClass):
- 返回直接存在于此元素上的所有注解；与此接口中的其他方法不同，该方法将忽略继承的注解（如果没有注解直接存在于此元素上，则返回长度为零的一个数组）该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响
- 返回直接存在于此元素上的所有注解；与此接口中的其他方法不同，该方法将忽略继承的注解（如果没有注解直接存在于此元素上，则返回长度为零的一个数组）该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响
-
自定义注解
-
常用元注解
- java.lang.annotation 提供了四种元注解：
- 专门注解其他的注解（在自定义注解的时候，需要使用到元注解）
- 1---@Documented :注解是否应当被包含在JavaDoc文档中
- 2---@Retention： 指定注解的生命周期（源码、class文件、运行时）
- RetentionPolicy.SOURCE : 在编译阶段丢弃
- 这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码
- 即注解只能在原文件中保留，在编译好的class文件会被消除
- @Override, @SuppressWarnings 都属于这类注解
- RetentionPolicy.CLASS : 在类加载的时候丢弃
- 在字节码文件的处理中有用
- 即注解不仅会在原文件中保留，还在编译好的class文件中
- 注解默认使用这种方式
- RetentionPolicy.RUNTIME : 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息
- 即运行时获得该注解的信息，运行时有效
- 同时还可以通过反射在注解里面获取其他的有用信息
- 自定义的注解通常使用这种方式
- 3---@Target：指定注解使用的目标范围（类、方法、字段等）
- ElementType.CONSTRUCTOR ：用于描述构造器
- ElementType.FIELD ：成员变量、对象、属性（包括enum实例）
- ElementType.LOCAL_VARIABLE: 用于描述局部变量
- ElementType.METHOD ： 用于描述方法
- ElementType.PACKAGE ：用于描述包
- ElementType.PARAMETER ：用于描述参数
- ElementType.ANNOTATION_TYPE：应用于一个注解类型
- ElementType.TYPE ：用于描述类、接口(包括注解类型) 或enum声明
- 4---@Inherited：是否允许子类继承该注解（被该注解修饰的子类自动可以继承父类被注解@Inherited 修饰的注解）只能是类上的注解，方法和字段的注解不能继承
-
自定义
- Annotation 类型定义为@interface
- 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口
- 参数成员只能用 public 或默认(default) 这两个访问权限修饰
- 参数成员只能用八种基本数据类型和String、Enum、Class、annotations等数据类型，以及这些类型的数组
- 要获取类方法和字段的注解信息，必须通过Java的反射技术来获取 Annotation 对象
