目录
  • 1、三种基本的Annotaton
    • @Override
    • 解读
    • 细节
  • @Deprecated
    • 解读
    • 效果
    • 细节可以修饰方法,类,包,参数等等
  • @SuppressWarnings
    • 解读
    • 效果
    • 细节
  • 元注解
    • Retention
      • Retention案例
    • Target
      • Target的值
      • Target案例
    • Documented
      • Documented案例
    • Inherited

    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注解,编译器就会去检查方法是否重写了父类方法,如果重写了,则编译通过。若没有重写,则编译错误。

    Java注解Annotaton详解

    @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表示某个程序元素(类,方法等)已过时,会通过单词中间的横线提醒。表示不建议使用。

    效果

    Java注解Annotaton详解

    细节可以修饰方法,类,包,参数等等

    //@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注解可以用来抑制警告信息{""}写入你希望抑制的警告信息

    效果

    Java注解Annotaton详解

    Java注解Annotaton详解

    细节

    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,抑制与未用的程式码及停用的程式码相关的警告

    Java注解Annotaton详解

    元注解

    • 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,则其子类将自动具有该注解

    声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。