Java注解只需看这篇就可以

什么是注解
自定义注解
如何获取注解信息

什么是注解

Java注解是在JDK5时引入的新特性，标记解释的意思。
Java常用注解有

@Override   用于标明此方法覆盖了父类的方法
@Deprecated 废弃，这个类或者方法，变量已经废弃

如废弃代码如下：

@Deprecated
public class CustomProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        return false;
    }
}

自定义注解

明白了注解是标记相关信息，那我们该如何在开发中自定义注解，实现相关简写了。大概几个步骤

用@interface标识类
用元注解标识自定义相关属性：

@Target标记运用的地方，
@Retention标记保留期
@Documented标记内容到Javadoc 中
@Inherited标记是否可以继承

用@interface标识。

@Target 指定了注解运用的地方，有以下几种取值

ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
ElementType.CONSTRUCTOR 可以给构造方法进行注解
ElementType.FIELD 可以给属性进行注解
ElementType.LOCAL_VARIABLE 可以给局部变量进行注解
ElementType.METHOD 可以给方法进行注解
ElementType.PACKAGE 可以给一个包进行注解
ElementType.PARAMETER 可以给一个方法内的参数进行注解
ElementType.TYPE 可以给一个类型进行注解，比如类、接口、枚举

@Retention标记保留期

Retention 的英文意为保留期的意思。当 @Retention 应用到一个注解上的时候，它解释说明了这个注解的的存活时间。它的取值如下：

RetentionPolicy.SOURCE
注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视。
RetentionPolicy.CLASS
注解只被保留到编译进行的时候，它并不会被加载到 JVM 中。
RetentionPolicy.RUNTIME
注解可以保留到程序运行的时候，它会被加载进入到 JVM 中，所以在程序运行时可以获取到它们

生命周期长度 SOURCE < CLASS < RUNTIME ，所以前者能作用的地方后者一定也能作用。
如果只是做一些检查性的操作，比如 @Override 和 @SuppressWarnings，则可选用 SOURCE 注解。
如果要在编译时进行一些预处理操作，比如生成一些辅助代码（如 ButterKnife），就用 CLASS注解；
一般如果需要在运行时去动态获取注解信息，那只能用 RUNTIME 注解；

用@Documented标记注解中的元素包含到 Javadoc 中去

用元注解@Inherited标记是否可以继承

Inherited 是继承的意思，但是它并不是说注解本身可以继承，而是说如果一个超类被 @Inherited 注解过的注解进行注解的话，那么如果它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解
完整的自定义注解示例：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface CustomAn {
    String value();
}

自定义注解完成。

如何处理注解

自定义好注解和内容，注解除了标识标记的意思，其实我们还可以通过注解处理器在程序编译阶段对注解的对象(类，方法)进行生成代码。那我们可以怎么处理注解呢？
分两种情况

定义为@Retention(RetentionPolicy.RUNTIME)的注解就可以运行期中通过反射获取相关信息（如果不是设置为这个，使用反射获取不到注解信息）如代码：

public class TestAnim {
    @CustomAn(value = "1234")
    public void animTest() {

    }

    public static void main(String[] args) {
        TestAnim testAnim = new TestAnim();
        try {
            //反射获取指定类的方法
            Method method = testAnim.getClass().getMethod("animTest");
            //判断方法是不是使用了TestAnim注解
            if (method.isAnnotationPresent(CustomAn.class)) {
                //获取注解类
                CustomAn customAn=method.getAnnotation(CustomAn.class);
                //打印注解值
                System.out.println(customAn.value());
            }
        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        }
    }
}

定义为@Retention(RetentionPolicy.CLASS)的注解,我们可以使用注解处理器（注解处理器，不是注解，分清概念），在项目编译的时候（.Java源码编译时期）使用注解处理器对指定注解的类，方法等进行处理生成相对应代码。需要对注解做怎么样的处理？那就需要自定义对指定注解做处理。

好了注解基础已经讲完了，如果都熟悉了可以关注Android项目实际使用APT使用