Java注解

Java注解（Annotation）

一.注解概述

1. 在javase中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等，在javaee/android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替javaee旧版中所遗留的繁冗代码和XML配置等
2. 未来的开发模式是基于注解的，一定程度上可以说，框架=注解+反射+设计模式
3. 注解是jdk5.0新增的功能

二.常见的annotation示例

1. 示例一：生成文档相关的注解

@author:标明开发该模块的作者，多个作者之间用,分割
@version：标明该类模块的版本
@date：标明日期
等等

2. 示例二：在编译时进行格式检查（JDK内置的三个基本注解）

@Override:限定重写父类方法，该注解只用用于方法
@Deprecated:用于表示所修饰的元素已过时
@SuppressWarnings:抑制编译器警告

3. 示例三：跟踪代码依赖性，实现替代配置文件功能

三.自定义Annotation

1. 参照@SuppressWarning定义

   • 注解声明为：@interface
   • 内部定义成员，通常使用value表示
   • 可以指定成员的默认值，使用default定义
   • 如果定义注解没有成员，表明是一个标识作用

   package Annocation;
   
   public @interface MyAnnotation {
       String value();
   }
   
   
   

   • 如果注解有成员，在使用注解时，需要指明成员的值

四.JDK中的元注解

1. 提供了四个标准的meta-annotation类型，分别是
   • Retention
   • Target
   • Documented
   • Inherited
2. 元注解：修饰其他注解的注解（元数据：对现有数据修饰的数据）
3. 自定义注解通常会指明两个元注解：Retention、Target
4. @Retention:只能用来修饰一个Annotation定义，用于指定该Annotation的生命周期
5. @Target：用于修饰Annotation定义，用于指定被修饰的Annotation能用于修饰哪些程序元素
6. @Document：用于指定被该元Annotation修饰的Annotation类将被javadoc工具提取成文档，默认情况下，javadoc是不包括注解的
7. @Inherited：被它修饰的Annotation将具有继承性

五.Jdk8中注解的新特性

1. 可重复注解

   //1.jdk8之前
   @MyAnnotation({@MyAnnotation(value="hi"),@MyAnnotation(value="hello")})
   //jdk8
   在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class
   

   ​

2. 类型注解

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