Java-自定义注解
注解含义:
注解其实相当于是标记,可以用在方法、类、参数和包上,程序在编译或者运行时可以检测到这些标记而进行一些处理
使用场景:
自定义注解 拦截器 AOP
声明方式:
// 通过关键字 @interface 声明为注解
public @interface EnableCustomSwagger2 {
}
元素类型:
主要有@Target @Retention @Document @Inherited
@Target
表明该注解可以应用的java元素类型
项目 | Value |
---|---|
ElementType.TYPE | 应用于类、接口(包括注解类型)、枚举 |
ElementType.FIELD | 应用于属性(包括枚举中的常量) |
ElementType.METHOD | 应用于方法 |
ElementType.PARAMETER | 应用于方法的形参 |
ElementType.CONSTRUCTOR | 应用于构造函数 |
ElementType.LOCAL_VARIABLE | 应用于局部变量 |
ElementType.ANNOTATION_TYPE | 应用于注解类型 |
ElementType.PACKAGE | 应用于包 |
ElementType.TYPE_PARAMETER | 1.8版本新增,应用于类型变量) |
ElementType.TYPE_USE | 1.8版本新增,应用于任何使用类型的语句中(例如声明语句、泛型和强制转换语句中的类型) |
@Retention
表明该注解的生命周期
生命周期类型 | 描述 |
---|---|
RetentionPolicy.SOURCE | 编译时被丢弃,不包含在类文件中 |
RetentionPolicy.CLASS | JVM加载时被丢弃,包含在类文件中,默认值 |
RetentionPolicy.RUNTIME | 由JVM 加载,包含在类文件中,在运行时可以被获取到 |
@Documented
表明该注解标记的元素可以被Javadoc 或类似的工具文档
@Inherited
表明使用了@Inherited注解的注解,所标记的类的子类也会拥有这个注解
自定义注解 案例:
@Inherited
//该注解可以应用于方法上
@Target(ElementType.METHOD)
//该注解的生命周期,由JVM 加载,包含在类文件中,在运行时可以被获取到
@Retention(RetentionPolicy.RUNTIME)
//该注解标记的元素可以被Javadoc 或类似的工具文档化
@Documented
public @interface RepeatSubmit {
public int age() default 18;
public String name() default "大灰狼";
}