使用范围: 只能作用在方法和构造函数之上

@SneakyThrows 注解的作用得从 java 的异常设计体系说起。

java 中常见的异常有两种:

  1. Exception 即非运行时异常 (编译异常)。
  2. RuntimeException 即运行时异常。

第一种会强制要求抛出它的方法声明 throws,从程序语法角度讲是必须进行处理的异常,如果不处理,程序就不能编译通过。设计的目的是为了提醒开发者处理一些场景中必然可能存在的异常情况。比如网络异常造成 IOException。

但是现实,往往事与愿违。大部分情况下的异常,我们都是一路往外抛了事。所以渐渐的大家处理 Exception 的常见手段就是外面包一层 RuntimeException,接着往上丢。这种解决思想尤其在 Spring 中到处出现。参见《Spring in Action》

try {
			
		} catch (Exception e) {
			throw new RuntimeException(e);
		}

Lombok 的 @SneakyThrows 就是为了消除这样的模板代码。
使用注解后不需要担心 Exception 的处理

@SneakyThrows
   public void utf8ToString(byte[] bytes) {
       return new String(bytes, "UTF-8");
   }

真正生成的代码

public void utf8ToString(byte[] bytes) {
       try {
      return new String(bytes, "UTF-8");
    } catch (Exception e) {
      throw Lombok.sneakyThrow(e);
    }
}

原理:

显然魔法藏在 throw Lombok.sneakyThrow(e); 中。可能大家都会以为这个方法就是 new RuntimeException() 之类的。然而事实并非如此。阅读代码可以看出整个方法其实最核心的逻辑是 throw (T) t;,利用泛型将我们传入的 Throwable 强转为 RuntimeException。虽然事实上我们不是 RuntimeException。但是没关系,因为 JVM 并不关心这个。泛型最后存储为字节码时并没有泛型的信息。这样写只是为了骗过 javac 编译器。

public static RuntimeException sneakyThrow(Throwable t) {
        if (t == null) throw new NullPointerException("t");
        return Lombok.<RuntimeException>sneakyThrow0(t);
    }
 
    private static <T extends Throwable> T sneakyThrow0(Throwable t) throws T {
        throw (T)t;
    }