21.Java之注解Annotation（什么是注解，@Override、@Deprecated、@SuppressWarnings，元注解的基本介绍，元注解的种类）

21.1.注解的理解

1. 注解（Annotation）也被称为元数据（Metadata），用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
2. 和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息
3. 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替java EE旧版本中所遗留的繁冗代码和XML配置等

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

21.2.三个基本的Annotation：

1. @Override：限定某个方法，是重写父类方法，该注解只能用于方法
2. @Deprecated：用于表示某个程序元素（类，方法等）已过时
3. @SuppressWarnings：抑制编译器警告

21.3. @Override

@Overrride
public void fly() {
	System.out.println("重写父类方法")
}

1. 如果没写 @Override ，还是重写了父类的fly
2. 如果写了@Override注解，编译器就会去检查该方法是否真的重写了父类的方法，如果的确重写了，则编译通过，如果没有构成重写，则编译错误
3. 只能修饰方法，不能修饰其它类、包、属性等

21.4. @Deprecated

@Deprecated
class A {
	@Deprecated
	public int n1 = 10;
	@Deprecated
	public void hi(){}
}

1. 用于表示某个程序元素（类，方法等）已过时
2. 可以修饰方法、类、字段、包、参数 等等
3. @Deprecated 的作用可以做到新旧版本的兼容和过渡
4. 虽然标注为已过时，但是仍然可以使用

21.5. @SuppressWarnings

//@SuppressWarnings("all")
@SuppressWarnings({"rawtypes","unchecked","unused"})
public static void main(String[] args) {
}

1. 当不希望看到一些警告的时候，可以使用 SuppressWarnings注解来抑制警告信息
2. 在{""}中，可以写入希望抑制（不显示）警告信息

all：忽略全部
unchecked：忽略没有检查的警告
rawtypes：忽略没有指定泛型的警告（传参时没有指定泛型的警告错误）
unused：忽略没有使用某个变量的警告错误

3. 作用范围是和放置位置有关，比如放在main方法，那么抑制警告的范围就是main，通常可以放置具体的语句、方法、类。

21.6.元注解的基本介绍

JDK 的元 Annotation 用与修饰其他 Annotation，即修饰注解的注解

21.7.元注解的种类

1. Retention：指定注解的作用范围，三种 SOURCE,CLASS,RUNTIME
2. Target：指定注解可以在哪些地方使用
3. Documented：指定该注解是否会在javadoc体现
4. Inherited：子类会继承父类注解

21.8. @Retention元注解

只能用于修饰一个 Annotation 定义，用于指定该 Annotation 可以保留多长时间。@Retention包含一个RetentionPolicy类型的成员变量，使用 @Rentention 时必须为该value成员变量指定值（三种）：

1. RetentionPolicy.SOURCE：编译器使用后，直接丢弃这种策略的注释
2. RetentionPolicy.CLASS：编译器将把注解记录在class文件中（字节码文件）。当运行Java程序时，JVM不会保留注释。这是默认值
3. RetentionPolicy.RUNTIME：编译器将把注解记录在class文件中，当运行Java程序时，JVM会保留注释，程序可以通过反射获取该注解

21.9.@Target元注解

用于修饰Annotation定义用于指定被修饰的Annotation能用于修饰哪些程序元素。@Target 也包含一个名为 value 的成员变量：
TYPE：类, 接口 (包括注释类型), 或 枚举 声明
FIELD：字段声明（包括枚举常量）
METHOD ：方法声明(Method declaration)
PARAMETER：正式的参数声明
CONSTRUCTOR ：构造函数声明
LOCAL_VARIABLE：局部变量声明
ANNOTATION_TYPE：注释类型声明
PACKAGE：包声明
TYPE_PARAMETER：类型参数声明（@since 1.8）
TYPE_USE：使用的类型（@since 1.8）

21.10.@Documented元注解

用于指定该元Annotation修饰的Annotation类将被 javadoc 工具提取成文档，即在生成文档时，可以看到该注解

说明：定义为 Documented 的注解必须设置 Retention 值为 RUNTIME

21.11.@Inherited元注解

被它修饰的 Annotation 将具有继承性。如果某个类使用了被 @Inherited 修饰的 Annotation，则其子类将自动具有该注解