深入理解Java注解的实现原理以及前世今生

深入理解Java注解的实现原理以及前世今生

在这里插入图片描述
小雪初寒，请添衣，冬棋如意，待良人，望归期。

1.Java注解的前世今生

Java注解是一种元数据标记，它提供了一种在Java代码中添加元数据（注释）的方式。注解是在Java源代码中的类、方法、字段或其他程序元素前添加的特殊标记。这些注解可以用来提供额外的信息，用于编译时检查、运行时处理或者在工具处理过程中。Java注解通常以@符号开头，比如@Override、@Deprecated等。

Java注解的前世：

在Java 5中引入了注解，它是为了提供更丰富的元数据支持，以替代一些传统的XML配置文件。在早期，开发人员可能会使用XML文件来配置应用程序，指定一些元数据信息。然而，XML配置文件容易出错，而且阅读起来相对繁琐。通过引入注解，开发人员可以将元数据直接嵌入到源代码中，提高了代码的可读性和维护性。

Java注解的今生：

Java注解在今天的Java编程中扮演着重要的角色，它们被广泛用于各种用途，包括但不限于：

  1. 编译时检查： 通过使用注解，开发人员可以在编译时捕获一些潜在的错误。例如，@Override注解可以确保被注解的方法确实是在父类中有对应的方法，从而提供了一层额外的静态检查。

  2. 运行时处理： 注解还可以在运行时通过反射进行处理。这使得开发人员可以根据注解的信息执行一些特定的逻辑。例如，使用自定义注解标记特定的类或方法，然后在运行时执行一些额外的逻辑。

  3. 文档生成： 注解可以用于生成文档，使得文档的维护更容易。一些框架和工具可以根据注解生成文档，减少了手动编写文档的工作量。

  4. 测试框架： 注解在测试框架中也得到了广泛应用，例如JUnit。通过在测试方法上添加注解，可以指定测试的顺序、依赖关系等信息。

  5. 持久化： 持久化框架，如Hibernate，使用注解来映射Java对象与数据库表之间的关系。

总体而言，Java注解为开发人员提供了一种轻量级、灵活且强大的方式来处理元数据，使得代码更具可读性、可维护性，并且为框架和工具提供了更多的信息。

2.Java注解的类型

当谈论Java注解时，我们可以将其分为两个主要概念：系统注解和自定义注解。

1. 系统注解（内置注解）：

@Override：

  • 概念： 用于标识一个子类方法覆盖了父类中的方法。编译器会检查该注解，如果发现标记了@Override的方法并没有覆盖父类的方法，就会给出编译错误。
  • 应用场景： 提高代码的可读性和可维护性，防止因为方法名拼写错误等问题导致的错误。

@Deprecated：

  • 概念： 表示被注解的元素已过时，不推荐使用。编译器会在使用过时元素时发出警告。
  • 应用场景： 提示开发者某个方法或类不再建议使用，鼓励使用新的替代方案。

@SuppressWarnings：

  • 概念： 告诉编译器去忽略特定的警告信息。可以用于抑制不同类型的警告。
  • 应用场景： 在某些情况下，开发者可能知道一些代码是安全的，可以通过使用该注解来消除相关的警告。

@SafeVarargs：

  • 概念： 用于抑制关于使用泛型可变参数方法时的警告。在泛型方法中使用可变参数时可能会导致编译器警告，使用该注解可以抑制这些警告。
  • 应用场景： 通常用于泛型方法，确保在使用可变参数时不会出现不安全的操作。

@FunctionalInterface：

  • 概念： 用于指定接口类型是一个函数式接口，即只包含一个抽象方法的接口。这个注解可以让编译器进行额外的检查，确保接口符合函数式接口的定义。
  • 应用场景： 主要与Java 8引入的Lambda表达式和函数式接口相关，确保接口的简单定义。

2. 自定义注解：

