Java 注解 Annotation（java 注解定义）

概述

了解 Java 注解前必须先了解元注解。

元注解：描述注解的注解。

如果明白元数据概念就比较好理解元注解

元数据：描述数据的数据。

还是比较抽象哈，下面举个例子说明下。

比如一个txt文件的元数据有 ： 文件大小、创建时间、最后修改时间等数据。

JDK提供了4种元注解

@Retention 声明注解的生命周期

@Target 修饰注解可以使用到那些目标对象上

@Document 提取javadoc 文档

@Inherited 继承性，使用它，子类也集成该类的注解

1.@Retention

@Retention Annotation声明注解的生命周期,生命周期包括3中 SOURCE、CLASS、RUNTIME

定义 Retention

Java

RetentionPolicy中定义了注解的生命周期

public enum RetentionPolicy {

SOURCE,

CLASS,

RUNTIME

}

RetentionPolicy.SOURCE：这种类型的Annotations只在源代码级别保留,编译时就会被忽略

RetentionPolicy.CLASS：这种类型的Annotations编译时被保留,在class文件中存在,但JVM将会忽略

RetentionPolicy.RUNTIME：这种类型的Annotations将被JVM保留,所以他们能在运行时被JVM或其他使用反射机制的代码所读取和使用.

2. @Target

@Target Annotation表示的是这个Annotation可以应用在哪里，是对Annotation应用的限制，如果没有这个标识的话，Annotation可以用在任何地方，比如类上，方法上，变量、属性上等

Java

ElementType 定义了该注解可以使用的位置

public enum ElementType {

TYPE,

FIELD,

METHOD,

PARAMETER,

CONSTRUCTOR,

LOCAL_VARIABLE,

ANNOTATION_TYPE,

PACKAGE,

TYPE_PARAMETER,

TYPE_USE

}

ElementType.TYPE：只能在类、接口、枚举、注解 上使用

ElementType.FIELD：只能在字段、枚举的常量上使用

ElementType.METHOD：只能在方法上使用

ElementType.PARAMETER：只能在方法参数上使用

ElementType.CONSTRUCTOR：只能在构造方法上使用

ElementType.LOCAL_VARIABLE：只能在局部变量上使用

ElementType.ANNOTATION_TYPE：只能在注解上使用

ElementType.PACKAGE：只能在包上使用

ElementType.TYPE_PARAMETER：只能在在 Type 的声明式前面

public <@TypeAnnotation T> void testTypeAnnotation(T t)

ElementType.TYPE_USE: 能标注任何类型名称

3. @Document

Documented 注解表明这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中。

4. @Inherited

说明子类可以继承父类中的该注解

JDK提供了3种注解

上面的4个是元注解哈，这里的是注解，不要弄混了

@Override :限定重写父类方法，该注释只能用于方法

@Deprecated: 用于某个程序元素(类，方法)已过时

@SuppressWarnings:抑制编译器警告

1. @Override

@Override 源码实现

Java

通过源码可以发现，使用@Target来限制该注解只能使用在方法上面使用；@Retention来限制该注解只在编译期间使用，编译完成class后就不存在了。

@Override 只是在源码语法级别验证使用。

2. @Deprecated

Java

用于标注属性、方法、类等 已经过时，不推荐使用，下一个版本可能会删除掉。

3. @SuppressWarnings

Java

代码中在开发工具中，可能会出现警告提示，使用该注解可以抑制编译器的注解。

总结

Java中的注解，看源码什么也没实现，都只是定义而已。说白了就是给类、或方法、属性等添加一个注释。

但注解可以通过 Java 的反射机制获取到。而这就是注解强大的地方。

比如 Spring 的 IOC ，在系统启动的时候会扫描指定包下所有的类，获取该类中所有标注属性上的注解，并根据注解获取需要注入的对象，并通过发射注入过去。

Java