自定义注解（Annontation）

目录

1.注解定义

2.元注解定义

3. 自定义注解（自定义的注解名称相同的会覆盖原注解）

4.Annotation架构（元注解参数介绍）

---

1.注解定义

        注解是用来将任何的信息或元数据（metadata）与程序元素（类、方法、成员变量等）进行关联。是一种说明、配置、描述性的信息，与具体业务无关，也不会影响正常的业务逻辑。注解在Java程序中是作为标记的作用，有特定的程序来发现标记

2.元注解定义

        元注解是专门用来注解其他注解的注解，听起来有些绕口，实际上就是专门为自定义注解提供的注解。java.lang.annotation提供了四种元注解：

• @Documented – 注解是否将包含在JavaDoc中
• @Retention – 什么时候使用该注解
• @Target – 注解用于什么地方
• @Inherited – 是否允许子类继承该注解
• @Repeatable - 是否可重复注解，jdk1.8引入

3. 自定义注解（自定义的注解名称相同的会覆盖原注解）

新建一个注解类 

@Documented//说明该注解能出现在 javadoc 中

@Target(ElementType.TYPE)//指定 Inherited 的类型是 ElementType.TYPE。

@Retention(RetentionPolicy.RUNTIME)//指定 Inherited 的策略是RetentionPolicy.RUNTIME

@Inherited//它所标注的Annotation将具有继承性。
public @interface MyAnnotation1 {
}

4.Annotation架构（元注解参数介绍）

 

 

        ①、(01) 1 个 Annotation 和 1 个 RetentionPolicy 关联。可以理解为：每1个Annotation对象，都会有唯一的RetentionPolicy属性。

               (02) 1 个 Annotation 和 1~n 个 ElementType 关联。可以理解为：对于每 1 个 Annotation 对象，可以有若干个 ElementType 属性。

               (03) Annotation 有许多实现类，包括：Deprecated, Documented, Inherited, Override 等等。Annotation 的每一个实现类，都 "和 1 个 RetentionPolicy 关联" 并且 " 和 1~n 个 ElementType 关联"。

        ②、Annotation 就是个接口。

"每 1 个 Annotation" 都与 "1 个 RetentionPolicy" 关联，并且与 "1～n 个 ElementType" 关联。可以通俗的理解为：每 1 个 Annotation 对象，都会有唯一的 RetentionPolicy 属性；至于 ElementType 属性，则有 1~n 个。

        ③、ElementType 是 Enum 枚举类型，它用来指定 Annotation 的类型。

"每 1 个 Annotation" 都与 "1～n 个 ElementType" 关联。当 Annotation 与某个 ElementType 关联时，就意味着：Annotation有了某种用途。

• ElementType.TYPE: 类、接口、注解、enum
• ElementType.CONSTRUCTOR: 构造函数
• ElementType.FIELD: 成员变量、对象、属性、枚举的常量
• ElementType.LOCAL_VARIABLE: 局部变量
• ElementType.METHOD: 方法
• ElementType.PACKAGE: 包
• ElementType.PARAMETER: 参数
• ElementType.ANNOTATION_TYPE): 注解
• ElementType.TYPE_PARAMETER：类型参数，表示这个注解可以用在 Type的声明式前,jdk1.8引入。
• ElementType.TYPE_USE：类型的注解，表示这个注解可以用在所有使用Type的地方（如：泛型，类型转换等），jdk1.8引入。

        ④、RetentionPolicy 是 Enum 枚举类型，它用来指定 Annotation 的策略（类型）。通俗点说，就是不同 RetentionPolicy 类型的 Annotation 的作用域不同。

                a、若 Annotation 的类型为 SOURCE，则意味着：Annotation 仅存在于编译器处理期间，编译器处理完之后，该 Annotation 就没用了。 例如，" @Override" 标志就是一个 Annotation。当它修饰一个方法的时候，就意味着该方法覆盖父类的方法；并且在编译期间会进行语法检查！编译器处理完后，"@Override" 就没有任何作用了。

                b、若 Annotation 的类型为 CLASS，则意味着：编译器将 Annotation 存储于类对应的 .class 文件中，它是 Annotation 的默认行为。
                c、若 Annotation 的类型为 RUNTIME，则意味着：编译器将 Annotation 存储于 class