Java 注解

@Retention(SOURCE) //源码级别注解 
@Target({ANNOTATION_TYPE})
public @interface IntDef {
    int[] value() default {};

    boolean flag() default false;

    boolean open() default false;
}

实现：用反射技术和RUNTIME级别注解，实现ButterKnife功能

@Inherited

作用：如果一个类用上了@Inherited修饰的注解，那么其子类也会继承这个注解

注意是作用在类上的注解切必须是继承关系。

注意：

1. 接口用上个@Inherited修饰的注解，其实现类不会继承这个注解
2. 父类的方法用了@Inherited修饰的注解，子类也不会继承这个注解

例:

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.FIELD})
public @interface FirstAnnotation {
    String value();
    int age() default 18;

}

@FirstAnnotation("继承")
public class AnnotationTest {

    @FirstAnnotation("那路多")
    Student student;

    @FirstAnnotation(value = "萨斯给",age = 18)
    Student student1;

    public void test(@IntDefAnnotationTest(value = 1) int a){
        System.out.println(a);
    }
}

public class AnnotationTest1 extends AnnotationTest {



}

public class AnnotationMainTest {
    public static void main(String[] args) {
        System.out.println(Arrays.toString(AnnotationTest1.class.getAnnotations()));
    }
}

执行结果:

 只有作用在类上的继承过来了。

@Repeatable

@Repeatable是jdk8中新增的注解。在没有@Repeatable注解的的注解中，在同一个地方使用相同的注解会报错，有了此元注解注解的注解，就可以在同一个地方使用相同的注解。

官方解释:

The annotation type {@code java.lang.annotation.Repeatable} is used to indicate that the annotation type whose declaration it (meta-)annotates is repeatable. The value of @Repeatable indicates the containing annotation type for the repeatable annotation type.
@Repeatable 注解是用于声明其它类型注解的元注解，来表示这个声明的注解是可重复的。@Repeatable的值是另一个注解，其可以通过这个另一个注解的值来包含这个可重复的注解。

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.FIELD})
@Repeatable(SecondAnnotation.class)
public @interface FirstAnnotation {
    String value();
    int age() default 18;

}

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.FIELD})
public @interface SecondAnnotation {
    FirstAnnotation[] value();
}

其中，@FirstAnnotation 注解上的元注解@Repeatable中的值，使用了@SecondAnnotation注解，@SecondAnnotation注解中包含的值类型是一个@FirstAnnotation注解的数组！
这就解释了官方文档中@Repeatable中值的使用。

测试: 

public class AnnotationTest {


    @FirstAnnotation("1")
    @FirstAnnotation("2")
    @FirstAnnotation("3")
    int a;

}

public class AnnotationMainTest {
    public static void main(String[] args) {
       Class annotationTestClass= AnnotationTest.class;
        try {
           Field field = annotationTestClass.getDeclaredField("a");
           Annotation[] annotations = field.getAnnotations();
           System.out.println(annotations.length);
           System.out.println(Arrays.toString(annotations));
        } catch (NoSuchFieldException e) {
            e.printStackTrace();
        }
    }
}

执行：

因为int a属性上使用了3个@FirstAnnotation注解，所以猜测打印注解长度为3，然后打印详情，可是结果并不同。

1
[@com.example.fragmentadaptertest.annotation.SecondAnnotation(value=[@com.example.fragmentadaptertest.annotation.FirstAnnotation(age=18, value=1), @com.example.fragmentadaptertest.annotation.FirstAnnotation(age=18, value=2), @com.example.fragmentadaptertest.annotation.FirstAnnotation(age=18, value=3)])]

结果显示，int a属性上的注解长度为 1 , 且打印信息为@SecondAnnontation注解，它的值包含了使用的两个注解。因此可知在jdk8中，相同注解只是以集合的方式进行了保存，原理并没有变化。

注意事项

一些约束

@Repeatable 所声明的注解，其元注解@Target的使用范围要比@Repeatable的值声明的注解中的@Target的范围要大或相同，否则编译器错误，显示@Repeatable值所声明的注解的元注解@Target不是@Repeatable声明的注解的@Target的子集

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.FIELD})
@Repeatable(SecondAnnotation.class)
public @interface FirstAnnotation {
    String value();
    int age() default 18;

}

@Retention(RetentionPolicy.SOURCE)
@Target({ElementType.TYPE,ElementType.FIELD})
public @interface SecondAnnotation {
    FirstAnnotation[] value();
}

简单说就是如果想让一个自定义注解A可以在一个地方使用，就打上@Repeatable标签，标签的值是一个注解B，注解B的value的类型必须是A的数组类型。

最后使用多个A注解的实质，就是一个B注解类型包裹多个A注解类型的值。

想一想供需关系，A需要B来包裹实现注解数组，我们使用的是A在一个地方多次使用,就知道A在B必须在，A不在B可以在也可以不在。

所以B的存在级别要大于等于A。

RUNTIME > CLASS > SOURCE