注解的使用

理解Annotation

①jdk5.0新增的功能
②Annotation其实就是代码里的特殊标记,这些标记可以在编译、类加载、运行时被读取,并执行相应的处理。通过使用Annotation,我们可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充信息。
③在JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在JavaEE/Android中注解占据了更重要的角色,例如用来配置应用程序的任何切面,代替JavaEE旧版中所遗留的繁琐代码和XML配置等

Annotation的使用示例

示例一:生成文档相关注解
屏幕截图 2022-03-28 140042.jpg
示例二:在编译时进行格式检查(JDK内置的三个基本注解)
屏幕截图 2022-03-28 140207.jpg
示例三:跟踪代码依赖性,实现替代配置文件功能
屏幕截图 2022-03-28 140427.jpg
补充:
屏幕截图 2022-03-28 140458.jpg

自定义注解

①注解声明为:@interface
②内部定义成员,通常使用value表示
③可以指定成员的默认值,使用default定义
④如果自定义注解没有成员,表明是一个标识作用
⑤如果注解有成员,在使用注解时,需要指明成员的值

  1. public @interface MyAnnotation {
  2. String value() default "hello";
  3. }

元注解

对现有的注解进行解释说明的注解

Retention

指明所修饰的Annotation的生命周期:SOURCE\CLASS(默认行为)\RUNTIME,只有声明为RUNTIME生命周期的注解,才能通过反射获取

Target

用于指定被修饰的Annotation能用于修饰那些程序元素

Documented

表示所修饰的注解在被javadoc解析时,保留下来

Inherited

被它修饰的Annotation将具有继承性
说明:自定义注解时通常声明Retention和Target

  1. import java.lang.annotation.*;
  2. @Inherited
  3. @Retention(RetentionPolicy.RUNTIME)
  4. @Target({ElementType.TYPE,ElementType.FIELD,ElementType.METHOD,ElementType.PARAMETER,ElementType.CONSTRUCTOR, ElementType.LOCAL_VARIABLE})
  5. public @interface MyAnnotation {
  6. String value() default "hello";
  7. }

通过反射获取注解信息 —- 到反射内容时系统讲解

jdk8新特性

可重复注解

①在MyAnnotation上声明@Repeatable,成员值为My Annotations.class
②MyAnnotation的Target和Retention和MyAnnotation相同
③Inherited也必须相同

类型注解

ElementType.TYPE_PARAMETER :表示该注解能写在类型变量的声明语句中
ElementType.TYPE_USE :表示该注解能写在使用类型的任何语句中