【Java】Lombok的@SneakyThrows注解

113 阅读1分钟

Java的非受检和受检异常

  1. 非受检异常(UnCheckedException - RuntimeException)
  2. 受检异常(CheckedException):强制要求抛出它的方法声明throws,调用者必须显示的去处理这个异常。设计的目的是为了提醒开发者处理一些场景中必然可能存在的异常情况。比如网络异常造成IOException。大部分情况下的异常,我们都是一路往外抛了事,所以渐渐地java程序员处理Exception的常见手段就是外面包一层RuntimeException,接着往上丢。这种解决思想尤其在Spring中到处出现:
try{
  // 方法体
}catch(Exception e){
    throw new RuntimeException(e);
}

@SneakyThrows的介绍和源码

@SneakyThrows注解属于java的异常设计体系。

针对受检异常抛出Exception的模板代码,Lombok的@SneakyThrows的出现就是为了消除这样的模板代码,使用注解后不需要担心Exception的处理。例:

@Test
public void testUTF8ToString() {
    String str = utf8ToString(new byte[]{'a', 'b', 'c'});
    System.out.println(str);
}

@SneakyThrows(UnsupportedEncodingException.class)
public String utf8ToString(byte[] bytes) {
    return new String(bytes, StandardCharsets.UTF_8);
}

真正生成的代码:

import lombok.Lombok;

public class SneakyThrowsExample implements Runnable {
  public String utf8ToString(byte[] bytes) {
    try {
      return new String(bytes, "UTF-8");
    } catch (UnsupportedEncodingException e) {
      throw Lombok.sneakyThrow(e);
    }
  }
}

说明:throw (T)t;,利用泛型将我们传入的Throwable强转为RuntimeException,泛型最后存储为字节码时并没有泛型的信息,这样写只是为了骗过javac编译器。

源码如下所示(Lombok类):

public static RuntimeException sneakyThrow(Throwable t) {
    if (t == null) {
        throw new NullPointerException("t");
    } else {
        return (RuntimeException)sneakyThrow0(t);
    }
}

private static <T extends Throwable> T sneakyThrow0(Throwable t) throws T {
    throw (T)t;
}