java注解（Annotation）

初识注解（Annotation）

注解（Annotation）其实就是代码里的特殊标记，是 JDK1.5 引入的一种注释机制。
这些标记可以在编译、类加载、运行时被读取，并执行相应的处理，通过使用Annotation，程序可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。

使用注解

1.注解可用于类、方法、变量、参数和包等上面。
2.使用注解时要在其前面增加@符号，并把该注解当成一个修饰符使用。用于修饰它支持的程序元素。
3.三个基本的Annotation：

@Override：限定重写父类方法，该注解只能用于方法
@Deprecated: 用于表示某个程序元素（类，方法等）已过时。
@SuppressWarnings：抑制编译器警告
//重写
    @Override
    public String toString() {
        return super.toString();
    }

@Override源码

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

自定义注解

定义新的Annotation类型使用@interface关键字
1.无成员变量

/**
 * @description 自定义注解
 */
public @interface MyAnnotation {
}

2.有成员变量

/**
 * @description 自定义注解
 */
public @interface MyAnnotation {
    //注解中的成员变量，以无参方法的形式声明
    //default是指定一个默认值
    String name() default "test";
}

用法

@MyAnnotation
public class Student {
}

或

@MyAnnotation(name = "stuname")
public class Student {
}

业务处理

 //判断Student.class上是否存在@MyAnnotation注解
if (Student.class.isAnnotationPresent(MyAnnotation.class)) {
     //获取注解对象
     MyAnnotation annotation = Student.class.getAnnotation(MyAnnotation.class);
     //获取注解上成员变量配置的值，输出stuname
     System.out.println(annotation.name());
 }

注解的注解

@Retention 定义注解的生命周期，值为RetentionPolicy枚举的值
@Target 定义注解的作用域，，值为ElementType枚举的值

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
/**
 * 多个作用域时
 * @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
 */
public @interface MyAnnotation {
    //注解中的成员变量，以无参方法的形式声明
    //default是指定一个默认值
    String name() default "test";
}

RetentionPolicy枚举

public enum RetentionPolicy {
	SOURCE,//注解只在源码中，编译器处理完之后就没有该注解信息了
	CLASS,//编译器把注解记录在class文件中，当运行java程序时，JVM不会保留注解。这是默认值
	RUNTIME//编译器把注解记录在class文件中，当运行java程序时，JVM会保留注解，程序可以通过反射获取该注解
}

ElementType枚举

public enum ElementType {
    TYPE,				//类、接口（包括注释类型）或枚举声明
    FIELD,				//字段声明（包括枚举常量）
    METHOD,				//方法声明
    PARAMETER,			//参数声明
    CONSTRUCTOR,		//构造方法声明
    LOCAL_VARIABLE,		//局部变量声明
    ANNOTATION_TYPE,	//注释类型声明
    PACKAGE,			//包声明
    TYPE_PARAMETER,		//表示该注解能使用在自定义类型参数,1.8新增
    TYPE_USE 			//表示该注解能使用在使用类型的任意语句中,1.8新增
}