java基础之注解示例详解

定义

注解也叫原数据，它是JDK1.5及之后版本引入的一个特性，它可以声明在类、方法、变量等前面，用来对这些元素进行说明。

作用

生成文档：通过代码里标识的注解生成doc文档【生成doc文档】

代码分析：通过代码里标识的注解对代码进行分析【反射】

编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【Override】

注解与注释的区别

注解是给编译器看的，注释是给程序员看的。

JDK内置的标准注解

@Override

表示该方法是覆盖父类的，如果某个方法父类中并没有，且该方法使用了@Override，则会报错

@Deprecated

表示该方法已经过时，但还是可以用

@SuppressWarnings

压制警告

一般用在类的前面，传递参数"all"，表示压制该类的所有警告

这是父类代码

public class Fu {
   public void eat(){
       System.out.println("Fu 吃......");
   }
}

这是子类代码

@SuppressWarnings("all")//压制该类下的所有警告
public class Zi extends Fu{

@Override//表示该方法是重写父类的
   public void eat(){
       System.out.println("Zi eat......");
   }
   @Deprecated//表示该方法已经过时
   public void work(){

}
}

下面是主类

自定义注解

格式：

元注解

public @interface 注解名称{

属性列表

}

注解本质其实上是一个接口，该接口默认继承Annotation接口

public interface 注解名称extends java.lang.annotation.Annotation {}

元注解

注解的注解就是元注解

下面是@Override注解的源码，我们可以看到在@Override的前面还有一些注解，下面我们来介绍一下这些注解

我们需要掌握5种元注解：

@Target

指明了注解可以在哪里使用

参数ElementType取值

TYPE：指明注解可以使用在类上

METHOD：指明注解可以使用在方法上

FIELD：指明注解可以使用在成员变量上

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})//当{}里面的内容只有一个时，{}可以省略
public @interface PersonWrite {
       int age();
       String name() default "22";
}

@Retention（）

指明注解被保留的阶段:

注解保留到源代码阶段

@Retention(RetentionPolicy.SOURCE)

注解保留到编译阶段

@Retention(RetentionPolicy.CLASS)

注解1保留到运行阶段

@Retention(RetentionPolicy.RUNTIME)

@Documented

标识注解被抽取到doc文档中

@Inherited

标识注解被子类继承

属性

注解中的属性其实是抽象方法

属性的返回类型只能是下面几种类型：

基本数据类型

String

枚举

注解

以上类型的数组

如果注解里面定义了属性（接口），在使用时要给属性赋值

如果定义属性时使用default给属性赋值，则在使用注解时可以不给该属性赋值（当然也可以重新赋值）如果注解只有一个，且注解的名称是value，则使用时传参直接写参数即可，不用写属性名数组赋值时，使用{}包裹，如果数组中只有一个值，则{}可以省略

下面是自定义的注解：

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface PersonWrite {
       int age();
       String name() default "李四";
}

下面是该注解的使用：

package Java高级特性.注解;

@PersonWrite(age = 222)
public class Main {

public static void main(String[] args) {
       Zi zi = new Zi();
       zi.work();
   }
}

来源：https://blog.csdn.net/qq_50313418/article/details/122148763