Java注解

Java注解

JDK1.5之后的新特性

1、概念

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

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

2、按作用分类

（1）编写文档：通过代码里标识的注解生成文档。如：生成doc文档。
（2）代码分析：通过代码里标识的注解对代码进行分析。如：通过反射。
（3）编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查。如：@Overrider注解

3、Java文档注释

Java支持三种注释：单行注释、多行注释、说明注释

//单行注释的内容
    
    /*
    
    多行注释的内容
    
     */
1234567
 /**
     * 计算两整数之和
     * @param a
     * @param b
     * @return
     */
    public int add(int a,int b){
   
        return a+b;
    }
123456789

说明注释允许在程序中嵌入关于程序的信息。可以使用javadoc工具软件生成信息，并输出到HTML文件中。

Javadoc演示

/**
 * 注解javadoc的演示
 * 
 * @author jack
 * @version 3.0
 * @since 1.8
 */
public class AnnotationDemo {
   
    /**
     * 计算两整数之和
     * @param a
     * @param b
     * @return
     */
    public int add(int a,int b){
   
        return a+b;
    }

    /**
     * 计算两数之差
     * @param a
     * @param b
     * @return
     */
    public int sub(int a,int b){
   
        return a-b;
    }
}
12345678910111213141516171819202122232425262728

将AnnotationDemo.java文件复制保存到新建的文件夹中，在文件夹中打开命令窗口（shift+鼠标右键，打开PowerShell窗口），输入javadoc -encoding utf-8 AnnotationDemo.java命令

如果不指定字符集格式，无法生成文档

输入正确的命令：

成功后，会在新建的文件夹下生成一些html、css文件

打开index.html

生成的html文档和JDK文档一样，这样我们知道了利用javadoc制作自己的API文档

4、自定义注解

注解以@开头
在idea中new一个自定义注解

自定义注解的依法格式：

【修饰符列表】 @interface 注解名称{…}

public @interface FirstAnnotation {
   
}
12

使用注解：@注解名称 如：@Override

@MyAnnotation
public class Person {
   
}
123

5、注解的本质

（1）注解的本质上是一个借口，该借口默认继承Annotation接口
（2）注解的属性就是接口中的抽象方法
（3）注解的属性只能是以下几种：

• 基本数据类型
  String类型
  枚举类型
  注解类型
  Class类型
  以上类型的一维数组

public @interface MyAnnotation {
   
    int age();      //int类型
    String name();