Java注解详细总结

1. 概述

Annotation是从JDK5.0开始引入的新技术。

1.1 Annotation 的作用：

– 不是程序本身，可以对程序作出解释。(这一点，跟注释没什么区别)
– 可以被其他程序(比如：编译器等)读取。
(注解信息处理流程，是注解和注释的重大区别
如果没有注解信息处理流程，则注解毫无意义)

1.2 Annotation 的格式：

– 注解是以“@注释名”在代码中存在的，还可以添加一些参数值，例如：
@SuppressWarnings(value=“unchecked”)。

1.3 Annotation 在哪里使用?

– 可以附加在package, class, method, field等上面，相当于给它们添加了额外的辅助信
息，我们可以通过反射机制编程实现对这些元数据的访问。

2. 内置注解

@Override

定义在 java.lang.Override 中，此注释只适用于修辞方法，表示一个方
法声明打算重写超类中的另一个方法声明。

下面打开源码看下注释：

---

@Deprecated

定义在 java.lang.Deprecated 中，此注释可用于修辞方法、属性、类
，表示不鼓励程序员使用这样的元素，通常是因为它很危险或存在更
好的选择。

比如 java.util.Date 里面已经过时的 parse 方法，看下面截图就晓得了。

下面打开源码看下注释怎么说：

---

@SuppressWarnings

– 定义在 java.lang.SuppressWarnings 中，用来抑制编译时的警告信息。

– 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参
数值都是已经定义好了的，我们选择性的使用就好了，参数如下：

示例：
– @SuppressWarnings(“unchecked”)
– @SuppressWarnings(value={“unchecked”,“deprecation”})
比如你这会儿很烦，不想看到任何警告出现，下面这样就可以满足你的要求。

3. 自定义注解

使用 @interface 自定义注解时，自动继承了 java.lang.annotation.Annotation 接口

• 要点
  – @interface 用来声明一个注解
• 格式
  – public @interface 注解名 {定义体}
  

通常自定义注解的同时，我们会加上元注解，什么是元注解呢，简单来讲，元注解就是对注解做进一步解释，后文会详细介绍。

– 其中的每一个方法实际上是声明了一个配置参数
– 方法的名称就是参数的名称
– 返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）
– 可以通过default来声明参数的默认值
示例：

– 如果只有一个参数成员，一般建议参数名命名为value

• 注意
  注解元素必须要有值。我们定义注解元素时，经常使用空字符串、0作为默认值。
  也经常使用负数(比如：-1)表示不存在的含义

4. 元注解

元注解的作用就是负责注解其他注解。 Java定义了4个标准的
meta-annotation类型，它们被用来提供对其它 annotation
类型作说明。
• 这些类型和它们所支持的类在java.lang.annotation包中可以找到
– @Target – @Retention
– @Documented
– @Inherited

---

@Target

• 作用：
  – 用于描述注解的使用范围（即:被描述的注解可以用在什么地方）
  
  
  
• 修饰范围
  如下表所示

– @Target(value=ElementType.TYPE)

示例：@Target(value=ElementType.METHOD) 代表只能在方法前面使用

如果放在其他地方，比如类前面的话，看下面就知道了。

---

@Retention

• 作用：
  – 表示需要在什么级别保存该注释信息，用于描述注解的生命周期
  
  示例：