java注解初步学习和使用

1 自定义注解之@Target、@Retention注解和@Documented

参考：https://blog.csdn.net/github_35180164/article/details/52118286
https://www.jianshu.com/p/ba1d384dceec

2.1 @Target注解

@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。
看下自定义注解的简单使用方式，定义3个运行时注解：

// 适用类、接口（包括注解类型）或枚举
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface ClassInfo {
    String value();
}
// 适用field属性，也包括enum常量
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface FieldInfo {
    int[] value();
}
// 适用方法
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MethodInfo {
    String name() default "long";
    String data();
    int age() default 27;
}

2.2 @Retention注解

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

2.3 @Documented注解

这3个生命周期分别对应于：Java源文件(.java文件) —> .class文件 —> 内存中的字节码。
Documented 注解表明这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中

2 自定义注解之@AliasFor注解（用于为注解属性声明别名）

参考：https://www.jianshu.com/p/d6bba708100d
在同个注解中为同一个功能定义两个名称不一样的属性，那么这两个属性彼此互为别名，别名的作用也就是在定义多个属性时为了能做到顾名思义，随意用都行。

2.1 显式别名

@AnonymousAccess
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@RequestMapping(method = RequestMethod.DELETE)
public @interface AnonymousDeleteMapping {

    @AliasFor(annotation = RequestMapping.class)
    String name() default "";

    @AliasFor(annotation = RequestMapping.class)
    String[] value() default {};

    @AliasFor(annotation = RequestMapping.class)
    String[] path() default {};

    @AliasFor(annotation = RequestMapping.class)
    String[] params() default {};

}

这里的四组别名用法是一致的！AnonymousDeleteMapping中的name、value、path和params是彼此的显性别名，使用的时候可以通过任意属性名来指定。
（注：@AliasFor的annotation属性必须引用元注解，被引用的元注解必须放置在声明了@AliasFor的注解类上，如RequestMapping；因为annotation是RequestMapping类，需要传入的是地址；）
具体使用：

@RequestMapping(value = "/login")

@AnonymousPostMapping(value = "/login")

@AnonymousPostMapping(path = "/login")

2.2 隐式别名

如果注解中的一个或多个属性声明为同一个元注解属性的属性重写（直接地或传递地重写）那么这些注解会被当作彼此的隐性别名集来对待

@ContextConfiguration
public @interface MyContextConfiguration{

    @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
    String[] values() default {};
    
    @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
    String[] path() default {};
}

@MyContextConfiguration中,valueh和path都是复写了@ContextConfiguration中locations属性。
具体使用：

@ContextConfiguration(locations = {})

@MyContextConfiguration(values = {})

2.3 使用规则

参考上面url即可。