Java注解详细总结

注解

• 1. 概述
  • 1.1 Annotation 的作用：
  • 1.2 Annotation 的格式：
  • 1.3 Annotation 在哪里使用?
• 2. 内置注解
• 3. 自定义注解
• 4. 元注解

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

在这里插入图片描述

在这里插入图片描述

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

在这里插入图片描述

示例：

在这里插入图片描述