注解的初步理解

注解的定义和作用

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

Java提供了一些预定义的注解
@Override：检测被该注解标注的方法是否是继承自父类(接口)的
@Deprecated：该注解标注的内容，表示已过时
@SuppressWarnings：压制警告，一般传递参数all如@SuppressWarnings(“all”)

查看class文件会发现注解的本质就是继承了注解接口

自定义注解
元注解
public @interface 注解名称{
属性列表;
}
属性的返回值类型有：基本数据类型、String、枚举、注解、Class or an invocation of Class、以上类型的数组
https://docs.oracle.com/javase/specs/jls/se8/html/jls-9.html#jls-9.6.1

元注解
@Target:描述当前注解能够作用的位置
ElementType.TYPE:可以作用在类上
ElementType.METHOD:可以作用在方法上
ElementType.FIELD:可以作用在成员变量上

@Retention: 描述注解被保留到的阶段
SOURCE:表示当前注解只在代码阶段有效
CLASS:表示该注解会被保留到字节码阶段
RUNTIME:表示该注解会被保留到运行阶段

@Documented:描述注解是否被抽取到JavaDoc的api中

@inherited:描述注解是否可以被子类继承

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;

/**
 * 本质： interface extends Annotation
 * 属性和使用： 返回值 基本数据类型、string、enum、class、anno类型及数组类型
 *           属性名是value的时候得特殊规定
 * 元注解：注解的注解
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Inherited
@Documented
public @interface MyAnno {

    int showInt() default 1;

    String[] showStrArr();

    ColorEnum showEnum();

    MyAnno2 showAnno();

}