java注解

javadoc命令是用来生成自己API文档的，使用方式：使用命令行在目标文件所在目录输入javadoc +文件名.java。

javac命令是将源代码编程成class字节码文件，用法javac+文件名.java。

javap是jdk自带的反解析工具。它的作用就是根据class字节码文件，反解析出当前类对应的code区 （字节码指令）、局部变量表、异常表和代码行偏移量映射表、常量池等信息，用法javap+文件名.class。

---

注解可以申明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

作用：

1、编写文档：通过代码里标识的注解生成文档（生成doc文档）。

2、代码分析：通过代码里标识的注解对代码进行分析（使用反射）。

3、编译检查：通过代码里标识的注解让编译器能够实现看基本的编译检查（Override）。

---

JDK中预定义的一些注解：

        @Override:检测被该注解标注的方法是否继承自父类（接口）。

        @Deprecated:该注解标注的内容，表示已过时。

        @SuppressWarnings:压制警告。一般传递参数all，@SuppressWarnings("all")。

---

自定义注解：

格式：

        元注解

        public @interface 注解名称{属性列表}

本质：注解的本质是一个接口，该接口继承Annotation接口。（public interface Test extends java.lang.annotation.Annotation）

属性：接口中的抽象方法。

        要求：

        1、属性的返回值类型有下列取值(不能为void):

                基本数据类型、String、枚举、注解、以上类型的数组。

        2、定义了属性，在使用时需要给属性赋值

                1、如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。

                2、如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。

                3、数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}省略。

元注解：用于描述注解的注解

        @Target:描述注解能够作用的位置。

                ElementType取值：        

                        TYPE:可以作用于类上

                        METHOD:可以作用于方法上

                        FIELD:可以作用于成员变量上

        @Retention：描述注解被保留的阶段（一般情RUNTIME）

                @Retention（Retention Policy.RUNTIME）:当前被描述的注解，会被保留到class字节码中，并被JVM读取到。

        @Documented：描述直接是否被抽取到api文档中

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

---

在程序中使用（解析）注解：获取注解中定义的属性值

1、获取注解定义的位置对象（Class、Method、Field）

2、获取指定的注解       

        getAnnotation(Class)（就是在内存中生成了一个该注解接口的子类实现对象）

例如：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Test {
    String name();
    String file();
}

@Test(name="djfg",file="jdfvh")
public class ma {
    public static void main(String[] args) {
        Class<ma> maClass = ma.class;
        Test annotation = maClass.getAnnotation(Test.class);
        String file = annotation.file();
        String name = annotation.name();
        System.out.println(name);
        System.out.println(file);
    }
}

    输出：