Java注解的定义和使用

注解也叫元数据，一种代码级别的说明。是jdk1.5后产生的一个特性，与类、接口、枚举同一个档次，他可以在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明、注释；

<!--more-->

注解分类

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

2. 编译检查：通过代码里的标识的注解让编译器能够实现基本的编译检查

3. 代码分析：通过代码里标识的注解对的代码进行分析（使用反射） 【重点】

注解可以在类、变量、方法、接口上使用

注解也有生命周期

一个方法上、一个变量上、一个类上，可以使用多个注解

JDK中内置的注解

• @Deprecated:用来修饰已经过时的方法。编译期注解，提示该方法或者该成员变量已经过期，不建议使用，但是还是能使用的，会在使用到该方法 或者该变量会有个横线，能用到（类、变量、方法）

• @Override：用来修饰此方法重写了父类的方法 只能在方法上

• @SuppressWarnings:用来通知java编译器禁止特定的编译警告

  @SuppressWarnings("unused")

   

自定义注解

通过@interface 关键字进行定义

public @interface 注解名称{
​
}

使用注解、在类上使用的列子

@注解名称
public class Test {
​
}

元注解

元注解是可以注解到注解上的注解，或者说元注解是一种基本注解，但是它能够应用到其他的注解上面。

元注解有@Retention、@Documented、@Target、@Inherited、@Repeatable这5个

两个类型一样的注解不能同时用

@Retention【重点】

Retention 意思是保留期的意思，当@Retention应用到一个注解上的时候，它解释说明了这个注解的存活时间

取值如下：

值	描述
RetentionPolicy.SOURCE	注解只在源代码阶段博保留，在编译器进行编译时将会被丢弃忽视
RetentionPolicy.CLASS	只被保留在编译进行的时候，并不会加载到JVM中
RetentionPolicy.RUNTIME	可以保留到程序运行时，它会被加载到JVM中，所以可以获取到他们

RetentionPolicy是一个枚举类

代码演示：

@Retention(RetentionPolicy.RUNTIME)//定义一个运行期有效的注解
public @interface MyAnnotation {
}

@Target【重点】

目标的意思，@Target指定注解运用的地方

• ElementType.ANNOTATION_TYPE：可以给注解进行注释

• ElementType.CONSTRUCTOR：可以给构造方法注解

• ElementType.FIELD：可以给属性进行注解

• ElementType.LOCAL_VARIABLE：可以给局部变量进行注解

• ElementType.METHOD：可以给方法进行注解不能用在构造方法上

  

  

• ElementType.PACKAGE：可以给包进行注解

• ElementType.PARAMETER：可以给一个方法内的参数进行注解

• ElementType.TYPE；可以给一个类型进行注解，比如类、接口、枚举

代码实例:

//该注解可在 类 接口、枚举、方法、成员变量使用
@Target({ElementType.TYPE,ElementType.FIELD,ElementType.METHOD})

@MyAnnotation
public class Student {
    @MyAnnotation
    int age;
    @MyAnnotation
    public void test() {
    }
}

@Inherited

表示该注解能被子类使用（继承）

注解MyAnnotation被@Inherited修饰，如果有个类A使用了@MyAnnotation注解，又有一个子类b继承了A，在b中也能使用@MyAnnotation注解

@Documented

这个注解和文档有关，它能将注解中的元素包含到Javadoc中

@Repeatable

在需要对同一个注解多次使用在一个类、接口、方法、属性等上面的时候，需要用@Repeatable

注解的属性

注解的属性也叫成员变量，注解中只有成员变量，无成员方法

注解的成员变量在注解的定义以无参数的方法的形式来声明。其方法名定义了该成员变量的名字，其返回值定义了该成员变量的类型

@Target({ElementType.TYPE,ElementType.FIELD,ElementType.METHOD})
public @interface MyAnnotation {
    //注解中只有成员变量，无成员方法
    int id() default 0;
    String username() default " ";
}

这里的default给该变量id和username设置了默认值

在Student类中用了该注解的方法可以给该注解中的变量赋值，如果注解没有设置默认值，则在引用该注解的时候必须给该注解赋值

public class Student {
    @MyAnnotation(id = 12, username ="小飞龙" )
    int age;
    @MyAnnotation
    public void test01() {
    }
    @MyAnnotation(id = 55)
    public void test02() {
    }
​
}

当注解中只有一个变量的时候（也就是只有一个无参方法的时候）可以这样写

注解中的代码：

public @interface MyAnnotation {
    //注解中只有成员变量，无成员方法
    String value() default " ";
}

Student代码：

public class Student {
    @MyAnnotation("张三")
    public void test01() {
    }
  //  @MyAnnotation(value = "李四")等价    @MyAnnotation("张三")
  @MyAnnotation(value = "李四")
    public void test02() {
    }
}

在这里@MyAnnotation(value = "李四")等价    @MyAnnotation("张三")，都是给value赋值