注解(Annotation)

发布于 2022-03-14  132 次阅读


注解的理解

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

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

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

基本的注解

1.@Override:限定某个方法,是重写父类方法,该注解只能用于方法

2.@Deprecated:用于表示某个程序元素(类,方法等)已过时

3.@SuppressWarnings:抑制编译器警报

Override使用说明

1.@Override表示指定重写父类的方法(从编译层面验证),如果父类fly方法,则会报错

2.如果不写@Overrode注解,而父类仍有public void fly(){},仍然构成重写

3.@Override只能注释方法,不能注释其他类,包,属性等等

4.查看@Override注解源码为@Target(ElementType.METHOD),说明只能修饰方法

5.@Target是修饰注解的注解,称为元注解

@Deprecated说明

1.用于表示某个程序元素(类,方法等)已过时

2.可以修饰方法,类,字段,包,参数等等

3.@Target(value={CONSTRUCTOR,FIELD,LOCAL_VARIABLB,METHOD,PACKAGE,PARAMETER,TYPE})

4.@Deprecated的作用可以做到新旧版本的兼容和过渡

@SuppressWarnings注解案例

说明各种植

1 unchecked是忽略没有检查的警告

2.rawtypes是忽略没有指定泛型的警告(传参时没有指定泛型的警告错误)

3.unused是忽略没有使用某个变量的警告错误

4.@SupressWarnings可以修饰的程序元素为,查看@Target

5.生成@SupperessWarnings时,不用背,直接点击左侧的黄色提示,就可以选择(注意可以指定生成位置)

JDK的元Annotation

元注解的基本介绍

JDK的元Annotation用于修饰其他Annotation

元注解的种类

1.Retention//指定注解的作用范围,三种SOURCE,CLASS,RUNTIME

2.Target//指定注解可以在哪些地方使用

3.Documented//指定注解是否在javadoc体现

4.lnherited//子类会继承父类注解

@Retntion注解

说明

只能用于修饰一个Annotation定义,用于指定该Annotation可以保存多长时间,@Rentention包含一个Retentionpolicy类型的成员变量,使用@Rentention时必须为该value成员变量指定值;

@Retention的三种值

1.RetentionPolicy.SOURCE:编译器使用后,直接丢弃这种策略的注解

2.RetentionPolicy.CLASS:编译器讲把注解记录在class文件中.当运行java程序时,jvm不会保留注解。这是默认值

3.RetentionPolicy.RUNTIME:编译器将把注解记录在class文件中,当运行java程序时,jvm会保留注解。程序可以通过反射获取该注解

@Target

基本说明

用于修饰Annotation定义,用于指定被修饰的Annotion能用于修饰哪些程序元素.@Target也包含一个名为value的成员变量

@Documented

基本介绍

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

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

@lnherited注解

基本介绍

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

说明:实际应用中,使用较少,了解即可。