转载

小话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();
        }
    }
}