自定义注解
Add https://blog.csdn.net/ACMer_AK/article/details/78727797
自定义注解的例子
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Msg {
String DEFAULT_MSG = "msg";
String msg() default DEFAULT_MSG
}
自定义注解分析:
- @interface关键字定义注解;
- 注解可以被其它注解修饰,最重要的就是元注解;
- 注解和接口类似,内部可以定义常量和方法;
- 注解定义的方法有一些限制:
- 方法不能有参数;
- 返回值只能是基本类型、字符串、Class、枚举、注解、及以上类型的数组;
- 可以包含默认值。
元注解
元注解就是定义注解的注解,包含@Target、@Retention、@Inherited、@Documented这四种。
@Target
描述注解的使用目标,取值有:
- ElementType.PACKAGE 注解作用于包
- ElementType.TYPE 注解作用于类型(类,接口,注解,枚举)
- ElementType.ANNOTATION_TYPE 注解作用于注解
- ElementType.CONSTRUCTOR 注解作用于构造方法
- ElementType.METHOD 注解作用于方法
- ElementType.PARAMETER 注解作用于方法参数
- ElementType.FIELD 注解作用于属性
- ElementType.LOCAL_VARIABLE 注解作用于局部变量
- 默认可以作用于以上任何目标。
@Retention
描述注解的生命周期,取值有:
- RetentionPolicy.SOURCE 源码中保留,编译期可以处理
- RetentionPolicy.CLASS Class文件中保留,Class加载时可以处理
- RetentionPolicy.RUNTIME 运行时保留,运行中可以处理
- 默认RetentionPolicy.CLASS 值
@Inherited
标记注解,使用@Inherited修饰的注解作用于一个类,则该注解将被用于该类的子类。
@Documented
描述注解可以文档化,是一个标记注解。
在生成javadoc的时候,是不包含注释的,但是如果注解被@Documented修饰,则生成的文档就包含该注解。