Java注解Annotaton详解

2022-11-13 08:11:04 java 注解 详解

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

@Deprecated底层

@Documented//@Deprecated代码会被保存到生产的文档中
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}

Inherited

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

到此这篇关于Java注解Annotaton 的文章就介绍到这了,更多相关Java注解Annotaton 内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!

相关文章