java 注解

注解（Annotation）也被称为元数据（Metadata），用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息。

和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息。

在 JavaSE 中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在 JavaEE 中，注解占据了更重要的角色，例如用来配置应用程序的任何切面、代替 javaEE 旧版中所遗留的繁冗代码和 XML 配置等

基本的 Annotation 介绍

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

三个基本的 Annotation：

• @Override ：限定某个方法是重写父类的方法，该注解只能用于方法

// @Override 源码

// @Target 是修饰注解的注解，称为元注解

// @Target(ElementType.METHOD) 用来表示注解可以放在哪些元素上 

@Target(ElementType.METHOD) // 说明只能用于方法上

@Retention(RetentionPolicy.SOURCE)

public @interface Override {} // @interface 表示 Override 是一个注解类

• @Deprecated ：用于表示某个程序元素（类、方法等）已过时，但是还能用。该注解可以修饰方法、类、字段、包、参数等等。该注解的作用可以做到新旧版本的兼容和过渡

// @Deprecated 源码

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target(value = {CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})  // TYPE 表示可以放在类上

public @interface Deprecated {}

• @SuppressWarnings ：抑制编译器警告，可以在括号里写上想要抑制的警告类型：@SuppressWarnings （{“类型1”，“类型2”，“类型3”}）。该注解的作用范围和所放置的位置有关，如放在方法上，则作用范围在该方法体内

// @SuppressWarnings 源码

@Retention(RetentionPolicy.SOURCE)

@Target({CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD,, PARAMETER, TYPE})

public @interface SuppressWarnings {

        String[] value();

}

JDK 的元注解

jdk 的元注解用于修饰其他注解。

元注解的种类

• Retention ：指定注解的作用范围，有三种（SOURCE、CLASS、RUNTIME）
• Target ：指定注解可以在哪些地方使用
• Documented ：指定注解是否会在 javadoc 体现
• Inherited ：子类会继承父类注解