diff --git a/CHANGELOG.md b/CHANGELOG.md index 0c6036887..4c7c7f1f9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ ------------------------------------------------------------------------------------------------------------- -# 5.5.2 (2020-11-25) +# 5.5.2 (2020-11-26) ### 新特性 * 【crypto 】 KeyUtil增加重载，AES构造增加重载（issue#I25NNZ@Gitee） @@ -16,6 +16,7 @@ * 【core 】 ZipUtil增加get方法 * 【cache 】 对CacheObj等变量使用volatile关键字 * 【core 】 Base64增加encodeWithoutPadding方法（issue#I26J16@Gitee） +* 【core 】 ExceptionUtil增加message消息包装为运行时异常的方法（issue#1253@Gitee） ### Bug修复 * 【cron 】 修复CronTimer可能死循环的问题（issue#1224@Github） diff --git a/hutool-core/src/main/java/cn/hutool/core/exceptions/ExceptionUtil.java b/hutool-core/src/main/java/cn/hutool/core/exceptions/ExceptionUtil.java index 8472b6ff5..8904b8248 100644 --- a/hutool-core/src/main/java/cn/hutool/core/exceptions/ExceptionUtil.java +++ b/hutool-core/src/main/java/cn/hutool/core/exceptions/ExceptionUtil.java @@ -16,15 +16,14 @@ import java.util.Map; /** * 异常工具类 - * - * @author Looly * + * @author Looly */ public class ExceptionUtil { /** * 获得完整消息，包括异常名，消息格式为：{SimpleClassName}: {ThrowableMessage} - * + * * @param e 异常 * @return 完整消息 */ @@ -37,7 +36,7 @@ public class ExceptionUtil { /** * 获得消息，调用异常类的getMessage方法 - * + * * @param e 异常 * @return 消息 */ @@ -47,9 +46,9 @@ public class ExceptionUtil { /** * 使用运行时异常包装编译异常
- * + *

