注解(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 :子类会继承父类注解