自定义注解

1、什么是注解

        Annontation是Java5开始引入的新特征，中文名称叫注解。

        它提供了一种安全的类似注释的机制，用来将任何的信息或元数据（metadata）与程序元素（类、方法、成员变量等）进行关联。为程序的元素（类、方法、成员变量）加上更直观、更明了的说明，这些说明信息是与程序的业务逻辑无关，并且供指定的工具或框架使用。Annontation像一种修饰符一样，应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。

2、注解的用处：

•  生成文档。这是最常见的，也是java 最早提供的注解。
• 跟踪代码依赖性，实现替代配置文件功能。
• 在编译时进行格式检查。如@override 放在方法前，如果你这个方法并不是覆盖了超类方法，则编译时就能检查出。

 3、元注解

java.lang.annotation 提供了四种元注解，专门注解其他的注解（在自定义注解的时候，需要使用到元注解）：

1.   @Documented：指定被标注的注解会包含在javadoc中。
2.   @Retention： 指定注解的生命周期（源码、class文件、运行时），其参考值见类的定义：java.lang.annotation.RetentionPolicy

          ●   RetentionPolicy.SOURCE : 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。

          ●   RetentionPolicy.CLASS : 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。

          ●   RetentionPolicy.RUNTIME : 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。

        3.  @Target：指定注解使用的目标范围（类、方法、字段等），其参考值见类的定义：java.lang.annotation.ElementType

          ● ElementType.CONSTRUCTOR ：用于描述构造器。

          ● ElementType.FIELD ：成员变量、对象、属性（包括enum实例）。

          ● ElementType.LOCAL_VARIABLE: 用于描述局部变量。

          ● ElementType.METHOD ： 用于描述方法。

          ● ElementType.PACKAGE ：用于描述包。

          ● ElementType.PARAMETER ：用于描述参数。

          ● ElementType.ANNOTATION_TYPE：用于描述参数

          ● ElementType.TYPE ：用于描述类、接口(包括注解类型) 或enum声明。

         4.  @Inherited：指定子类可以继承父类的注解，只能是类上的注解，方法和字段的注解不能继承。即如果父类上的注解是@Inherited修饰的就能被子类继承。

4、自定义注解

自定义注解类编写的一些规则:

1.    Annotation 类型定义为@interface, 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口。
2.   参数成员只能用public 或默认(default) 这两个访问权修饰。语法：类型  属性名()  [default 默认值];      default表示默认值 ，也可以不编写默认值的.
3.   参数成员只能用基本类型byte、short、char、int、long、float、double、boolean八种基本数据类型和String、Enum、Class、annotations等数据类型，以及这一些类型的数组.
4.   要获取类方法和字段的注解信息，必须通过Java的反射技术来获取 Annotation 对象，因为你除此之外没有别的获取注解对象的方法。
5.   注解也可以没有定义成员,，不过这样注解就没啥用了。

注意: 自定义注解需要使用到元注解。

• 注解方法不能有参数。
• 注解方法的返回类型局限于原始类型，字符串，枚举，注解，或以上类型构成的数组。
• 注解方法可以包含默认值。