1010--注解Annotation



主要内容

lJDK内置的基本注解类型（3个）

l自定义注解类型

l对注解进行注解（4个）

l利用反射获取注解信息（在反射部分涉及）

注解(Annotation)概述

l从JDK5.0开始,Java增加了对元数据(MetaData)的支持,也就是Annotation(注解)

lAnnotation其实就是代码里的特殊标记,这些标记可以在编译,类加载,运行时被读取,并执行相应的处理.通过使用Annotation,程序员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充信息.

lAnnotation可以像修饰符一样被使用,可用于修饰包,类,构造器,方法,成员变量,参数,局部变量的声明,这些信息被保存在Annotation的“name=value”对中.

lAnnotation能被用来为程序元素(类,方法,成员变量等)设置元数据

基本的Annotation

l使用Annotation时要在其前面增加@符号,并把该Annotation当成一个修饰符使用。用于修饰它支持的程序元素

l三个基本的Annotation:

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

Ø@Deprecated:用于表示某个程序元素(类,方法等)已过时

Ø@SuppressWarnings:抑制编译器警告

自定义Annotation

l定义新的Annotation类型使用@interface关键字

lAnnotation的成员变量在Annotation定义中以无参数方法的形式来声明.其方法名和返回值定义了该成员的名字和类型.

l可以在定义Annotation的成员变量时为其指定初始值,指定成员变量的初始值可使用 default关键字

Øpublic @interfaceMyAnnotation{

       Stringname()default“atguigu";

       }

l没有成员定义的Annotation称为标记;包含成员变量的Annotation称为元数据Annotation

JDK 的元Annotation

lJDK 的元 Annotation用于修饰其他Annotation定义

lJDK5.0提供了专门在注解上的注解类型，分别是：

ØRetention

ØTarget

ØDocumented

ØInherited

JDK 的元Annotation

l@Retention: 只能用于修饰一个Annotation定义, 用于指定该Annotation可以保留多长时间, @Rentention 包含一个 RetentionPolicy 类型的成员变量, 使用 @Rentention 时必须为该value成员变量指定值:

Ø

ØRetentionPolicy.SOURCE: 编译器直接丢弃这种策略的注释

ØRetentionPolicy.CLASS: 编译器将把注释记录在class文件中. 当运行 Java 程序时, JVM不会保留注解。 这是默认值

ØRetentionPolicy.RUNTIME:编译器将把注释记录在class 文件中.当运行Java 程序时,JVM 会保留注释.程序可以通过反射获取该注释



l@Target: 用于修饰 Annotation定义, 用于指定被修饰的Annotation能用于修饰哪些程序元素.@Target 也包含一个名为value的成员变量.

l@Documented: 用于指定被该元Annotation修饰的 Annotation类将被 javadoc 工具提取成文档.

Ø定义为Documented的注解必须设置Retention值为RUNTIME。

l@Inherited: 被它修饰的Annotation将具有继承性.如果某个类使用了被@Inherited修饰的 Annotation,则其子类将自动具有该注解

Ø实际应用中，使用较少