Java注解

是什么

放在代码前面，用@表示的部分，是用来描述代码的元数据。
- 什么是元数据
  - 简单来说：就是描述数据的数据，跟代码业务逻辑无关，在语法，配置层面保证代码的可用性和提供便利的配置方式。
  - 例子：

　　　　　　　　她今年三十岁上下，个子高挑，身材匀称，黑黑的眉毛，红红的脸蛋。

　　　　　　　　这句话提供了几个信息：年龄（三十岁上下）、身高（个子高挑）、相貌（身材匀称，黑黑的眉毛，红红的脸蛋）

　　　　　　　　"年龄"、"身高"、"相貌" 就是元数据。

- - 好处：使信息的描述和分类实现格式化，从而为机器处理创造了可能。

怎么用

一个使用是Java内置的注解
- 用于代码检查
  - @Override 用于子类中标记重写的父类的方法，编译器会去检查父类中是否有这个方法，没有报错。
  - @Deprecated 用于标记过期不用的方法，编译器发现代码里面有使用该过期方法时，会发出警告。
  - @SuppressWarnings 用于抑制编译时的警告。
  - @FunctionInterface 用于标注某一个接口是函数式接口。如果不是函数式接口，编译器会报错。
  - 什么是函数式接口？
    - 接口里面只有一个抽象方法。
    - 接口可以被隐式的转换为lambda表达式
- 对注解进行注解（元注解）
  - @Documented：让注解信息出现在 document 中
  - @Retention ：标记注解如何存储，支持以下三种参数
    - RetentionPolicy.SOURCE : 注解只保留在源码中，编译时会忽略
    - RetentionPolicy.CLASS : 更高一级，编译时被编译器保留，但是运行时会被 JVM 忽略
    - RetentionPolicy.RUNTIME : 最高级，运行时会被保留，可以被运行时访问
  - @Target ：标记注解作用于（修饰）什么对象，支持以下几种参数
    - ElementType.TYPE : 作用于任何类、接口、枚举
    - ElementType.FIELD : 作用于一个域或者属性
    - ElementType.METHOD : 作用于一个方法
    - ElementType.PARAMTER : 作用于参数
    - ElementType.CONSTRUCTOR : 作用于构造函数
    - ElementType.LOCAL_VARIABLE : 作用于本地变量
    - ElementType. ANNOTATION_TYPE : 作用于注解
    - ElementType.PACKAGE : 作用于包
  - @Inherited 用于标记注解能否被继承。（如果父类添加了某个注解，而这个注解用@Inherited 进行了注解，那么其子类也将默认继承该注解）

一个是自定义注解（需结合反射机制），基本步骤如下：
- 通过@Interface定义注解并添加元注解信息（选择上面的四个元注解组合）
- 将自定义注解用于代码中，并用反射机制定义注解处理类
- 在main方法中执行检查

代码实例
- 定义注解

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/*
 * @Author:darrenqiao
 * */
@Retention(RetentionPolicy.RUNTIME) //存储到运行期
@Target(ElementType.FIELD)  //作用于字段
@Documented //可以被文档化
@Inherited //可以被注解的子类继承
//这里指定自定义注解的作用是检查值是在value为true时确保字段值仅为male和female中的一个
public @interface MyAnnotation {
    boolean value() default true;
}

- 使用和处理注解

import java.lang.reflect.Field;

/*
 * @Author:darrenqiao
 * */

//定义使用自定义注解的类
class Person {
    
    @MyAnnotation(value = true)
    public String gender;

    public Person(String gender) {
        super();
        this.gender = gender;
    }
}

//通过反射实现对注解的处理
class CheckAnnotation {
    public static boolean check(Object object) throws IllegalArgumentException, IllegalAccessException {
        Field[] fields = object.getClass().getDeclaredFields();
        for(Field field : fields) {
            String gender = (String) field.get(object);
            return gender.equals("male") || gender.equals("female");
        }
        return false;
    }
}

public class AnnotationTest {
    
    public static void main(String[] args) throws Exception {
        Person p = new Person("male");
        //调用注解进行检查
        System.out.println(CheckAnnotation.check(p));
    }

}