Lombok的@StandardException注解解析

2023-05-19 20:05:03 lombok 注解 解析

1. 引言

在 Java 应用程序中,异常类对于正确捕获和处理错误至关重要。我们常常在编写异常处理的重复代码上花费时间,而不是关注应用程序的其他方面。

在本教程中,我们将使用 Lombok 的 @StandardException 注解自动生成异常类型类的构造函数。此外,我们还将了解其优缺点。

2. 什么是 @StandardException?

@StandardException 是一个实验性的注解,添加到 Project Lombok 的 v__1.18.22 版本中。该注解适用于任何 Throwable 的子类,并自动生成四个构造函数:

  • 一个无参数构造函数
  • 一个仅带消息的构造函数,无异常原因
  • 一个仅带异常原因的构造函数,无消息
  • 一个带有消息和异常原因的标准构造函数

与大多数 Lombok 注解一样,@StandardException 非常简单,我们将在以下部分看到。

2.1. 添加 Lombok 依赖

我们需要使用 Project Lombok 的 v.1.18.22 或更高版本来使用该注解。因此,让我们将最新的 lombok::1.18.26 添加到我们的 pom.xml 文件中:

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.26</version>
    <scope>provided</scope>
</dependency>

2.2. 使用类注解

要在我们的异常中使用 @StandardException,我们必须创建一个扩展 Throwable 类或其任何子类的目标类。因此,它适用于检查和未检查异常以及错误。

为了说明,让我们创建一个 CustomException 类:

@StandardException
public class CustomException extends Throwable {
}

由于 CustomException 扩展了 Throwable,代码正常编译。让我们看看编译后生成的代码:

public class CustomException extends Throwable {
    public CustomException() {
        this((String)null, (Throwable)null);
    }
    public CustomException(String message) {
        this(message, (Throwable)null);
    }
    public CustomException(Throwable cause) {
        this(cause != null ? cause.getMessage() : null, cause);
    }
    public CustomException(String message, Throwable cause) {
        super(message);
        if (cause != null) {
            super.initCause(cause);
        }
    }
}

Lombok 注解的工作方式与实现自定义异常构造函数的通常 Java 方法不同。通常,jdk 通过调用指定签名的 super 构造函数版本来实现它们。例如,仅包含异常原因的构造函数在其实现中将调用 super(cause)。

另一方面,Lombok 的前三个构造函数依赖于生成的标准构造函数来构建异常对象。标准构造函数调用 super(message) 来构建初始对象。然后,如果不是 null,它使用 initCause() 方法初始化 CustomException 的原因

在使用注解时,我们必须考虑这两种实现的不同细微差别。

接下来,我们将在下一部分中讨论与通常方法相比,@StandardException 的一些优点和缺点。

3. 优点

使用 @StandardException 的主要优点是我们避免了编写样板代码。例如,在纯 Java 中创建一个 NumberFORMatException 的子类可能是这样的:

public class CustomNumberFormatException extends NumberFormatException{
    public CustomNumberFormatException() {
        super();
    }
    public CustomNumberFormatException(String s) {
        super(s);
    }
}

在上面的代码中,我们手动使用 NumberFormatException 的可用 super 构造函数创建了构造函数。

在实际应用程序中,该代码通常会在异常类之间重复。因此,我们最终多次复制粘贴相同的代码。当异常类数量较多时,这会更难维护。

相比之下,**通过使用 @StandardException,我们可以通过一行代码获得四个自动生成的构造函数。**因此,它可能会提高开发速度并改善代码可维护性。

关于 @StandardException 的另一个好点是,生成的构造函数仅使用 super(message) 构造函数,这在大多数 Java 异常中都存在。因此,我们避免了调用在父类中不存在的 super 构造函数。例如,NumberFormatException 没有定义标准和仅异常原因构造函数。因此,在其子类中调用 super(message, cause) 或 super(cause) 将失败。

最后,所有使用 @StandardException 的异常都具有 Lombok 实现的相同行为。由于 Lombok 自动生成代码,我们无法修改它。因此,我们不太可能向使用 @StandardException 注解的类中引入潜在的问题代码

4. 缺点

使用代码生成器的一个明显缺点是增加了调试的复杂性。在编写的代码中调试和发现缺陷比在生成的代码中更容易。因此,如果某些内容运行不正确,使用 @StandardException 可能会使调试会话变得复杂

另一个需要考虑的陷阱是对 Lombok 的依赖。将我们的代码与 @StandardException 耦合会增加返回纯Java 时的工作量。此外,如果 Lombok 方面出现问题,将影响所有使用该注解的异常

5. 结论

在这篇简短的文章中,我们学习了如何使用添加到 Lombok 版本 v.1.18.22 的 @StandardException。我们还了解了与纯 Java 代码手动实现相比的一些优缺点。

关键是在我们的应用程序中平衡其优点和缺点,而不是滥用它

与往常一样,源代码可以在 GitHub 上找到。

到此这篇关于Lombok 的@StandardException注解介绍的文章就介绍到这了,更多相关Lombok @StandardException注解内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!

相关文章