注解

注解：说明程序的，给计算机看
注释：用文字描述程序，给程序员看

·定义：注解也叫元数据，一种代码级别的说明，与类、接口、枚举是在同一层次。可以声明在包、类、方法、局部变量、方法参数等的前面、用来对这些元素进行说明，注释。

作用：

1、编写文档：通过代码里标识的注解生成文档【生成文档】
1、代码分析：通过代码里标识的注解对代码进行分析【反射】
3、编译检查：通过代码里标识的注解让编译器能实现基本的编译检查【override】

使用注解 @注解名称

JDK中预定义的一些注解

1.@Override：检测该被注解标注的方法是否是继承父类（接口）的
2.@Deprecated：将该注解标注的内容已过时
3.@SuppressWarnings：压制警告 一般传递参数all
@SuppressWarnings(“all”)

public class AnnoDemo2 {

public void show2(){
    //替代show1的方法
}
@Override
public String toString(){
    return super.toString();
}
@Deprecated
public void show1(){
    //有缺陷
}
public void demo(){
    show1();
}
}

自定义注解

格式：
元注解
public @interface 注解名称{
属性列表；
}
**本质：**注解本质上就是一个接口 默认继承Annotation接口
public interface MyAnno extends java.lang.annotation.Annotation {
}
**属性：**接口中的抽象方法

1、属性的返回值类型
基本数据类型
String
枚举
注解
2、定义了属性，在使用时需要给属性赋值
（1）如果定义属性时，使用defalut关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值
（2）如果只有一个属性需要赋值，并且属性的名称是是value。则直接定义值即可
（3）数组赋值时，值使用{ }包裹，如果数组中只有一个值，大括号可省略
元注解
用于描述注解的注解
@Target：描述注解能够作用的位置
ElementType取值：
TYPE：可以作用于类上
METHOD：可以作用于方法上
FIELD：可以作用于成员变量上

@Retention：描述注解被保留的阶段
@Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到

@Documented：描述注解是否被抽取到api文档中

@Inherited：描述注解是否被子类继承

在程序中（解析）使用注解

获取注解中定义的属性值
1.获取注解定义的位置的对象（Class （反射的入口）、Method （成员方法）、Field （成员变量））
2.获取指定的注解 getAnnotation(Class)
内存中生成了一个该注解接口的子类实现对象
3.调用注解中的抽象方法获取配置的属性值

@Pro(className = "annotation.Demo1",methodName = "show")

public class ReflectTest {
public static void main(String[] args) throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
    //解析注解
    Class<ReflectTest> reflectTestClass = ReflectTest.class;
    Pro an = reflectTestClass.getAnnotation(Pro.class);//其实就是内存中生成了一个该注解接口的子类实现对象
    //调用注解对象中定义的抽象方法，获取返回值
    String className = an.className();
    String methodName = an.methodName();
    System.out.println(className);
    System.out.println(methodName);
    //加载该类进内存中
    Class cls = Class.forName(className);
    //创建对象 构造方法
    Object o = cls.getDeclaredConstructor().newInstance();
    //获取方法对象  成员变量
    Method method = cls.getMethod(methodName);
    //执行方法
    method.invoke(o);
}
}

小结：

1. 以后大多数时候，我们会使用注解，而不是自定义注解
2. 注解给谁用？
   1. 编译器
   2. 给解析程序用
   3. 注解不是程序的一部分，可以理解为注解就是一个标签