* 如果传入参数已经是运行时异常，则直接返回，不再额外包装 - * + * * @param throwable 异常 * @return 运行时异常 */ @@ -62,19 +61,20 @@ public class ExceptionUtil { /** * 将指定的消息包装为运行时异常 + * * @param message 异常消息 * @return 运行时异常 * @since 5.5.2 */ - public static RuntimeException wrapRuntime(String message){ + public static RuntimeException wrapRuntime(String message) { return new RuntimeException(message); } /** * 包装一个异常 * - * @param 被包装的异常类型 - * @param throwable 异常 + * @param 被包装的异常类型 + * @param throwable 异常 * @param wrapThrowable 包装后的异常类 * @return 包装后的异常 * @since 3.3.0 @@ -90,7 +90,7 @@ public class ExceptionUtil { /** * 包装异常并重新抛出此异常
* {@link RuntimeException} 和{@link Error} 直接抛出，其它检查异常包装为{@link UndeclaredThrowableException} 后抛出 - * + * * @param throwable 异常 */ public static void wrapAndThrow(Throwable throwable) { @@ -105,16 +105,17 @@ public class ExceptionUtil { /** * 将消息包装为运行时异常并抛出 + * * @param message 异常消息 * @since 5.5.2 */ - public static void wrapRuntimeAndThrow(String message){ + public static void wrapRuntimeAndThrow(String message) { throw new RuntimeException(message); } /** * 剥离反射引发的InvocationTargetException、UndeclaredThrowableException中间异常，返回业务本身的异常 - * + * * @param wrapped 包装的异常 * @return 剥离后的异常 */ @@ -133,7 +134,7 @@ public class ExceptionUtil { /** * 获取当前栈信息 - * + * * @return 当前栈信息 */ public static StackTraceElement[] getStackElements() { @@ -154,7 +155,7 @@ public class ExceptionUtil { /** * 获取入口堆栈信息 - * + * * @return 入口堆栈信息 * @since 4.1.4 */ @@ -165,7 +166,7 @@ public class ExceptionUtil { /** * 堆栈转为单行完整字符串 - * + * * @param throwable 异常对象 * @return 堆栈转为的字符串 */ @@ -175,9 +176,9 @@ public class ExceptionUtil { /** * 堆栈转为单行完整字符串 - * + * * @param throwable 异常对象 - * @param limit 限制最大长度 + * @param limit 限制最大长度 * @return 堆栈转为的字符串 */ public static String stacktraceToOneLineString(Throwable throwable, int limit) { @@ -191,7 +192,7 @@ public class ExceptionUtil { /** * 堆栈转为完整字符串 - * + * * @param throwable 异常对象 * @return 堆栈转为的字符串 */ @@ -201,9 +202,9 @@ public class ExceptionUtil { /** * 堆栈转为完整字符串 - * + * * @param throwable 异常对象 - * @param limit 限制最大长度 + * @param limit 限制最大长度 * @return 堆栈转为的字符串 */ public static String stacktraceToString(Throwable throwable, int limit) { @@ -212,9 +213,9 @@ public class ExceptionUtil { /** * 堆栈转为完整字符串 - * - * @param throwable 异常对象 - * @param limit 限制最大长度 + * + * @param throwable 异常对象 + * @param limit 限制最大长度 * @param replaceCharToStrMap 替换字符为指定字符串 * @return 堆栈转为的字符串 */ @@ -248,8 +249,8 @@ public class ExceptionUtil { /** * 判断是否由指定异常类引起 - * - * @param throwable 异常 + * + * @param throwable 异常 * @param causeClasses 定义的引起异常的类 * @return 是否由指定异常类引起 * @since 4.1.13 @@ -261,8 +262,8 @@ public class ExceptionUtil { /** * 获取由指定异常类引起的异常 - * - * @param throwable 异常 + * + * @param throwable 异常 * @param causeClasses 定义的引起异常的类 * @return 是否由指定异常类引起 * @since 4.1.13 @@ -284,7 +285,7 @@ public class ExceptionUtil { /** * 判断指定异常是否来自或者包含指定异常 * - * @param throwable 异常 + * @param throwable 异常 * @param exceptionClass 定义的引起异常的类 * @return true 来自或者包含 * @since 4.3.2 @@ -296,9 +297,9 @@ public class ExceptionUtil { /** * 判断指定异常是否来自或者包含指定异常 * - * @param throwable 异常 + * @param throwable 异常 * @param exceptionClass 定义的引起异常的类 - * @param checkCause 判断cause + * @param checkCause 判断cause * @return true 来自或者包含 * @since 4.4.1 */ @@ -309,8 +310,8 @@ public class ExceptionUtil { /** * 转化指定异常为来自或者包含指定异常 * - * @param 异常类型 - * @param throwable 异常 + * @param 异常类型 + * @param throwable 异常 * @param exceptionClass 定义的引起异常的类 * @return 结果为null 不是来自或者包含 * @since 4.3.2 @@ -322,10 +323,10 @@ public class ExceptionUtil { /** * 转化指定异常为来自或者包含指定异常 * - * @param 异常类型 - * @param throwable 异常 + * @param 异常类型 + * @param throwable 异常 * @param exceptionClass 定义的引起异常的类 - * @param checkCause 判断cause + * @param checkCause 判断cause * @return 结果为null 不是来自或者包含 * @since 4.4.1 */ @@ -357,11 +358,11 @@ public class ExceptionUtil { /** * 获取异常链上所有异常的集合，如果{@link Throwable} 对象没有cause，返回只有一个节点的List
* 如果传入null，返回空集合 - * + * *

* 此方法来自Apache-Commons-Lang3 *

- * + * * @param throwable 异常对象，可以为null * @return 异常链中所有异常集合 * @since 4.6.2 @@ -379,11 +380,11 @@ public class ExceptionUtil { * 获取异常链中最尾端的异常，即异常最早发生的异常对象。
* 此方法通过调用{@link Throwable#getCause()} 直到没有cause为止，如果异常本身没有cause，返回异常本身
* 传入null返回也为null - * + * *

* 此方法来自Apache-Commons-Lang3 *

- * + * * @param throwable 异常对象，可能为null * @return 最尾端异常，传入null参数返回也为null */ @@ -394,7 +395,7 @@ public class ExceptionUtil { /** * 获取异常链中最尾端的异常的消息，消息格式为：{SimpleClassName}: {ThrowableMessage} - * + * * @param th 异常 * @return 消息 * @since 4.6.2