Java 注解

1. 元注解Documented

表示这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中，是一个标记注解，没有成员。java元注解 @Documented注解使用 - 就这个名字好 - 博客园

2. 元注解Retention

说明了Annotation（注解）要保持的生命周期，与RetentionPolicy搭配使用：

按生命周期来划分可分为3类：
1、RetentionPolicy.SOURCE：注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃；
2、RetentionPolicy.CLASS：注解被保留到class文件，但jvm加载class文件时候被遗弃，这是默认的生命周期；
3、RetentionPolicy.RUNTIME：注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在；

https://blog.csdn.net/fn0723/article/details/84962441

3. 元注解Target

说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了target可更加明晰其修饰的目标

java元注解 @Target注解用法 - 就这个名字好 - 博客园

@Target(ElementType.METHOD)
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Function {

    String name;
    ...
}

4. 注解浅用

定义一个注解：

@Target(ElementType.METHOD)
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Function {
    boolean identification();
    String name();
}

方法上添加该注解

该方法的调用上面会出现这个注解