java基础之注解

定义

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

作用

1. 生成文档：通过代码里标识的注解生成doc文档【生成doc文档】
2. 代码分析：通过代码里标识的注解对代码进行分析【反射】
3. 编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【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种元注解：

1. @Target

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

   参数ElementType取值

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

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

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

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

2. @Retention（）

   指明注解被保留的阶段:

   注解保留到源代码阶段

   @Retention(RetentionPolicy.SOURCE)   
   

   注解保留到编译阶段

   @Retention(RetentionPolicy.CLASS)
   

   注解1保留到运行阶段

   @Retention(RetentionPolicy.RUNTIME)
   

3. @Documented

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

4. @Inherited

   标识注解被子类继承

属性

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

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

   • 基本数据类型

   • String

   • 枚举

   • 注解

   • 以上类型的数组

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

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

下面是自定义的注解：

@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();
    }
}