【注解】 @SneakyThrows 自动捕获并处理异常

@SneakyThrows 是 Lombok 库中的一个注解，用于简化 Java 异常处理的代码。这个注解可以自动抛出检查型异常（checked exceptions），而无需在方法签名中显式声明 throws 子句。这样做可以减少代码的冗余，特别是在你不想处理异常或只是想向上传递异常的情况下。

1、使用 @SneakyThrows 的优点：

• 减少模板代码：不需要编写 try-catch 块或在方法签名中声明异常。
• 代码简洁：使方法实现更加简洁，聚焦于业务逻辑而非异常处理。

2、使用 @SneakyThrows 的缺点：

• 隐蔽性：可能隐藏潜在的异常处理需要，使得调用者不容易意译到方法可能抛出的异常。
• 滥用风险：如果滥用，可能导致异常处理不当，增加调试难度和潜在的错误风险。

3、例子

下面是一个使用 @SneakyThrows 的简单示例：

import lombok.SneakyThrows;
import java.io.*;

public class Example {
    
    @SneakyThrows // 注解处理 IOException，无需显式声明 throws IOException
    public static void main(String[] args) {
        writeFile("example.txt", "Hello, Lombok @SneakyThrows!");
    }

    // 本例中，不需要显式声明 throws IOException
    @SneakyThrows
    private static void writeFile(String path, String content) {
        try (BufferedWriter writer = new BufferedWriter(new FileWriter(path))) {
            writer.write(content);
        }
    }
}

在上述代码中，writeFile 方法使用 @SneakyThrows 处理 IOException，无需在方法签名中声明 throws IOException。这使得代码更简洁，但使用时应考虑到可能对异常处理造成的隐蔽性。如果异常处理是方法的一部分，最好显式处理或声明，以便调用者知晓可能的风险。

4、注意

@SneakyThrows 注解不会自动渗透到多层方法调用。它只作用于直接标注的方法，对于该方法内部调用的其他方法，如果这些方法抛出了检查型异常，它们需要自己的处理机制，除非它们也使用了 @SneakyThrows 注解。

• 示例说明：
  假设你有两个方法，一个是 methodA，另一个是 methodB。methodA 调用了 methodB。

import lombok.SneakyThrows;

public class Test {

    @SneakyThrows
    public void methodA() {
        methodB(); // 调用 methodB
    }

    public void methodB() throws IOException {
        // 抛出一个检查型异常
        throw new IOException("This is an IOException.");
    }
}

在上述例子中：

methodA 使用了 @SneakyThrows，因此它可以不用在其方法签名中声明任何异常，也不需要在方法体中处理异常。
尽管 methodA 使用了 @SneakyThrows，methodB 抛出的 IOException 必须在它自己的层级上被处理或声明。在这种情况下，methodB 仍然需要声明它抛出 IOException。
如果你希望 methodB 也不声明异常，那么你也需要在 methodB 上使用 @SneakyThrows：

import lombok.SneakyThrows;

public class Test {

    @SneakyThrows
    public void methodA() {
        methodB(); // 调用 methodB
    }

    @SneakyThrows // Now methodB is also annotated with @SneakyThrows
    public void methodB() {
        // 抛出一个检查型异常
        throw new IOException("This is an IOException.");
    }
}

总结：@SneakyThrows 只影响直接标注的方法。如果要避免在多层方法调用中重复处理相同的检查型异常，你需要在每一个可能抛出检查型异常的方法上使用 @SneakyThrows 注解。