@SneakyThrows
注解的用途得从 Java 的异常设计体系说起。
Java中我们常见的2类异常。
1. 普通Exception
类,也就是我们常说的受检异常或者Checked Exception。
2. RuntimeException
类,既运行时异常。
前者会强制要求抛出它的方法声明throws,调用者必须显示的去处理这个异常。设计的目的是为了提醒开发者处理一些场景中必然可能存在的异常情况。比如网络异常造成IOException。
但是现实,往往事与愿违。大部分情况下的异常,我们都是一路往外抛了事。(强制处理我也处理不了啊!臣妾做不到)所以渐渐的java程序员处理Exception的常见手段就是外面包一层RuntimeException,接着往上丢。这种解决思想尤其在Spring中到处出现。参见《Spring in Action》
try { } catch(Exceptione) { thrownewRuntimeException(e); }
Lombok的@SneakyThrows就是为了消除这样的模板代码。
使用注解后不需要担心Exception的处理
importlombok.SneakyThrows; publicclassSneakyThrowsExampleimplementsRunnable { UnsupportedEncodingException.class) (publicStringutf8ToString(byte[] bytes) { returnnewString(bytes, "UTF-8"); } publicvoidrun() { thrownewThrowable(); } }
真正生成的代码
importlombok.Lombok; publicclassSneakyThrowsExampleimplementsRunnable { publicStringutf8ToString(byte[] bytes) { try { returnnewString(bytes, "UTF-8"); } catch (UnsupportedEncodingExceptione) { throwLombok.sneakyThrow(e); } } publicvoidrun() { try { thrownewThrowable(); } catch (Throwablet) { throwLombok.sneakyThrow(t); } } }
原理
显然魔法 藏在Lombok.sneakyThrow(t);
中。可能大家都会以为这个方法就是new RuntimeException()之类的。然而事实并非如此。阅读代码可以看出整个方法其实最核心的逻辑是throw (T)t;
,利用泛型将我们传入的Throwable强转为RuntimeException。虽然事实上我们不是RuntimeException。但是没关系。因为JVM并不关心这个。泛型最后存储为字节码时并没有泛型的信息。这样写只是为了骗过javac编译器。源码中注释有解释。
publicstaticRuntimeExceptionsneakyThrow(Throwablet) { if (t==null) thrownewNullPointerException("t"); returnLombok.<RuntimeException>sneakyThrow0(t); } privatestatic<TextendsThrowable>TsneakyThrow0(Throwablet) throwsT { throw (T)t; }