0.前言

• Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。
• 类、方法、变量、参数和包都可以增加注解
• Java 虚拟机可以保留标注内容，在运行时可以获取到注解内容
• 注解已经是大行其道了，在很多第三方框架上都有注解的身影。
• 通过增加注解。给该元素附加一些额外的说明。
• 注解主要是在反射中使用，可以通过注解获得元素的各种注解。通过注解附加的信息进行一些操作。对于解耦很有帮助。
• 注解类本身是一种特殊的类。自定义了一个注解类后，就可以在代码中通过@Annotation来使用它
• 注意。。注意。。。注解和反射都是针对类而言。。。对不同对象同一个类进行反射，得到同样的一个个field,method,class对象。这个可以参照第4点来理解，第4点可以动态修改整改类的注解。

1.注解类的声明

• 其中@Target和@Retention为注解类的注解
• @Target，表明该注解类的作用范围。一个注解类可以有多个@Target注解
• @Retention，表明注解的保持范围，一般为RUNTIME。一个注解类仅仅只能有一个@Retention
• String editor() default "TextFieldTableCell";该语句声明了一个特殊的方法。该方法名称为editor()，范围值类型为String，默认值为 "TextFieldTableCell"
• 一个注解类可以声明多个方法，每个方法的返回值类型可以多种多样，如枚举，某个对象，甚至是class对象。

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation1 {
    String editor() default "TextFieldTableCell";
    String[] optionalValue() default {""};
    RetentionPolicy value();
}

package java.lang.annotation;
public enum RetentionPolicy {
    SOURCE,            /* Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该Annotation信息了  */
    CLASS,             /* 编译器将Annotation存储于类对应的.class文件中。默认行为  */
    RUNTIME            /* 编译器将Annotation存储于class文件中，并且可由JVM读入 */
}

package java.lang.annotation;
public enum ElementType {
    TYPE,               /* 类、接口（包括注释类型）或枚举声明  */
    FIELD,              /* 字段声明（包括枚举常量）  */
    METHOD,             /* 方法声明  */
    PARAMETER,          /* 参数声明  */
    CONSTRUCTOR,        /* 构造方法声明  */
    LOCAL_VARIABLE,     /* 局部变量声明  */
    ANNOTATION_TYPE,    /* 注释类型声明  */
    PACKAGE             /* 包声明  */
}

2.注解类的使用

• 声明了一个注解类后，就可以在对象的元素中使用了。
• 对注解的方法进行赋值，有点类似于对变量进行赋值的语句，只是多个方法赋值语句用,分开。以下例子，展示了字符串，class对象，字符串数组的赋值语句。
• value方法的赋值，该方法可以省略等号左边的方法名称。如@Retention(RetentionPolicy.RUNTIME)
• 注解类的使用，可以理解为定义了一个注解对象。该注解对象，带有附加信息的属性值。

@Entity
@Table(name = "missions")
@TableIncludeIndexColumn(name = "序号")
@Convert(converter = StringPropertyConvertor.class)
public class Mission {
    @Id
    @Column(name = "id")
    @GeneratedValue(generator = "uuid")
    @GenericGenerator(name = "uuid", strategy = "uuid")
    private String id;

     @ColumnDescribe(name = "停电类型", index = 3, editor = "ComboBoxTableCell", optionalValue = {"停电","不停电","带电"})
    @Convert(converter = StringPropertyConvertor.class)
    private StringProperty missionDate;
}

3. 通过反射获取一个元素的注解

• 这里需要了解下反射知识，才能更好的理解
• 如下例子，是获取一个类的注解，当然对于方法或变量也是同样处理。这些类和方法和变量被包装成一个个field,method,class对象
• 注意，之前声明的是一个注解类，如下方法获得一个注解对象。可以通过这个注解对象访问注解的方法，获得注解值。

Class theClass = Class.forName("homework01.User");
Class missionClass = Mission.class;
boolean hasAnn = theClass.isAnnotationPresent(MyAnnotation.class)

//获取一个注解对象
MyAnnotation myAnn = theClass.getAnnotation(MyAnnotation.class);

//获取全部类方法，并通过是否有注解来筛选
Arrays.stream(modelClass.getDeclaredFields())
                .filter(field -> field.getAnnotation(ColumnDescribe.class) != null)

4. 动态修改注解值

• 如下代码事实上是利用了反射。
• 对注解代理对象进行反射，修改该对象的表示注解元素的变量值。

ColumnDescribe annotation = Mission.class.getDeclaredField("missionType").getAnnotation(ColumnDescribe.class);
System.out.println("修改前：" + annotation.index());

InvocationHandler invocationHandler = Proxy.getInvocationHandler(annotation);

Field value = invocationHandler.getClass().getDeclaredField("memberValues");
value.setAccessible(true);
Map<String, Object> memberValues = (Map<String, Object>) value.get(invocationHandler);
memberValues.put("index",999);
System.out.println("修改后：" +annotation.index());

参考文章

1.Java 注解（Annotation）
2.反射机制获取一个类的注解
3.[Java] 通过反射，动态修改注解的某个属性值