什么是注解

注解:Annotation,Java标注,是JDK5引入的一种机制
Java中类,方法,变量,参数,包都可以被标注
元注解:专门给注解加的注解 (如果不学习反射,注解没什么作用)

我们发现注解中可以有方法

  1. 定义方法的格式:String name();
  2. 可以有默认值,也可以没有,如果没有默认值,在使用的时候必须添加对应的值,如果需要有默认值,使用default添加
  3. 如果想在使用的时候不指定具体的名字,使用value

注解类

  1. Annotation 接口,定义一些常用的方法
  2. ElementType 枚举,它用来指定注解的类型,注解要用在哪里
  3. RetentionPolicy 枚举,它用来指定注解的策略,不同类型的策略指定的注解的作用域不同

    • SOURCE,注解仅存在于编译机处理期间,编译期处理完毕之后,这个注解就没用了
    • CLASS,注解在.class文件中依然有效
    • RUNTIME,编译期是不起作用的,只有在运行期才由JVM读取。

Java自带的注解

4个注解在java.lang.annotation
剩下的6个在java.lang

作用在代码上的注解

  1. @Override,检查该方法是否是重写方法,如果发现其父类,或者是引用的接口中没有该方法,会报错
  2. @Deprecated,标记的方法变为过时的方法
  3. @SuppressWarnings,让编辑器去忽略警告

    • all:忽略所有警告
    • boxing:忽略装箱、拆箱警告
    • rawtypes:使用生成时没有指定数据类型
    • unchecked:忽略没有进行类型检查操作的警告
    • unused:忽略没有使用的警告
  4. @SafeVarargs,JDK7开始支持,支持忽略任何使用参数为泛型变量的方法,或者构造器产生的警告
  5. @FunctionalInterface,JDK8开始支持,标识一个接口为函数式接口
  6. @Repeatable,JDK8开始支持,标识某个注解可以在同一个声明上使用多次

元注解:

  1. @Retention:标识这个注解作用域
  2. @Documented:标记这个注解是否包含在用户文档中
  3. @Target:这个注解可以修饰哪些信息
  4. @Inherited:如果一个类用上了@Inherited注解,那么其子类也会继承这个注解

测试类

public class Ch01 {

    @Deprecated
    public void info() {

    }

    @MyAnnotation(20) // age=20
    public void show() {

    }

    @Override
    public String toString() {
        return "Ch01{}";
    }
}

自定义注解类

import java.lang.annotation.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {

    String name() default "tom";
    int value();
//    int age();

}

宁静常不仅决定于声音,而包括自心的感觉。在群众之中所获得的宁静,有时甚于一人独处,因为那种宁静更具有庄严、神圣的力量。 ——刘墉
最后修改:2023 年 01 月 09 日
如果觉得我的文章对你有用,请随意赞赏