深入理解Java高级特性——注解
作者:洛基loky 发布时间:2021-05-23 20:28:54
博主在初学注解的时候看到网上的介绍大部分都是直接介绍用法或者功能,没有实际的应用场景,篇幅又很长导致学习的时候难以理解其意图,而且学完就忘QAQ。本篇文章中我将结合实际的应用场景尽可能由浅入深,平缓的介绍java注解。
java注解是jdk1.5以后新出的特性,对于它的应用非常广泛,我们首先来看一 * 解的应用,百度百科上这样说:
我们可以看到,注解的作用有三方面:
编写doc文档:这个就我们很常用的 @return 以及 @author,加了这些注解以后,就可以用jdk帮我们自动生成对应的API文档了
编译检查:这个也很常见 @Override,而且功能很强大,我将会在以后的文章中介绍
进行代码分析:这是本篇文章的重点。这个和编译检查一样也是一个强大的功能,但相比与编译检查由于其用到了反射,在性能上存在一些问题
后台开发中的SSH三大框架,以及咱们安卓端的retrofit,ButterKnife,Lombok等框架和插件也是大量的用到了注解。这里我将通过手撸一个假的ButterKnife来具体演示注解有什么用,怎么用。
我们首先来看段代码
public class MainActivity extends AppCompatActivity {
@OnClick(R.id.test_btn)
void test(){
test_tv.setText("恭喜您,绑定成功了!");
}
@FindViewByID(R.id.test_tv)
TextView test_tv;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ButterKnife.bindView(this);
}
}
这是一个最基本的activity,里面有2个控件,Button和TextView
在我点击Button后TextView的文字被改变。而我所做的仅仅是ButterKnife.bindView(this)并添加2个注解而已,这样就实现了控件的绑定,省去了很多与业务无关的代码,是不是简洁了很多。
看了注解的功能是不是很想了解它是怎么做到的,接下来我就来看看它是什么,怎么用,怎么利用
什么是注解
官方把它叫做元数据,即一种描述数据的数据。所以,可以说注解就是源代码的元数据。用它来可以来描述、标记我们的源代码。
怎样定义一个注解
以下是我上文中定义的一个 @OnClick注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface OnClick {
int value() default 0;
}
可见和定义一个类一样,只是将class改为 @interface,并且顶部通过几个原注解来说明这个注解的一些重要信息,具体如下:
J2SE5.0版本在 java.lang.annotation提供了四种元注解,专门注解其他的注解:
@Documented –注解是否将包含在JavaDoc中
@Retention –什么时候使用该注解
@Target? –注解用于什么地方
@Inherited – 是否允许子类继承该注解
@Documented–一个简单的Annotations标记注解,表示是否将注解信息添加在java文档中,一般不用管。
@Retention– 定义该注解的生命周期,很重要,必须指定,以下是3种生命周期的介绍
RetentionPolicy.SOURCE – 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义,所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
RetentionPolicy.CLASS – 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。
RetentionPolicy.RUNTIME– 始终不会丢弃,运行期也保留该注解,因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。
@Target – 表示该注解用于什么地方。如果不明确指出,该注解可以放在任何地方。以下是一些可用的参数。需要说明的是:属性的注解是兼容的,如果你想给7个属性都添加注解,仅仅排除一个属性,那么你需要在定义target包含所有的属性。
ElementType.TYPE:用于描述类、接口或enum声明
ElementType.FIELD:用于描述实例变量
ElementType.METHOD
ElementType.PARAMETER
ElementType.CONSTRUCTOR
ElementType.LOCAL_VARIABLE
ElementType.ANNOTATION_TYPE 另一个注释
ElementType.PACKAGE 用于记录java文件的package信息
@Inherited – 定义该注释和子类的关系
那么注解体里的内容有该怎样定义
Annotations只支持基本类型、String及枚举类型。注释中所有的属性被定义成方法,并允许提供默认值。
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface Book{
public enum Priority {LOW, MEDIUM, HIGH}
String author() default "Yash";
int price() default 20;
Status status() default Status.NOT_STARTED;
}
看看怎么用它
@Todo(priority = Todo.Priority.MEDIUM, author = "zsq", status =
Todo.Status.STARTED)
public void incompleteMethod1() {
}
通过字段名 = 的形式给字段赋值,如果没赋值,则使用缺省值。如果注解中只有一个属性,可以直接命名为“value”,使用时无需再标明属性名,例如我定义的 @OnClick注解。
好了,花了那么多精力来认识他,该看看该怎么来利用它了
我们定义了自己的注解并将其应用在业务逻辑的方法上。现在我们需要写一个用户程序调用我们的注解。这里我们需要使用反射机制。如果你熟悉反射代码,就会知道反射可以提供类名、方法和实例变量对象。所有这些对象都有getAnnotation()这个方法用来返回注解信息。我们需要把这个对象转换为我们自定义的注释(使用 instanceOf()检查之后),同时也可以调用自定义注释里面的方法。
所有这些对象都有getAnnotation()!
所有这些对象都有getAnnotation()!
所有这些对象都有getAnnotation()!
重要的API说3遍,另外用到的几个方法也很重要,下面的代码会演示,更多的API使用参考可以去查阅JDK文档。
具体到我们本编文章的实例,调用注解的家伙就是我们刚刚在MainActivity里用到的 ButterKnife,我们通过设置监听的注解来看看它到底做了什么
public static final void bindView(final Activity activity){
traversalMethod(activity);
traversalField(activity);
}
在我们调用的ButterKnife.bindView(this)中我们拿到了MainActivity的实例,并且通过反射遍历里面所有的方法:
private static void traversalMethod(final Activity activity) {
Method[] methodArray = getObjectMethodArray(activity);
for (final Method method:methodArray){
if(isAnnotationPresent(method)){
int viewID = getViewID(method);
setOnClickListenerForControl(activity, method, viewID);
}
}
}
private static Method[] getObjectMethodArray(Activity activity) {
return activity.getClass().getMethods();
}
接着判断方法是否被我们注解:
private static boolean isAnnotationPresent(Method method) {
return method.isAnnotationPresent(OnClick.class);
}
如果是我们用注解标注的方法则通过注解获取注解里保存的空间ID,并且通过MainActivity的实例为其设置点击监听,在监听内调用被注解标注的方法。
private static int getViewID(Method method) {
return method.getAnnotation(OnClick.class).value();
}
private static void setOnClickListenerForControl(final Activity activity, final Method method, int viewID) {
activity.findViewById(viewID).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
try {
method.invoke(activity);
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
}
});
}
大功告成!是不是很简单
我们用反射获取注解的方式实现了ButterKnife的功能,但文章开头说过反射的存在性能上的不足。而实际上ButterKnife本身用的也不是反射,而是用的apt工具在编译时期就可以获取到所有的方法、字段、以及他们的注解,从而避免了使用反射,解决了性能的问题。接下来的文章我会讲解本文开头提到的第三点,也就是ButterKnife实际使用的方法,将我们自己的ButterKnife改为ButterKnife官方的实现方法。
以上所述是小编给大家介绍的Java高级特性——注解详解整合网站的支持!
来源:https://blog.51cto.com/13586365/2065324
猜你喜欢
- 前言Kotlin一个强大之处就在于它的扩展函数,巧妙的运用这些扩展函数可以让你写出的代码更加优雅,阅读起来更加流畅,下面总结了在开发中经常用
- Springboot 实体类生成数据库表JPA:springboot -jpa:数据库的一系列的定义数据持久化的标准的体系学习的目的是:利用
- 定义Builder模式是一步步创建一个复杂对象的创建型模式,它允许用户在不知道内部构建细节的情况下,可以更精细的控制对象的构建过程。该模式是
- 本文实例讲述了Hibernate实现批量添加数据的方法。分享给大家供大家参考,具体如下:1.Hibernate_016_Ba
- 构造方法以及参数:PageView可用于Widget的整屏滑动切换,如当代常用的短视频APP中的上下滑动切换的功能,也可用于横向页面的切换,
- 假定你已经了解了运行时的数据区域和常用的垃圾回收算法,也了解了Hotspot支持的垃圾回收器。一、cpu占用过高cpu占用过高要分情况讨论,
- 这一篇写一下springboot整合solr,代码已经上传到github,传送门。1、新建core并配置schemasolr create
- 背景接上文《失踪人口回归,mybatis-plus 3.3.2 发布》[1] ,提供了一个非常实用的功能 「数据安全保护」 功能,不仅支持数
- 1. 面试第一步,自我介绍。这个自我介绍,在整个面试当中可以说是第一步,如果你能把你想说的重点说出来,把面试官带到你准备好的技术点中,可以说
- 本文实例为大家分享了java多线程之铁路售票系统的具体代码,供大家参考,具体内容如下问题:铁路售票,一共100张,通过四个窗口卖完。要求:分
- 本文实例讲述了Android+SQLite数据库实现的生词记事本功能。分享给大家供大家参考,具体如下:主activity命名为Dict:代码
- 前言链表是一种数据结构,和数组同级。比如,Java中我们使用的ArrayList,其实现原理是数组。而LinkedList的实现原理就是链表
- 1. 启动入口本系列RocketMQ4.8注释github地址,希望对大家有所帮助,要是觉得可以的话麻烦给点一下Star哈前面我们已经分析完
- 定义:用于顺序访问集合对象的元素,不需要知道集合对象的底层表示。特点: 1、它支持以不同的方式遍历一个
- 面试题1:说一下你对ReentrantLock的理解?ReentrantLock是JDK1.5引入的,它拥有与synchronized相同的
- 最近一个项目中,需要用到Java的websocket新特性,于是就学了一下,感觉这技术还挺好玩的,瞬间知道网页上面的那些在线客服是怎么做的了
- 面试官:sychronized关键字有哪些特性?应聘者:可以用来修饰方法;可以用来修饰代码块;可以用来修饰静态方法;可以保证线程安全;支持锁
- 一、问题描述上周不是搭了个SpringBoot整合sharding-jdbc分库分表的架子么,组里老哥不让我把开发环境的配置文件放到reso
- Java虚拟机把描述类的数据从Class文件加载到内存,并对数据进行校验、转换解析和初始化,最终形成可以被虚拟机直接使用的Java类型,这个
- 本文实例讲述了Java实现二分查找算法。分享给大家供大家参考。具体如下:1. 前提:二分查找的前提是需要查找的数组必须是已排序的,我们这里的