java中的注解

前言

注解（Annotantion）是十分重要的，可以说
框架 = 注解 + 反射 + 设计模式
通过反射获取注解的条件：要求此注解的元注解Retention中声明的生命周期状态为：RUNTIME

注解的基本分类

示例一：生成文档相关的注解
示例二：在编译时进行格式检查(JDK内置的三个基本注解)
@Override: 限定重写父类方法, 该注解只能用于方法
@Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择
@SuppressWarnings: 抑制编译器警告
示例三：跟踪代码依赖性，实现替代配置文件功能

自定义注解

如何自定义注解：参照@SuppressWarnings定义
① 注解声明为：@interface
② 内部定义成员，通常使用value表示
③ 可以指定成员的默认值，使用default定义
④ 如果自定义注解没有成员，表明是一个标识作用。
如果注解有成员，在使用注解时，如果该成员没有指明默认值，则必须指明成员值，如果该成员有默认值，则可以指明，也可以省略，省略时则为默认值。
自定义注解必须配上注解的信息处理流程(使用反射)才有意义。
这里我们自定义一个名叫MyAnnotation的注解
MyAnnotation.java

@Inherited
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR,LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
   String value() default "hello";
}

MyAnnotations.java

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface MyAnnotations {
    MyAnnotation[] value();
}

元注解

定义：对现有的注解进行解释说明的注解

jdk 提供4种元注解

1. Retention：指定所修饰的 Annotation 的生命周期：SOURCE\CLASS（默认行为）\RUNTIME。
   注意：只有声明为RUNTIME生命周期的注解，才能通过反射获取。
2. Target:用于指定被修饰的 Annotation 能用于修饰哪些程序元素(类、域、方法、参数、构造器、局部变量等等）
3. Documented:表示所修饰的注解在被javadoc解析时，保留下来。
4. Inherited:被它修饰的 Annotation 将具有继承性。
5. 通过反射获取注解信息 —到反射内容时系统讲解

可重复注解

原因：现在我们想一个地方加上两个注解

jdk8之前的做法

我们需要重新定义一个注解MyAnnotations，这个注解以MyAnnotation为成员。
@MyAnnotations({@MyAnnotation(value=“hi”),@MyAnnotation(value=“hi”)})

jdk8的做法

在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class，见上面的MyAnnotation，要求 MyAnnotation的Target和Retention等元注解与MyAnnotations相同。

@MyAnnotation(value="hi")
@MyAnnotation(value="abc")
class Person{
}

类型注解

ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

class Generic<@MyAnnotation T>{
public void show() throws @MyAnnotation RuntimeException{
	ArrayList<@MyAnnotation String> list = new ArrayList<>();
	int num = (@MyAnnotation int) 10L;
}
}

如上面的类中的MyAnnotation注释所示，它可以修饰任意的变量声明，原因在于在其代码中
@Target位置声明了TYPE_PARAMETER,所以才能使用