定义方式：

  • 概念： 使用 @interface 关键字进行定义，可以在注解中定义元素，这些元素可以包含默认值。
  • 应用场景： 用于开发者自定义元数据，以在编译时、运行时或者通过工具进行处理。

元注解：

  • 概念： 用于注解其他注解，包括 @Target、@Retention、@Documented、@Inherited 等。
  • 应用场景： 通过元注解，开发者可以限制注解的使用范围、指定注解的生命周期、控制是否将注解包含在JavaDoc文档中以及是否允许子类继承父类的注解。

运行时处理：

  • 概念： 自定义注解可以在运行时通过反射进行处理，使得开发者可以根据注解的信息执行一些特定的逻辑。
  • 应用场景： 在框架和工具中，运行时处理可以用于动态配置、代码生成等方面。

应用领域：

  • 概念： 自定义注解广泛应用于各种应用领域，包括依赖注入、持久化框架、测试框架等。
  • 应用场景： 通过自定义注解，开发者可以在代码中添加额外的信息，以供框架或工具使用。

总体而言，Java注解是一种强大的元数据机制，通过系统注解和自定义注解，开发者可以实现更灵活的编程和更好的代码管理。系统注解提供了一些通用的元数据标记，而自定义注解则允许开发者根据应用程序需求创建自己的元数据标记。

3.系统注解

当涉及到Java系统注解时，我们可以详细解析每一个系统注解的作用、用法和适用场景。

1. @Override 注解：

  • 作用： 用于标识一个方法是重写父类中的方法。

  • 用法： 放在方法的声明前面，表明该方法是重写父类中的方法。

