手写Spring框架-前奏-注解与自定义注解

目录

注解

介绍

功能

分类

注解处理器类库

自定义注解

常用元注解

自定义

---

• 注解

• 介绍

• 提供一种为程序元素设置元数据的方法
• 用来将任何的信息或元数据（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 对象