自定义注解

自定义注解关键词 @interface。具体实现可参考下面代码。

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ExcelColumn {

    String value() default "";

    int col() default 0;

}

value() 和 col() 就是使用这个注解时，里面的属性。

---

解释下 @Target、@Retention、@Documented注解的作用。

@Target 指的是注解的作用目标。
@Target(ElementType.TYPE)——接口、类、枚举、注解
@Target(ElementType.FIELD)——字段、枚举的常量
@Target(ElementType.METHOD)——方法
@Target(ElementType.PARAMETER)——方法参数
@Target(ElementType.CONSTRUCTOR) ——构造函数
@Target(ElementType.LOCAL_VARIABLE)——局部变量
@Target(ElementType.ANNOTATION_TYPE)——注解
@Target(ElementType.PACKAGE)——包

@Retention 作用是定义被它所注解的注解保留多久，一共有三种策略，定义在 RetentionPolicy 枚举中。
source：注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃；被编译器忽略。
class：注解被保留到class文件，但jvm加载class文件时候被遗弃，这是默认的生命周期。
runtime：注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在。
这3个生命周期分别对应于：Java源文件(.java文件) —> .class文件 —> 内存中的字节码。

@Documented注解，如果使用@Documented标注了，在生成javadoc的时候就会把@Documented注解给显示出来。如果不是使用 jdk9 以上的且也不生成文档注释则没多大用处。