深入浅出注解,框架设计的基础

何为注解

注解(Annotation)是 Java 中的一个类型,通俗地理解就像一个标签,贴在了代码上。众所周知,Spring 支持大量注解,基于注解可以完成 Bean 的注入和生命周期管理,注解也是取代 xml 配置的一种方法。使用注解可以把元数据和源代码绑定在一起,可以用于描述代码无法描述的信息,并在编译或运行中使用。

在 Java 中使用注解非常简单,比如我们可以定义一个用于标记类型的注解,并根据这个注解从 Spring 中提取出相应的 Bean。在这段代码中,我们使用了 Java 自带的注解 @Retention、@Override,Spring 提供的注解 @Service、@PostConstruct,以及自定义的注解 @MyAnnotation。

@Service
@MyAnnotation
public class TestAnnotation implements ApplicationContextAware {
    ApplicationContext context;

    //定义一个注解
    @Retention(RetentionPolicy.RUNTIME)
    @interface MyAnnotation{}

    @Override
    public void setApplicationContext(ApplicationContext context) throws BeansException {
        this.context = context;
    }

    @PostConstruct
    private void init(){
        Map beans = context.getBeansWithAnnotation(MyAnnotation.class);
        System.out.println("找到 bean " + beans.keySet());
    }
}

定义注解

定义注解非常像定义接口,在 interface 关键词前面加了一个 @。实际上,注解类型与其他类型一样,最终也是编译成 class 文件。定义注解需要用到一些元注解,这些元注解是 Java 语言提供的,用来定义注解的一些特性。

元注解 @Inherited 用于声明该注解支持子类继承父类中的注解。

元注解 @Documented 用于声明该注解需要包含到 Javadoc 中。

元注解 @Retention 定义注解的级别,可选值定义在 RetentionPolicy 枚举类,包括运行时(RUNTIME)、类文件(CLASS)、源代码(SOURCE)。

元注解 @Target 定义注解的使用范围,值的类型是 ElementType 枚举值。注解的使用范围可以设置一个或多个,常用的有 ElementType.TYPE 表示用于 Java 类、ElementType.METHOD 表示用于 Java 方法、ElementType.FIELD 表示用于类的字段、ElementType.PARAMETER 表示用于方法的参数。

注解支持定义元素,定义的形式有点类似方法定义,并可以使用 default 设置默认值。如下代码中定义的值为 value,获取值调用 value() 即可,如果使用时没有给出值则默认值为 test。需要注意的是注解的默认值不能是 null,最终一定会有一个值。如果需要表示值不存在,需要自己定义一个特殊值来表示。

注解的元素类型支持基本类型、String、Class、enum、Annotation 以及这些类型的数组。

//定义一个注解
@Inherited
@Documented
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation2 {
    String value() default "test";
}

从 Java 8 开始,新增了元注解 @Repeatable,用于表示注解可以有多个值。如下的代码 SingleAnnotation 可以有多个值,使用 @Repeatable 声明了多个值合并为注解 @RepeatAnnotation。这种情况下,@RepeatAnnotation 的元素必须有 value,且类型必须为 SingleAnnotation 数组,才能进行聚合。

使用时,@SingleAnnotation 可以定义多次给出多个不同的值,解析注解时则需要按照 @RepeatAnnotation 进行解析。关于注解的解析,请参考后文注解处理器。

@Retention(RetentionPolicy.RUNTIME)
@interface RepeatAnnotation {
    SingleAnnotation[] value();
}

@Retention(RetentionPolicy.RUNTIME)
@Repeatable(RepeatAnnotation.class)
@interface SingleAnnotation{
    String value();
}

@SingleAnnotation("hello")
@SingleAnnotation("world")
public class RepeatAnnotationTest{
    public static void main(String[] args){
        RepeatAnnotation annotation = RepeatAnnotationTest.class.getAnnotation(RepeatAnnotation.class);
        for (SingleAnnotation singleAnnotation : annotation.value()) {
            System.out.println(singleAnnotation.value());
        }
    }
}

Java 中的注解不支持继承,因此不能使用 extends 关键字。但是注解可以进行嵌套,也就是一个注解的值是另一个注解。如下的代码中,MyAnnotation3 注解的第二个值类型为 MyAnnotation2,使用时对第二个值赋值一样需要按照注解的格式写为 @MyAnnotation2("world")。

public @interface MyAnnotation3 {
    String value() default "test";
    MyAnnotation2 annotation();
}

@MyAnnotation3(value = "hello"
    ,annotation = @MyAnnotation2("world"))
private void test2(){}

注解处理器

定义注解以后需要编写注解处理器,才能发挥注解的作用。在最开始的例子中,我们定义的注解处理器从 Spring 上下文中找出所有使用了注解 MyAnnotation 的 Java Bean,然后打印出这些 Bean 的名字。

@PostConstruct
private void init(){
    Map beans = context.getBeansWithAnnotation(MyAnnotation.class);
    System.out.println("找到 bean " + beans.keySet());
}

在 Java 中可以通过反射很方便地处理注解。对于 Class 上面的注解,可以通过 Class 的方法获取所有注解或指定注解,如下所示。

//获取类型的所有注解
TestAnnotation.class.getAnnotations();
TestAnnotation.class.getDeclaredAnnotations();
//获取类型的指定注解
TestAnnotation.class.getAnnotation(MyAnnotation.class);
TestAnnotation.class.getDeclaredAnnotation(MyAnnotation.class);

对于方法上的注解,可以通过 Method 的方法获取所有注解或指定注解,如下所示。Method 还提供了 getParameterAnnotations() 来获取方法参数上面的所有注解,每个参数的注解都是一个数组,返回值为二维数组。

Method init = TestAnnotation.class.getDeclaredMethod("init");
//获取方法的所有注解
init.getAnnotations();
init.getDeclaredAnnotations();
//获取方法的指定注解
init.getAnnotation(PostConstruct.class);
init.getDeclaredAnnotation(PostConstruct.class);
//获取方法的参数的所有注解,返回二维数组
init.getParameterAnnotations();

对注解进行处理时,注解可以当做普通的变量对待。如下代码所示,annotation 是一个注解类型的变量,与普通变量区别不大,可以有类型定义,值也可以是 null。但是读取注解的值时,需要调用方法,如 annotation.value()。

MyAnnotation2 annotation = TestAnnotation.class.getAnnotation(MyAnnotation2.class);
if(annotation != null){
    System.out.println(annotation.value());
}

结语

关于 Java 注解,本文只覆盖这些内容。注解是一个被广泛使用的特性,如 Java 本身的 @Override、Spring 中的 @Service @Autowired、MyBatis 中的 @Insert @Update 等。基于注解,实现了对代码的自动化处理,如扫描和自动注入 JavaBean,大大简化了 Java 程序员的开发工作。正因如此,我们不仅需要了解常用的注解使用方式,还需要深入理解注解背后的工作原理。

本文首发于公众号程序之心,每天给你诚意满满的干货,欢迎关注。

你可能感兴趣的:(深入浅出注解,框架设计的基础)