java基础知识之注解入门

1.什么是注解

1.1概念：

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

1.2作用

①编写文档：通过代码里标识的注解生成文档
②代码分析：通过代码里标识的注解对代码进行分析
③编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查

1.3分类：

（1）JDK中预定义的一些注解
（2）自定义注解

2.注解的使用：

一、JDK预定义的一些注解：

* @Override	：检测被该注解标注的方法是否是继承自父类(接口)的

的风格和
* @Deprecated：该注解标注的内容，表示已过时，被该注解修饰的函数和方法在代码提示的时候有道删除线，表明该方法已过时，不建议使用，但仍然可以使用
eg：

	@Deprecated
    public void show(){
        //有缺陷，不能删除该方法，否则代码可能不兼容低版本
    }

见如下图：

• @SuppressWarnings：压制警告

   * 在编译运行代码时，有些方法会发出警告，使用该注解可以压制警告，该注解可以放在方法前面，也可以放在类前面
  * 需要传参数
  * 一般传递参数all @SuppressWarnings(“all”)

二、自定义注解：

• 格式：
  元注解（下文会解释什么是元注解）
  public @interface 注解名称{
  属性列表;
  }

• 本质：注解本质上就是一个接口，该接口默认继承Annotation接口
  * public interface MyAnno extends java.lang.annotation.Annotation {}
  *通过javac 命令编译该文件，获得字节码文件，然后用javap命令反编译获得该类的全部名称，如图：
  接口中的方法被称为注解的属性。

  • 属性：接口中的抽象方法
    • 要求：

      1. 属性的返回值类型有下列取值

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

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

         1. 如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。
            如图：
         2. 如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。
         3. 数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略

• 元注解：用于描述注解的注解
  * @Target：描述注解能够作用的位置
  * ElementType取值：
  * TYPE：可以作用于类上
  * METHOD：可以作用于方法上
  * FIELD：可以作用于成员变量上
  样例代码如下：

import java.lang.annotation.ElementType;
import java.lang.annotation.Target;

/**
 * * @Target：描述注解能够作用的位置
 * * @Retention：描述注解被保留的阶段
 ** @Documented：描述注解是否被抽取到api文档中
 * * @Inherited：描述注解是否被子类继承
 */


@Target(value = {ElementType.TYPE})  //表示该注解只能作用于类上
public @interface myanno02 {
}

• @Retention：描述注解被保留的阶段
  * @Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到
  * @Documented：描述注解是否被抽取到api文档中
  * @Inherited：描述注解是否被子类继承