2020-08-10注解

概念

• 概述：
  ①JDK1.5之后的新特性
  ②说明程序的
  ③使用注解：@注解名称
• 作用：
  ①编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【override】
  ②文档编写：通过代码里标识的注解生成文档【生成文档doc文档】命令：javadoc xxxx.java
  ③代码分析：通过代码里标识的注解对代码进行分析【使用反射】

JDK中预定义的注解

自定义注解

• 格式：
  ①元注解
  ②public @interface 注解名称{
  属性列表；
  }
• 本质:注解本质就是一个接口
  public interface 注解名称 extends java.lang.annotation.Annotation{}
• 属性：接口中的抽象方法
  ①属性的返回值类型（基本数据类型，String，枚举，注解，以上类型的数组）
  ②定义了属性，在使用注解时需要给属性赋值（如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值；如果只定义一个属性需要赋值，并且属性的名称为value，则value可以省略，直接定义值；数组赋值时，值用{}包裹，数组只有一个值，{}可以省略）
• 元注解：用于描述注解的注解
  @Target：描述注解能够作用的位置（@Target(value={ElementType.值，ElementType.METHOD}))
  @Retention：描述注解被保留的阶段（@Retention(value={RetentionPolicy.值，RetentionPolicy.值}))
  @Decument：描述是否被抽取到api文档中
  @Inherited：描述注解是否被子类继承

ElementType的取值

RetentionPolicy的取值

使用（解析）注解

1. 获取注解定义的位置的对象（反射Class，Method，Field）
2. 获取指定的注解（对象.getAnnotation(注解名.class)）
3. 调用注解中的抽象方法获取配置的属性值

• 范例

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

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Pro {
    String className();
    String method();
}


import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

@Pro(className = "cn.it.Student",method = "study")
public class Test {
    public static void main(String[] args) throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
//        1.解析注解
//        1.1获取该类的字节码文件对象
        Class<?> aClass = Class.forName("cn.it.Test");
//        2.获取注解对象
        //其实就是在内存中生成了一个该注解接口的子类实现对象
        /*
        public class ProImpl implement Pro{
            public String className（）{
                return “cn.it.Student”;
            }
            public String method(){
                return "study";
            }
        }
         */
        Pro annotation = aClass.getAnnotation(Pro.class);
//        3.调用注解对象中定义的抽象方法，获取返回值
        String className = annotation.className();
        String method = annotation.method();
//        4.加载指定的类到内存
        Class<?> aClass1 = Class.forName(className);
        Constructor<?> constructor = aClass1.getConstructor();
//        5.创建对象
        Object o = constructor.newInstance();
//        6.获得指定方法对象
        Method method1 = aClass1.getMethod(method);
//        7.执行方法
        method1.invoke(o);
    }
}