深入理解Java:注解(Annotation)自定义注解入门
要深入学习注解,我们就必须能定义自己的注解,并使用注解,在定义自己的注解之前,我们就必须要了解Java为我们提供的元注解和相关定义注解的语法。
元注解:
元注解的作用就是负责注解其他注解。Java50定义了4个标准的meta-annotation类型,它们被用来提供对其它 annotation类型作说明。Java50定义的元注解:
1@Target,
2@Retention,
3@Documented,
4@Inherited
这些类型和它们所支持的类在javalangannotation包中可以找到。下面我们看一下每个元注解的作用和相应分参数的使用说明。
@Target:
@Target说明了Annotation所修饰的对象范围:Annotation可被用于 packages、types(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。
作用:用于描述注解的使用范围(即:被描述的注解可以用在什么地方)
取值(ElementType)有:
1CONSTRUCTOR:用于描述构造器
2FIELD:用于描述域
3LOCAL_VARIABLE:用于描述局部变量
4METHOD:用于描述方法
5PACKAGE:用于描述包
6PARAMETER:用于描述参数
7TYPE:用于描述类、接口(包括注解类型) 或enum声明
使用实例:
@Target(ElementTypeTYPE)
public @interface Table {
/
数据表名称注解,默认值为类名称
@return
/
public String tableName() default "className";
}
@Target(ElementTypeFIELD)
public @interface NoDBColumn {
}
注解Table 可以用于注解类、接口(包括注解类型) 或enum声明,而注解NoDBColumn仅可用于注解类的成员变量。
@Retention:
@Retention定义了该Annotation被保留的时间长短:某些Annotation仅出现在源代码中,而被编译器丢弃;而另一些却被编译在class文件中;编译在class文件中的Annotation可能会被虚拟机忽略,而另一些在class被装载时将被读取(请注意并不影响class的执行,因为Annotation与class在使用上是被分离的)。使用这个meta-Annotation可以对 Annotation的“生命周期”限制。
作用:表示需要在什么级别保存该注释信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效)
取值(RetentionPoicy)有:
1SOURCE:在源文件中有效(即源文件保留)
2CLASS:在class文件中有效(即class保留)
3RUNTIME:在运行时有效(即运行时保留)
Retention meta-annotation类型有唯一的value作为成员,它的取值来自javalangannotationRetentionPolicy的枚举类型值。具体实例如下:
@Target(ElementTypeFIELD)
@Retention(RetentionPolicyRUNTIME)
public @interface Column {
public String name() default "fieldName";
public String setFuncName() default "setField";
public String getFuncName() default "getField";
public boolean defaultDBValue() default false;
}
Column注解的的RetentionPolicy的属性值是RUTIME,这样注解处理器可以通过反射,获取到该注解的属性值,从而去做一些运行时的逻辑处理
@Documented:
@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解,没有成员。
@Target(ElementTypeFIELD)
@Retention(RetentionPolicyRUNTIME)
@Documented
public @interface Column {
public String name() default "fieldName";
public String setFuncName() default "setField";
public String getFuncName() default "getField";
public boolean defaultDBValue() default false;
}
@Inherited:
@Inherited 元注解是一个标记注解,@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。
注意:@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。
当@Inherited annotation类型标注的annotation的Retention是RetentionPolicyRUNTIME,则反射API增强了这种继承性。如果我们使用javalangreflect去查询一个@Inherited annotation类型的annotation时,反射代码检查将展开工作:检查class和其父类,直到发现指定的annotation类型被发现,或者到达类继承结构的顶层。
支持aspectj和jitpack,在工程的grade添加
在使用的module的grade中添加依赖和注解处理器,以及支持aspectj
需要支持lambda 表达式,在模块的buildgradle的android节点下面添加支持
需要使用注解的类中需要初始化
该注解用于控件的初始化,可以传入控件的ID,当控件的ID和变量名一致是可以不传入
被注解的变量名可以和控件ID值不一样,但是需要手动设置控件ID值,这种方法只能在 app 模块使用
该注解为设置控件的点击事件,同样可以传入控件ID,改方法不需要初始化控件,可以直接使用
新增防抖动功能,使用了 @Click 注解的按钮默认在300ms内只能点击一次,可以通过设置全局修改,也可以修改单个点击事件的间隔
该注解为方法切换到子线程运行,可以进行延迟执行,方法不能有返回值,否则不生效, delay 值默认为0
该注解为方法切换到主线程运行,可以进行延迟执行,方法不能有返回值,否则不生效, delay 值默认为0
该注解为RecyclerView滑动到底部监听,可以实现下拉加载更多的功能,使用很方便,变量名就是方法名,也可以手动设置控件ID值;可以设置 pageSize 的值,如果当前加载的item数量小于 pageSize 那么就不会触发方法,默认滑动到底部监听就会触发方法
该注解为CheckBox的OnCheckedChange监听方法,被注解的方法需要有下面两个参数
该注解为获取被注解的方法执行的时间
该注解为自定义注解,用于监听方法执行使用,可以用于数据埋点啥的;
Github: >
其实就是参考的@RequestBody注解来实现,@JsonParam可以看着为轻量级的获取Json参数的自定义实现注解。
因为流只能读取一次,所以需要在第一次读取的时候,将解析的对象存入ThreadLocal中,以便于多次使用@JsonParam来进行解析。
SpringBoot2x之HandlerMethodArgumentResolver实战
SpringBoot2x之HandlerMethodArgumentResolver(2)—自定义解析器顺序
以上就是关于如何获取annotation的value全部的内容,包括:如何获取annotation的value、使用注解框架CatAnnotation、SpringBoot2.x之HandlerMethodArgumentResolver(3)—取代@RequestBody注解来获取Json参数等相关内容解答,如果想了解更多相关内容,可以关注我们,你们的支持是我们更新的动力!
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)