Java注解Annotaton
1、三种基本的Annotaton
@Override : 限定某个方法,是重写父类方法 , 该注解只能用于方法
@Deprecated : 用于表示某个程序元素 ( 类 , 方法等 ) 已过时
@SuppressWarnings : 抑制编译器警告
@Override
class father{
public void fly(){}
}
class son extends father{
@Override
public void fly() {
super.fly();
}
}
解读
@Override表示son重写了fly方法
细节
- 如果没有@Override还是会重写fly方法
class father{
public void fly(){}
}
class son extends father{
public void fly() {
super.fly();
}
}
-
写了@Override注解,编译器就会去检查方法是否重写了父类方法,如果重写了,则编译通过。若没有重写,则编译错误。
-
@Override只能修饰方法,不能修饰其他类,包,属性等等
//@Override底层代码
@Target(ElementType.METHOD)//ElementType.METHOD说明@Override只能修饰方法
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}
@Deprecated
public class Deprecatedtext {
public static void main(String[] args) {
father father1 = new father();
father1.fly();
}
}
@Deprecated
class father{
@Deprecated
public void fly(){}
}
解读
@Deprecated表示某个程序元素(类,方法等)已过时,会通过单词中间的横线提醒。表示不建议使用。
效果
细节
- 可以修饰方法,类,包,参数等等
//@Deprecated底层代码
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})//说明Deprecated能修饰方法,类,包,参数等等
public @interface Deprecated {
}
- @Deprecated的作用可以起到做新旧版本的兼容过渡
@SuppressWarnings
@SuppressWarnings("all")
class father{
public void fly(){}
}
解读
@SuppressWarnings注解可以用来抑制警告信息{""}写入你希望抑制的警告信息
效果
细节
1.@SuppressWarnings作用范围和你放置的位置相关
public class Enumtext {
@SuppressWarnings("all")//作用范围在main方法
public static void main(String[] args) {
father father1 = new father();
father1.fly();
}
}
@SuppressWarnings("all")//作用范围在father类
class father{
public void fly(){}
}
-
指定警告类型有
all,抑制所有警告
boxing,抑制与封装/拆装作业相关的警告
cast,抑制与强制转型作业相关的警告
dep-ann,抑制与淘汰注释相关的警告
deprecation,抑制与淘汰的相关警告
fallthrough,抑制与switch陈述式中遗漏break相关的警告
finally,抑制与未传回finally区块相关的警告
hiding,抑制与隐藏变数的区域变数相关的警告
incomplete-switch,抑制与switch陈述式(enum case)中遗漏项目相关的警告
javadoc,抑制与javadoc相关的警告
nls,抑制与非nls字串文字相关的警告
null,抑制与空值分析相关的警告
rawtypes,抑制与使用raw类型相关的警告
resource,抑制与使用Closeable类型的资源相关的警告
restriction,抑制与使用不建议或禁止参照相关的警告
serial,抑制与可序列化的类别遗漏serialVersionUID栏位相关的警告
static-access,抑制与静态存取不正确相关的警告
static-method,抑制与可能宣告为static的方法相关的警告
super,抑制与置换方法相关但不含super呼叫的警告
synthetic-access,抑制与内部类别的存取未最佳化相关的警告
sync-override,抑制因为置换同步方法而遗漏同步化的警告
unchecked,抑制与未检查的作业相关的警告
unqualified-field-access,抑制与栏位存取不合格相关的警告
unused,抑制与未用的程式码及停用的程式码相关的警告
元注解
- Retention 指定注解的作用范围,三种SOURCE,CLASS,RUNTIME
- Target 指定注解可以在哪些地方使用
- Documented 指定该注解是否会在javadoc体现
- Inherited 子类会继承父类注解
Retention
Retention的三种值
- RetentionPolicy.SOURCE :编译器使用后,直接丢弃注释
- RetentionPolicy.CLASS: 编译器把注解记录在class文件中,当运行java时JVM不会保留注释
- RetentionPolicy.PUNTIME:编译器把注解记录在class文件中,当运行java时JVM保留注释
Retention案例
@Override底层(IDEA进入底层的快捷键为Ctrl+B)
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)//表示@Override在编译器使用后,直接丢弃注释
public @interface Override {
}
Target
Target的值
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
// 1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
Target案例
@Deprecated底层
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})//表示@Documented在这些地方可以写注解
public @interface Deprecated {
}
Documented
Documented案例
@Deprecated底层
@Documented//@Deprecated代码会被保存到生产的文档中
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
Inherited
被它修饰的Annotation将具有继承性,如果某个类使用了被@Inherited修饰的Annotation,则其子类将自动具有该注解