21.1.注解的理解
- 注解(Annotation)也被称为元数据(Metadata),用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
- 和注释一样,注解不影响程序逻辑,但注解可以被编译或运行,相当于嵌入在代码中的补充信息
- 在JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在JavaEE中注解占据了更重要的角色,例如用来配置应用程序的任何切面,代替java EE旧版本中所遗留的繁冗代码和XML配置等
使用 Annotation 时要在其前面增加 @ 符号,并把该Annotation当成一个修饰符使用。用于修饰它支持的程序元素
21.2.三个基本的Annotation:
- @Override:限定某个方法,是重写父类方法,该注解只能用于方法
- @Deprecated:用于表示某个程序元素(类,方法等)已过时
- @SuppressWarnings:抑制编译器警告
21.3. @Override
@Overrride
public void fly() {
System.out.println("重写父类方法")
}
- 如果没写 @Override ,还是重写了父类的fly
- 如果写了@Override注解,编译器就会去检查该方法是否真的重写了父类的方法,如果的确重写了,则编译通过,如果没有构成重写,则编译错误
- 只能修饰方法,不能修饰其它类、包、属性等
21.4. @Deprecated
@Deprecated
class A {
@Deprecated
public int n1 = 10;
@Deprecated
public void hi(){}
}
- 用于表示某个程序元素(类,方法等)已过时
- 可以修饰方法、类、字段、包、参数 等等
- @Deprecated 的作用可以做到新旧版本的兼容和过渡
- 虽然标注为已过时,但是仍然可以使用
21.5. @SuppressWarnings
//@SuppressWarnings("all")
@SuppressWarnings({"rawtypes","unchecked","unused"})
public static void main(String[] args) {
}
- 当不希望看到一些警告的时候,可以使用 SuppressWarnings注解来抑制警告信息
- 在
{""}
中,可以写入希望抑制(不显示)警告信息
all:忽略全部
unchecked:忽略没有检查的警告
rawtypes:忽略没有指定泛型的警告(传参时没有指定泛型的警告错误)
unused:忽略没有使用某个变量的警告错误
- 作用范围是和放置位置有关,比如放在main方法,那么抑制警告的范围就是main,通常可以放置具体的语句、方法、类。
21.6.元注解的基本介绍
JDK 的元 Annotation 用与修饰其他 Annotation,即修饰注解的注解
21.7.元注解的种类
- Retention:指定注解的作用范围,三种 SOURCE,CLASS,RUNTIME
- Target:指定注解可以在哪些地方使用
- Documented:指定该注解是否会在javadoc体现
- Inherited:子类会继承父类注解
21.8. @Retention
元注解
只能用于修饰一个 Annotation 定义,用于指定该 Annotation 可以保留多长时间。@Retention包含一个RetentionPolicy类型的成员变量,使用 @Rentention 时必须为该value成员变量指定值(三种):
RetentionPolicy.SOURCE
:编译器使用后,直接丢弃这种策略的注释RetentionPolicy.CLASS
:编译器将把注解记录在class文件中(字节码文件)。当运行Java程序时,JVM不会保留注释。这是默认值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,则其子类将自动具有该注解