小话java注解机制

写作原因:Java反射注解这一块一直是笔者的盲区,但是Java系开发者都知道这一块的重要性。以熟悉的Android开发为例,通过利用反射注解大神们创造了可以减少大量重复赘余代码和清晰逻辑结构的依赖注入框架。本文也是为日后的依赖注入剖析做预备。由于水平限制,一些地方可能存在疏漏,望指出。


定义

本章继续探讨反射注解的相关知识。这里分享了关于反射的一些内容,相比反射注解内容少许多。直接开始正文吧。什么是注解?注解就是描述代码的东东,比如我们常见的@Override,它就是描述一个方法说明该方法是重写父类的方法。再比如@Deprecated就是说明一个方法过时了(那些调用时打横线的方法就是过时的方法,就是该注解的功劳);还有@SuppressWarnings("XXX")就是用来忽略各种警告的。好了,我顺便把官方的注解也在讲定义的时候说明了。下面看看自定义注解和第三方注解(实际上就是自定义注解)。

自定义注解

自定义注解格式如下:

@Target(ElementType.METHOD)
//作用域,包括方法、成员、构造函数等几乎所有地方
@Retention(RetentionPolicy.RUNTIME)
//生命周期,注明注解起效果的时间,SOURCE(源码阶段),CLASS(编译阶段),RUNTIME(运行阶段)
@Inherited
@Documented
public @interface Description {
    String value();
}

上面四个称为元注解(注解的注解),功能见注释,主要说明一下@Inherited,如果在一个父类中某个地方使用该注解,那么继承该父类的子类中该注解也会起效果。@Documented用于在javadoc中为注解输出信息。注解中只有一个成员时最好用value作为成员名,多个时随意,如:

public @interface Description{
    String desc();//成员以无参无异常的方式声明
    String author();
    int age() default 18;
}

注意成员类型包括基本类型,String,Class,Annotation,Enumeration。也可以没有成员,那叫标示注解。
使用自定义注解时在作用域上方写,格式如下:
@Description(desc="am",author="Mooc",age=18)

解析

个人感觉解析注解是注解最有趣的地方,利用好这个东西可以实现许多代码的优化,具体实现是通过反射进行的,如果对于反射不清楚的可以参考上一篇文章。下面我们写一个注解解释器解释方法上面的注解,代码见下:

public class DescriptionWorker {
    public static void work(){
        try {
            Class c = Class.forName("com.vince.reflect.ClassInfo");
            Method[] ms = c.getMethods();
            for(Method m:ms){
                boolean isExist = m.isAnnotationPresent(Description.class);
                if(isExist){
                    Description d = (Description) m.getAnnotation(Description.class);
                    System.out.println(d.value());
                }
            }
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
    }
}

先获取方法然后判断类内部是否有注解,如果有将方法上的注解取出将值打印出来,这就是方法解释器的运行原理。基本都是反射的原理,主要要注意isAnnotationPresent(Description.class);m.getAnnotation(Description.class)

总结

关于对注解价值的认识得结合一些实际代码来分析,之后博主将会结合实战剖析重新认识注解。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 174,073评论 25 709
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,131评论 19 139
  • 上海的雨,下的有段时间了,别指望它停了会有好心情,内心的平静再无波涛。 走在菜市场,东挑西捡,从来不在乎价格。提一...
    度然阅读 703评论 0 0
  • 相当于1-3年UI设计师的功力,大概月底推出(2017年6月) http://v.qq.com/iframe/pl...
    徐永涵阅读 347评论 0 0
  • 昨天在看一本心理方面的书时,书里面的内容突然让我想起去年发生的一件事情,有一天我和朋友下班之后逛街,顺便吃了点东西...
    大鱼学养身阅读 370评论 0 0