一、介绍:
1、概念:
注解(Annotation),也叫 元数据 (metadata),一种代码级别的说明。 Java 注解就是代码中的一些特殊标记(元信息),用于在编译、类加载、运行时进行解析和使用,并执行相应的处理。
它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。
2、原理
它本质是继承了 Annotation 的特殊接口,其具体实现类是 JDK 动态代理生成的代理类,通过反射获取注解时,返回的也是 Java 运行时生成的动态代理对象 $Proxy1。通过代理对象调用自定义注解的方法,会最终调用 AnnotationInvocationHandler 的 invoke 方法,该方法会从 memberValues 这个Map中查询出对应的值,而 memberValues 的来源是Java常量池4
3、作用:
Java 语言中的类、 构造器、 方法、成员变量、局部变量、方法参数等都可以被注解进行标记,然后做特殊的处理。
(1)生成文档:java最早的提供的注解
(2)编译检查:通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】
(3)代码分析:通过代码里标识的元数据对代码进行分析【使用反射】
(4)替代配置文件:跟踪代码依赖性,实现替代配置文件功能,比较常见的是spring 2.5 开始的基于注解配置,作用就是减少配置。
4、注解失效/不成功的场景
(1)注解加在private上,编译既不报错也不会有任何提示,默认忽略,实际功能却不会生效。原因在于,spring AOP无法实现或者继承private方法。Spring使用AOP代理代理有2种,分别是基于接口和基于类;而这2种代理机制均不能实现或继承private方法。
二、自定义注解
java中的注解有原生注解(后面介绍常用的系统原生注解),还可以自定义注解。
自定义注解的方式:
① 创建一个自定义注解:与创建接口类似,但自定义注解需要使用 @interface
② 添加元注解信息,比如 @Target、@Retention、@Document、@Inherited 等
③ 创建注解方法,但注解方法不能带有参数
④ 注解方法返回值为基本类型、String、Enums、Annotation 或其数组
⑤ 注解可以有默认值;
@Target(FIELD)
@Retention(RUNTIME)
@Documented
public @interface CarName {
String value() default "";
}