自定义注解应用场景
自定义注解的使用场景很多,我们在造轮子写框架的过程经常会使用到。在我们平时的项目场景中,也可以随处可以看到自定义注解可以发挥作用的场景,例如:
1)全局日志的打印
2)用户权限的校验
3)登录的校验
4)数据脱敏
等等场景。
元注解
1、@Retention
@Retention annotation指定标记注释的存储方式:
RetentionPolicy.SOURCE - 标记的注释仅保留在源级别中,并由编译器忽略。
RetentionPolicy.CLASS - 标记的注释在编译时由编译器保留,但Java虚拟机(JVM)会忽略。
RetentionPolicy.RUNTIME - 标记的注释由JVM保留,因此运行时环境可以使用它。
2、@Documented
@Documented 注释表明,无论何时使用指定的注释,都应使用Javadoc工具记录这些元素(默认情况下,注释不包含在Javadoc中)。有关更多信息,请参阅 Javadoc工具页面。
3、@Target
@Target 注释标记另一个注释,以限制可以应用注释的Java元素类型。目标注释指定以下元素类型之一作为其值。
ElementType.TYPE 可以应用于类的任何元素。
ElementType.FIELD 可以应用于字段或属性。
ElementType.METHOD 可以应用于方法级注释。
ElementType.PARAMETER 可以应用于方法的参数。
ElementType.CONSTRUCTOR 可以应用于构造函数。
ElementType.LOCAL_VARIABLE 可以应用于局部变量。
ElementType.ANNOTATION_TYPE 可以应用于注释类型。
ElementType.PACKAGE 可以应用于包声明。
ElementType.TYPE_PARAMETER
ElementType.TYPE_USE
4、@Inherited
@Inherited 注释表明注释类型可以从超类继承。当用户查询注释类型并且该类没有此类型的注释时,将查询类的超类以获取注释类型(默认情况下不是这样)。此注释仅适用于类声明。
5、@Repeatable
Repeatable Java SE 8中引入的,@Repeatable注释表明标记的注释可以多次应用于相同的声明或类型使用(即可以重复在同一个类、方法、属性等上使用)。
应用场景
1、 自定义注解鉴权代码示例:定义在类上
@Pointcut("execution()") 切点:注解用到的位置
====================================================================
/**
* @Description 菜单控制注解
* @Version 1.0
*/
@Inherited
@Documented
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface CheckPermission {
//存储角色名称
String value();
}
============================