简述
注解本质是一个继承了Annotation的特殊接口,其具体实现类是Java运行时生成的动态代理类。而我们通过反射获取注解时,返回的是Java运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解(接口)的方法,会最终调用AnnotationInvocationHandler的invoke方法。该方法会从memberValues这个Map中索引出对应的值。而memberValues的来源是Java常量池。
实际上Java注解与普通修饰符(public、static、void等)的使用方式并没有多大区别,下面的例子是常见的注解:
1 public class AnnotationDemo { 2 3 @Test 4 public static void A(){ 5 System.out.println("Test....."); 6 } 7 @Deprecated 8 @SuppressWarnings("uncheck") 9 public static void B(){ 10 11 } 12 }
基本语法
使用 Annotation 时要在其前面增加 @ 符号, 并把该 Annotation 当成一个修饰符使用.
用于修饰它支持的程序元素 三个基本的 Annotation:
- @Override:限定重写父类方法, 该注释只能用于方法
@Target(ElementType.METHOD) @Retention(RetentionPolicy.SOURCE) public @interface Override {}
- @Deprecated: 用于表示某个程序元素(类, 方法等)已过时
@Documented@Retention(RetentionPolicy.RUNTIME) @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE}) public @interface Deprecated {}
- @SuppressWarnings: 抑制编译器警告.
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE}) @Retention(RetentionPolicy.SOURCE) public @interface SuppressWarnings { String[] value(); }
注解的应用结构图
注解不支持继承
注解是不支持继承的,因此不能使用关键字extends来继承某个@interface,但注解在编译后,编译器会自动继承java.lang.annotation.Annotation接口,这里我们反编译前面定义的DBTable注解:
package com.zejian.annotationdemo; import java.lang.annotation.Annotation; public interface DBTable extends Annotation{ public abstract String name(); }
虽然反编译后发现DBTable注解继承了Annotation接口,请记住,即使Java的接口可以实现多继承,但定义注解时依然无法使用extends关键字继承@interface。
为注解增加高级属性
- 数组类型的属性
- int [] arrayAttr() default {1,2,3};
- @MyAnnotation(arrayAttr={2,3,4})
- 如果数组属性中只有一个元素,这时候属性值部分可以省略大括
- 枚举类型的属性
- EnumTest.TrafficLamp lamp() ;
- @MyAnnotation(lamp=EnumTest.TrafficLamp.GREEN)
- 注解类型的属性:
- MetaAnnotation annotationAttr() default
- @MetaAnnotation("xxxx"); @MyAnnotation(annotationAttr=@MetaAnnotation(“yyy”) )
- 可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象,同样的道理,可以认为上面这个@MetaAnnotation是MetaAnnotation类的一个实例对象,调用代码如下:
MetaAnnotation ma = myAnnotation.annotationAttr();
System.out.println(ma.value());
- 注解的详细语法可以通过看java语言规范了解,即看java的language specification。
心得:
只有脚踏实地的人,才能够说:“路” 就在我脚下。