Java 中的注解-元注释及示例.pdf

Java 中的注释是应用程序源代码中的一种注释（或文档），用于指示 Java 编译器执行某些操作。 当 Java 编译器在特定源代码中看到注释时，它知道需要对后面的代 码执行一些特殊操作。 我们可以注释 Java 包、类、接口、构造函数、方法、字段、局部变量 和参数。 例如，我们可以注释一个要重写的方法，以告诉 Java 编译器验证我 们是否确实重写了该方法，而不是重载它。 Java 注释有助于提供一种系统方法，以 Java 编译器和 JVM 可以理 解、测试和验证的功能方式为特定代码添加额外信息。 注解是一项极其强大的新功能，首次添加到 Java 5 中。 Java 提供了一些预定义的注释，但我们也可以轻松创建自定义（用户 定义）注释，这些注释可以与我们的应用程序代码一起使用以提供一 些特殊功能。 在本教程中，我们将重点介绍 Java 语言提供的预定义注释，在下一 个教程中，我们将学习用户定义的注释。 Java 注解语法 注释的作用类似于标签，用于为 java 源代码提供元数据。元数据是 提供有关其他数据的信息的数据。 Java 中的注释始终以 @ 符号开头，并且必须直接放置在被注释的代 码之前。声明注解的一般语法如下： @AnnotationType 或者， @AnnotationType(elementValuePairs) 第一种语法用于声明标记注释类型。例如，@Deprecated 是一种标记 注释类型。 第二种语法用于声明单值或多值类型。例如： @Person(名字 = "伊万", 姓 = "萨加尔") @阶段（值= 1） @阶段 1） Java 中的标准内置注释（预定义注释） Java 5 包含三个通用的通用标准内置注释，定义在 java.lang.annotation 包中，用于向 Java 编译器发出指令。它们如 下： 1. @已弃用 2. @覆盖 3. @SuppressWarnings 后来，Java 7 和 Java 8 在 java.lang.annotation 包中添加了 SafeVarargs 和 FunctionalInterface 注释。 让我们通过例子来一一理解。 已弃用的注释 @Deprecated 注释是一种标记注释，可用于将类、方法、字段或其他 编程功能标记为已弃用，这意味着它不应再使用。 如果您的源代码在程序中使用了不推荐使用的类、方法或字段，Java 编译器将在编译时为您生成一条警告消息。 此消息通知程序员它在 JDK 的早期版本中可用，但在未来版本或当前 版本中将不再可用。因此，它今天可能有效，但不能保证它会永远有 效。 当这种情况发生时，我们需要更新他们的代码并停止使用特定的类、 方法、字段或其他编程功能。 让我们看一个简单的示例程序，我们将在其中将方法标记为已弃用。 程序代码： 公共类 DeprecatedTest { 公共无效 x （）{ System.out.println("你好 x"); } @ 已弃用 公共无效 y （） { System.out.println("你好，y"); } 公共静态无效主（字符串 [] args）{ DeprecatedTest obj = new DeprecatedTest(); obj.x(); obj.y(); } } 输出： 你好 x 你好，你 我们可以使用@Deprecated 注解在顶部标记一个类或接口。下面是一个 被标记为已弃用的类的示例。 @ 已弃用 公共类 DeprecatedClass { 无效 x() { } } @Override 注解 @Override 注解是一种标记注解，用在方法上方，向 Java 编译器指 示子类方法正在重写超类方法。 如果此注释出现在方法上方，并且该方法签名与超类中的方法签名不 匹配，则编译器将产生错误，以便我们知道重写有问题。 @Override 注释对于重写超类中的方法不是必需的。如果有人更改了 超类中被重写方法的名称，或者犯了拼写错误，那么子类方法将不再 重写它。 在这种情况下，如果没有 @Override 注解，我们将无法发现。因此， 最好使用 @Override 注解来标记方法，以向程序员保证该方法已被重 写。 使用@Override 注解，Java 编译器会告诉你子类方法不会覆盖超类方 法。 我们来看一个基于 Java