Java学习记录（14）——Annotation

Annotation，表示代码里的特殊标记，这些标记可以在编译、类加载、运行时被读取，并执行相应的处理。通过使用注释，可以在不改变原来逻辑的情况下，在源文件中嵌入一些补充的信息。

Annotation就像修饰符一样，可用于修饰包、类、构造器、方法、成员变量、参数、局部变量的声明，这些信息被存储在Annotation的“name=value”对中。

Annotation是一个借口，程序可以通过反射来获取指定程序元素的Annotation对象，然后通过Annotation对象来取得注解里的元数据。

Annotation能被用来为程序元素（类、方法、成员变量等）设置元数据。Annotation不影响程序代码的执行，如果希望程序中的Annotation在运行时起一定作用，只有通过某种配套的工具对Annotation中的信息进行访问和处理。访问和处理的工具统称为APT(Annotation
Processing Tool)

使用Annotation时要在其前面添加@符号，并把该Annotation当成一个修饰符使用，用于修饰它支持的程序元素。

5个基本的Annotation

@Override 限定重写父类方法，强制一个子类必须覆盖父类的方法。作用是告诉编译器检查这个方法，保证父类要包含一个被该方法重写的方法，否则就会编译错误。

@Deprecated 用于表示某个程序元素已过时，当其他程序使用已过时的类、方法时，编译器将会发出警告。

@SuppressWarnings 指示该Annotation修饰的程序元素（以及该程序元素中的所有子元素）取消显示指定的编译器警告。通常，如果程序中使用没有泛型限制的集合将会引起编译器警告，为了避免这种编译器警告，可以使用
@SupperessWarnings(value="unchecked")修饰。

@SafeVarargs 把一个不带泛型的对象赋给一个带泛型的变量时，往往就会发生“堆污染”。使用这个注释修饰引发该警告的方法或构造器，可以抑制这个警告。

@FunctionalInterface 用来指定某个接口必须是函数式接口。

以上5种基本Annotation在java.lang下提供。在java.lang.annotation包下提供了6个Meta
Annotation，其中5个元注释都用于修饰其他的Annotation。

@Retention只能用于修饰Annotation定义，用于指定被修饰的Annotation可以保留多长时间。

@Target也只能修饰一个Annotation定义，用于指定被修饰的Annotation能用于修饰哪些程序单元。

@Documented用于指定该元Annotation修饰的Annotation类将被javadoc工具提取成文档。

@Inherited元Annotation指定被它修饰的Annotation将具有继承性。

定义新的Annotation类型使用@interface关键字定义一个新的Annotation类型与定义一个接口非常类似

编译时处理Annotation。APT是一种注解处理工具，它对源代码文件进行检测，并找出源文件所包含的Annotation信息，然后针对Annotation信息进行额外的处理。