java注解学习笔记

注解
一、用框架的时候是基于注解，比如常见的@Override重写覆盖
。概念：说明程序的。给计算机看的
。注释：用文字描述程序的。拾程序员看的

*定义：注解（Annotation），也叫元数据。一种代码级别的说期。它是JDK1.5及以后版本引人的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

概念描述：
   *JDK1.5之后的新特性
   *说明程序的
   *使用注解:@注解名称

·作用分类：
   编写文档：通过代码里标识的注解生成文档【生成文档doc文档】
   代码分析：通过代码里标识的注解对代码进行分析【使用反射】
   编译检查：通过代码里标识的注解让编请器能够实现基本的编译检查【Override】

二、JDK中预定义的一些注解
 @Override：检测该注解标注的方法是否继承自父类(接口)的。
 @Deprecated：该注解标注的内容,表示已过时。
 @SuppressWarnings ：压制警告。
  一般传递参数 all @SuppressWarnings(“all”)

三、自定义注解
1格式：
   元注解
   public @interface 注解名称{}
2本质：注解本质就是一个接口，该接口默认继承Annotation接口。
3属性：接口中的抽象方法。
*要求：
01.属性的返回值类型有下列取值
   *基本数据类型
   *String
   *枚举
   *注解
   *以上类型的数组
02.定义了属性，在使用时需要给属性赋值
   1.如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。
   2.如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。
   3.数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略
4元注解：用于描述注解的注解 (加粗为常用的)
   @Target：描述注解能够作用的位置
    @Retention：描述注解被保留的阶段
   @Documented：描述注解是否被抽取到api文档中
   @Inherited：描述注解是否被子类继承

四、在程序使用(解析)注解
*在程序使用(解析)注解: 获取注解中定义的属性值
  1.获取注解定义的位置的对象 {Class,Method,Field}
 2.获取指定的注解
 3.调用注解中的抽象方法获取配置的属性值
*小结：
1.以后大多时候，我们会使用注解，而不是自定义注解。
2.注解给谁用？
  *编译器
 *给解析程序用
3.注解不是程序的一部分，可以理解为注解就是一个标签。

五、操作
 1.编写程序

/**
*注解javadoc演示
*
* @author anxincao
* @version 1.0
* @since 1.5
*/

public class AnnoDemo {

//加文档注释/**然后回车

/**
 * 计算两数的和
 *
 * @param a 整数
 * @param b 整数
 * @return 两数的和
 */
public int add(int a, int b) {
    return a + b;
 }
}

 2.在桌面新建一个文件夹，把AnnoDemo.java复制进去。去掉.java文件的包路径package…

 3. Win +R 打开命令行
cd + 文件夹名定位到.java文件。 输入javadoc命令

 4.打开index.html文件，发现文档有些字符出现乱码。

 5.改为ANSI编码本地默认编码。先把内容剪切，再重新选择编码。

 6.重新生成