Java 自定义注解及使用场景

Java自定义注解一般使用场景为：自定义注解+拦截器或者AOP，使用自定义注解来自己设计框架，使得代码看起来非常优雅。
本文将先从自定义注解的基础概念说起，然后开始实战，写小段代码实现自定义注解+拦截器，自定义注解+AOP。

一. 什么是注解(Annotation)

Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。

Java 语言中的类、方法、变量、参数和包等都可以被标注。和 Javadoc 不同，Java 标注可以通过反射获取标注内容。在编译器生成类文件时，标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容，在运行时可以获取到标注内容 。 当然它也支持自定义 Java 标注。

二. 注解体系图

内置的注解：Java 定义了一套注解，共有 7 个，3 个在 java.lang 中，剩下 4 个在 java.lang.annotation 中。

作用在代码的注解是

@Override - 检查该方法是否是重写方法。如果发现其父类，
或者是引用的接口中并没有该方法时，会报编译错误。
@Deprecated - 标记过时方法。如果使用该方法，会报编译警告。
@SuppressWarnings - 指示编译器去忽略注解中声明的警告。

作用在其他注解上的注解(称为 元注解)是:

@Retention - 标识这个注解怎么保存，是只在代码中，还是编入class文件中，
或者是在运行时可以通过反射访问。
    取值在java.lang.annotation.RetentionPolicy中，取值为：
    SOURCE：在源文件中有效，编译过程中会被忽略
    CLASS：随源文件一起编译在class文件中，运行时忽略
    RUNTIME：在运行时有效
    只有定义为RetentionPolicy.RUNTIME时，我们才能通过注解反射获取到注解。
    
@Documented - 标记这些注解是否包含在用户文档中。

@Target - 描述了注解修饰的对象范围，取值在java.lang.annotation.ElementType定义，
常用的包括：
     METHOD：用于描述方法
     PACKAGE：用于描述包
     PARAMETER：用于描述方法变量
     TYPE：用于描述类、接口或enum类型


@Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

三. 如何拿到我们定义的注解

注解处理类：既然上面定义了注解，那得有办法拿到我们定义的注解啊。java.lang.reflect.AnnotationElement接口则提供了该功能。注解的处理是通过java反射来处理的。如下，反射相关的类Class, Method, Field都实现了AnnotationElement接口。

因此，只要我们通过反射拿到Class, Method, Field类，就能够通过getAnnotation(Class)拿到我们想要的注解并取值。

四. 示例-反射获取注解

先定义一个注解：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyField {
   
    String description();
    int length();
}

通过反射获取注解：

import java.lang.reflect.Field;

public class Main {
   
    //使用我们的自定义注解
    @MyField(description = "用户名", length = 12)
    private String username;

    public void testMyField(){
   
        // 获取类模板
        Class c = Main.class;
        // 获取所有字段
        for(Field f : c.getDeclaredFields()){
   
            // 判断这个字段是否有MyField注解
            if(f.isAnnotationPresent(MyField.class)){
   
                MyField annotation = f.getAnn