Java注解Annotaton详解

时间：2022-11-18

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 {
}

2.@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

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案例