class Parent {public void method() {// 父类方法的实现}
}class Child extends Parent {@Overridepublic void method() {// 子类重写父类的方法}
}
  • 适用场景：
    • 提高代码的可读性，让开发者清楚地知道这个方法是故意覆盖的。
    • 在编译时检测是否正确地覆盖了父类的方法。

2. @Deprecated 注解：

  • 作用： 表示被注解的元素（类、方法等）已过时，不推荐使用。

  • 用法： 放在类、方法或字段的声明前面，用于标记即将被废弃的元素。

@Deprecated
class DeprecatedClass {// 类的实现
}class MyClass {@Deprecatedpublic void deprecatedMethod() {// 方法的实现}
}
  • 适用场景：
    • 提示开发者某个方法、类或字段即将被废弃，鼓励使用新的替代方案。
    • 用于保持向后兼容性，但是表明不鼓励使用。

3. @SuppressWarnings 注解：

  • 作用： 用于告诉编译器去忽略特定的警告信息。

  • 用法： 可以用在类、方法、字段等地方，指定要抑制的警告类型。

@SuppressWarnings("unchecked")
public class SuppressWarningsExample {// 类的实现
}public class AnotherClass {@SuppressWarnings("unused")private int unusedField;
}
  • 适用场景：
    • 有些情况下，开发者可能清楚地知道某些代码是安全的，可以通过这个注解来消除相关的警告。
    • 提高代码的可读性，指明为何要忽略某些警告。

4. @SafeVarargs 注解：

  • 作用： 用于抑制关于使用泛型可变参数方法时的警告。

  • 用法： 放在方法的声明前面，用于标记这个方法使用了安全的可变参数。

public class SafeVarargsExample {@SafeVarargspublic final <T> void process(T... elements) {// 方法实现}
}
  • 适用场景：
    • 在使用泛型可变参数时，编译器可能会发出警告，这时可以使用该注解来抑制这些警告。
    • 通常在确保方法中不会对可变参数数组进行修改的情况下使用。

5. @FunctionalInterface 注解：

  • 作用： 用于指定接口类型是一个函数式接口，即只包含一个抽象方法的接口。

  • 用法： 放在接口的声明前面，用于标记这个接口是函数式接口。

@FunctionalInterface
public interface MyFunctionalInterface {void myMethod();
}
  • 适用场景：
    • 主要与Java 8引入的Lambda表达式和函数式接口相关。
    • 确保接口的简单定义，只包含一个抽象方法。

这些系统注解为开发者提供了一些标准的元数据标记，用于提高代码的可读性、可维护性，并在编译时提供一些额外的检查。每个注解都有其特定的用途，使得代码更加清晰和健壮。

4.自定义注解

自定义注解是Java中一种强大的机制，它允许开发者在程序中嵌入元数据。下面我们将详细介绍如何编写和使用自定义注解，同时创建两个例子来说明如何实现判断字段是否为空和是否存在值的功能。

编写自定义注解：

自定义注解使用 @interface 关键字，定义时可以在注解中声明一些元素，这些元素可以有默认值。

判断字段是否为空的注解 @NotEmpty：
import java.lang.annotation.*;@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface NotEmpty {String message() default "Field cannot be empty";
}
  • @Retention(RetentionPolicy.RUNTIME): 指定注解的生命周期，在运行时可通过反射获取。
  • @Target(ElementType.FIELD): 指定注解可以应用在字段上。
判断字段是否存在值的注解 @NotNullOrZero：
import java.lang.annotation.*;@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface NotNullOrZero {String message() default "Field must not be null or zero";
}
1. 判断字段是否为空的例子：
public class User {@NotEmptyprivate String username;@NotEmptyprivate String password;public User(String username, String password) {this.username = username;this.password = password;}
}
2. 判断字段是否存在值的例子：
public class Product {@NotNullOrZeroprivate int productId;@NotEmptyprivate String productName;public Product(int productId, String productName) {this.productId = productId;this.productName = productName;}
}

实现逻辑：

判断字段是否为空的逻辑：
import java.lang.reflect.Field;public class Validator {public static boolean validateNotEmpty(Object obj) throws IllegalAccessException {for (Field field : obj.getClass().getDeclaredFields()) {if (field.isAnnotationPresent(NotEmpty.class)) {field.setAccessible(true);Object value = field.get(obj);if (value == null || value.toString().isEmpty()) {return false;}}}return true;}
}
判断字段是否存在值的逻辑：
import java.lang.reflect.Field;public class Validator {public static boolean validateNotNullOrZero(Object obj) throws IllegalAccessException {for (Field field : obj.getClass().getDeclaredFields()) {if (field.isAnnotationPresent(NotNullOrZero.class)) {field.setAccessible(true);Object value = field.get(obj);if (value == null || (value instanceof Number && ((Number) value).intValue() == 0)) {return false;}}}return true;}
}

测试：

public class Main {public static void main(String[] args) throws IllegalAccessException {User user = new User("john.doe", "password123");Product product = new Product(0, "Laptop");if (Validator.validateNotEmpty(user)) {System.out.println("User object is not empty.");} else {System.out.println("User object is empty.");}if (Validator.validateNotNullOrZero(product)) {System.out.println("Product object is not null or zero.");} else {System.out.println("Product object is null or zero.");}}
}

这个例子中，Validator 类提供了两个静态方法，分别用于验证对象中带有 @NotEmpty 和 @NotNullOrZero 注解的字段。在 Main 类中，我们创建了一个 User 对象和一个 Product 对象，然后使用 Validator 类来验证它们。这样就能够根据自定义注解来实现特定的逻辑。

5.总结概述

Java注解是一种强大的元数据标记机制，通过系统注解和自定义注解，它为Java编程提供了更灵活、清晰和可维护的方式。以下是对Java注解实现原理及应用的反思总结：

1. Java注解的演进：

Java注解的引入是为了提供更丰富的元数据支持，取代传统的XML配置方式。通过将元数据直接嵌入到源代码中，注解提高了代码的可读性和维护性。从最初的系统注解到开发者自定义注解，Java注解的应用范围逐渐扩大，成为现代Java编程不可或缺的一部分。

2. 系统注解的作用：

系统注解（内置注解）如@Override、@Deprecated、@SuppressWarnings等，为开发者提供了一些标准的元数据标记。这些注解通过在编译时进行额外的检查，提高了代码的健壮性，同时在运行时通过反射处理，实现了一些特定的逻辑。它们是Java语言的基础，用于编写清晰、规范的代码。

3. 自定义注解的威力：

自定义注解使得开发者可以根据应用需求创建自己的元数据标记，为代码添加额外信息。通过元注解的灵活运用，可以限制注解的使用范围、指定生命周期等。在实际应用中，自定义注解被广泛用于依赖注入、持久化框架、测试框架等领域，为代码提供更多的元数据支持。

4. 运行时处理的价值：

Java注解的运行时处理通过反射机制，使得可以在程序运行时动态处理注解信息。这一特性为框架和工具提供了广泛的应用场景，包括动态配置、代码生成、文档生成等。运行时处理为开发者提供了更多的扩展性和灵活性，使得注解不仅仅是静态元数据的标记。

5. 应用案例的思考：

通过实际的自定义注解案例，如判断字段是否为空和是否存在值的功能，展示了注解在实际开发中的强大应用。自定义注解可以帮助开发者提高代码的可读性，减少重复性的代码检查，同时为特定场景提供了一种优雅的解决方案。

6. 注解的适用场景：

  • 编译时检查： 系统注解如@Override通过编译器进行静态检查，提前捕获潜在的错误。
  • 运行时处理： 自定义注解通过反射在运行时处理，实现特定逻辑，为框架和工具提供更多信息。
  • 文档生成： 注解可以用于生成文档，减少手动编写文档的工作量。
  • 测试框架： 注解在测试框架中的广泛应用，例如JUnit，可以指定测试的顺序、依赖关系等信息。

7. 持久化框架的注解应用：

持久化框架如Hibernate使用注解来映射Java对象与数据库表之间的关系，简化了配置过程，提高了开发效率。这种应用场景充分体现了注解在领域驱动设计中的价值。

在总体上，Java注解作为一种元数据标记机制，通过其简洁、直观的语法，为Java编程带来了更大的便利。在今后的开发中，注解将继续发挥重要作用，成为代码质量、可读性和可维护性的有力保障。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/160531.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Linux文件

Linux文件

目录 一、基本概念 二、研究进程和被打开文件的关系 &#xff08;一&#xff09;w方式 &#xff08;二&#xff09;a方式 三、认识系统接口&#xff0c;操作文件 &#xff08;一&#xff09;认识文件描述符 &#xff08;二&#xff09;举例 &#xff08;三&#xff09;…
阅读更多...
2023年中国油墨树脂主要环节、产量及市场规模分析[图]

2023年中国油墨树脂主要环节、产量及市场规模分析[图]

油墨树脂是指用于油墨制造中的一种高分子材料&#xff0c;主要用于改善油墨的粘性、流动性、光泽度和耐磨性等性能。其主要成分为合成树脂&#xff0c;如聚酯、聚酰胺、聚丙烯酸酯等。油墨树脂在油墨制造中的应用非常广泛&#xff0c;可以用于各种类型的油墨&#xff0c;包括印…
阅读更多...
git中的分支管理：git branch,git checkout，解决git中的分支冲突的方法【Git学习三】

git中的分支管理：git branch,git checkout，解决git中的分支冲突的方法【Git学习三】

&#x1f601; 作者简介&#xff1a;一名大四的学生&#xff0c;致力学习前端开发技术 ⭐️个人主页&#xff1a;夜宵饽饽的主页 ❔ 系列专栏&#xff1a;Git等软件工具技术的使用 &#x1f450;学习格言&#xff1a;成功不是终点&#xff0c;失败也并非末日&#xff0c;最重要…
阅读更多...
双流网络论文精读笔记

双流网络论文精读笔记

精读视频&#xff1a;双流网络论文逐段精读【论文精读】_哔哩哔哩_bilibili Two-Stream Convolutional Networks for Action Recognition in Videos 传统的神经网络难以学习到物体的运动信息&#xff0c;双流网络则通过光流将物体运动信息抽取出来再传递给神经网络 给模型提供…
阅读更多...
Golang 中的良好代码与糟糕代码

Golang 中的良好代码与糟糕代码

最近&#xff0c;有人要求我详细解释在 Golang 中什么是好的代码和坏的代码。我觉得这个练习非常有趣。实际上&#xff0c;足够有趣以至于我写了一篇关于这个话题的文章。为了说明我的回答&#xff0c;我选择了我在空中交通管理&#xff08;ATM&#xff09;领域遇到的一个具体用…
阅读更多...
linux部署jar 常见问题

linux部署jar 常见问题

1.java -jar xxx.jar no main manifest attribute, in xxx.jar 一.no main manifest attribute, in xxx.jar 在pom.xml文件中加入&#xff1a; <plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifac…
阅读更多...
C语言每日一题（35）有效的括号

C语言每日一题（35）有效的括号

力扣网 20 有效的括号 题目描述 给定一个只包括 (&#xff0c;)&#xff0c;{&#xff0c;}&#xff0c;[&#xff0c;] 的字符串 s &#xff0c;判断字符串是否有效。 有效字符串需满足&#xff1a; 左括号必须用相同类型的右括号闭合。左括号必须以正确的顺序闭合。每个右…
阅读更多...
CountDownLatch和CyclicBarrier

CountDownLatch和CyclicBarrier

JUC&#xff08;Java.util.concurrent&#xff09;是Java 5中引入的一个并发编程库&#xff0c;它包含了许多用于多线程处理的工具类和接口。JUC主要提供了以下特性&#xff1a; 线程池&#xff1a;线程池可以提高线程的使用效率&#xff0c;避免频繁地创建和销毁线程&#xff…
阅读更多...
Kotlin学习——hello kotlin 函数function 变量 类 + 泛型 + 继承

Kotlin学习——hello kotlin 函数function 变量 类 + 泛型 + 继承

Kotlin 是一门现代但已成熟的编程语言&#xff0c;旨在让开发人员更幸福快乐。 它简洁、安全、可与 Java 及其他语言互操作&#xff0c;并提供了多种方式在多个平台间复用代码&#xff0c;以实现高效编程。 https://play.kotlinlang.org/byExample/01_introduction/02_Functio…
阅读更多...
Docker Swarm总结（2/3）

Docker Swarm总结（2/3）

目录 8、service 操作 8.1 task 伸缩 8.2 task 容错 8.3 服务删除 8.4 滚动更新 8.5 更新回滚 9、service 全局部署模式 9.1 环境变更 9.2 创建 service 9.3 task 伸缩 10、overlay 网络 10.1 测试环境 1搭建 10.2 overlay 网络概述 10.3 docker_gwbridg 网络基础…
阅读更多...
【DevOps】Git 图文详解（八）：后悔药 - 撤销变更

【DevOps】Git 图文详解（八）：后悔药 - 撤销变更

Git 图文详解&#xff08;八&#xff09;&#xff1a;后悔药 - 撤销变更 1.后悔指令 &#x1f525;2.回退版本 reset3.撤销提交 revert4.checkout / reset / revert 总结 发现写错了要回退怎么办&#xff1f;看看下面几种后悔指令吧&#xff01; ❓ 还没提交的怎么撤销&#x…
阅读更多...
Visual Studio连接unity编辑器_unity基础开发教程

Visual Studio连接unity编辑器_unity基础开发教程

Visual Studio连接unity编辑器 问题描述解决方法意外情况 问题描述 当我们在unity编辑器中打开C#脚本的时候发现Visual Studio没有连接unity编辑器&#xff0c;在编写代码的时候也没有unity关键字的提醒。 简单来说就是敲代码没有代码提示。 解决方法 这时候需要在unity中进行…
阅读更多...
Qt实现图片旋转的几种方式（全）

Qt实现图片旋转的几种方式（全）

目录 一、用手搓&#xff08;QPainter&#xff09; 二、使用 QGraphicsView 和 QGraphicsPixmapItem 三、使用 QTransform 实现图像旋转 四、利用 OpenGL 实现旋转图像的效果有几种不同的方法&#xff0c;其中常见的包括&#xff1a; 手动旋转绘制&#xff1a; 使用 QPaint…
阅读更多...
终端仿真软件 SecureCRT v9.4.2

终端仿真软件 SecureCRT v9.4.2

SecureCRT是一款终端仿真软件&#xff0c;它提供了类似于Telnet和SSH等协议的远程访问功能。SecureCRT专门为网络管理员、系统管理员和其他需要保密访问网络设备的用户设计。 SecureCRT具有以下特点&#xff1a; 安全性&#xff1a;SecureCRT支持SSH1、SSH2、SSL和TLS等加密和…
阅读更多...
7.HTML中列表标签

7.HTML中列表标签

7.列表标签 7.1无序列表&#xff08;重点&#xff09; 表格是用来显示数据的&#xff0c;那么列表就是用来布局的。 列表最大的特点就是整齐&#xff0c;整洁&#xff0c;有序&#xff0c;他作为布局会更加自由和方便&#xff0c; 根据使用的情景不同&#xff0c;列表可分为三…
阅读更多...
数字图像处理(冈萨雷斯)学习笔记

数字图像处理(冈萨雷斯)学习笔记

目录 一.机器视觉和计算机视觉二.图像处理基础1.什么是图像2.如何访问图像 三.图像仿射变换四.灰度变换 一.机器视觉和计算机视觉 机器视觉(Machine Vision,MV)和计算机视觉(Computer Vision&#xff0c;CV)的区别和联系&#xff1a; 机器视觉更注重广义图像信号(激光&#xff…
阅读更多...
多柱汉诺塔问题

多柱汉诺塔问题

k柱汉诺塔 题目描述 汉诺塔&#xff08;Hanoi Tower&#xff09;&#xff0c;又称河内塔。 传说大梵天创造世界的时候做了三根金刚石柱子&#xff0c;按左、中、右排序。大梵天在左侧的柱子上&#xff0c;从下往上按照大小顺序摞着64片黄金圆盘&#xff0c;越靠下的圆盘越大。…
阅读更多...
个人博客项目 - 测试报告

个人博客项目 - 测试报告

文章目录 一、项目背景二、测试报告功能测试1.编写测试用例2.登录测试3.编写文章测试4.查看文章测试5.删除文章测试7.注销登录测试 自动化测试性能测试1.VUG2.进行场景设计3.生成性能测试报告 总结 本文开始 一、项目背景 通过学习测试相关的知识&#xff0c;动手实践并测试一…
阅读更多...
2023 年 亚太赛 APMCM ABC题 国际大学生数学建模挑战赛 |数学建模完整代码+建模过程全解全析

2023 年 亚太赛 APMCM ABC题 国际大学生数学建模挑战赛 |数学建模完整代码+建模过程全解全析

当大家面临着复杂的数学建模问题时&#xff0c;你是否曾经感到茫然无措&#xff1f;作为2022年美国大学生数学建模比赛的O奖得主&#xff0c;我为大家提供了一套优秀的解题思路&#xff0c;让你轻松应对各种难题。 以五一杯 A题为例子&#xff0c;以下是咱们做的一些想法呀&am…
阅读更多...
【Vue】自定义指令

【Vue】自定义指令

自定义指令 自定义指令就是自己定义的指令&#xff0c;是对 DOM 元素进行底层操作封装 ,程序化地控制 DOM&#xff0c;拓展额外的功能 全局定义 Vue.directive(指令名字, definition) 指令名&#xff1a;不包括v-前缀&#xff0c;使用时候包括v-&#xff0c;v-指令名defini…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023