zhouxy108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-07-21 15:09:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

add method

Browse Source
This commit is contained in:
Looly
2020-11-27 02:56:08 +08:00
parent db2b350684
commit a329a1c44c
2 changed files with 43 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
CHANGELOG.md
View File

@@ -3,7 +3,7 @@
------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------
# 5.5.2 (2020-11-25) # 5.5.2 (2020-11-26)
### 新特性 ### 新特性
* 【crypto 】 KeyUtil增加重载，AES构造增加重载（issue#I25NNZ@Gitee） * 【crypto 】 KeyUtil增加重载，AES构造增加重载（issue#I25NNZ@Gitee）
@@ -16,6 +16,7 @@
* 【core 】 ZipUtil增加get方法 * 【core 】 ZipUtil增加get方法
* 【cache 】 对CacheObj等变量使用volatile关键字 * 【cache 】 对CacheObj等变量使用volatile关键字
* 【core 】 Base64增加encodeWithoutPadding方法（issue#I26J16@Gitee） * 【core 】 Base64增加encodeWithoutPadding方法（issue#I26J16@Gitee）
* 【core 】 ExceptionUtil增加message消息包装为运行时异常的方法（issue#1253@Gitee）
### Bug修复 ### Bug修复
* 【cron 】 修复CronTimer可能死循环的问题（issue#1224@Github） * 【cron 】 修复CronTimer可能死循环的问题（issue#1224@Github）

81
hutool-core/src/main/java/cn/hutool/core/exceptions/ExceptionUtil.java
View File

@@ -16,15 +16,14 @@ import java.util.Map;
/** /**
* 异常工具类 * 异常工具类
*
* @author Looly
* *
* @author Looly
*/ */
public class ExceptionUtil { public class ExceptionUtil {
/** /**
* 获得完整消息，包括异常名，消息格式为：{SimpleClassName}: {ThrowableMessage} * 获得完整消息，包括异常名，消息格式为：{SimpleClassName}: {ThrowableMessage}
* *
* @param e 异常 * @param e 异常
* @return 完整消息 * @return 完整消息
*/ */
@@ -37,7 +36,7 @@ public class ExceptionUtil {
/** /**
* 获得消息，调用异常类的getMessage方法 * 获得消息，调用异常类的getMessage方法
* *
* @param e 异常 * @param e 异常
* @return 消息 * @return 消息
*/ */
@@ -47,9 +46,9 @@ public class ExceptionUtil {
/** /**
* 使用运行时异常包装编译异常<br> * 使用运行时异常包装编译异常<br>
* * <p>
* 如果传入参数已经是运行时异常，则直接返回，不再额外包装 * 如果传入参数已经是运行时异常，则直接返回，不再额外包装
* *
* @param throwable 异常 * @param throwable 异常
* @return 运行时异常 * @return 运行时异常
*/ */
@@ -62,19 +61,20 @@ public class ExceptionUtil {
/** /**
* 将指定的消息包装为运行时异常 * 将指定的消息包装为运行时异常
*
* @param message 异常消息 * @param message 异常消息
* @return 运行时异常 * @return 运行时异常
* @since 5.5.2 * @since 5.5.2
*/ */
public static RuntimeException wrapRuntime(String message){ public static RuntimeException wrapRuntime(String message) {
return new RuntimeException(message); return new RuntimeException(message);
} }
/** /**
* 包装一个异常 * 包装一个异常
* *
* @param <T> 被包装的异常类型 * @param <T> 被包装的异常类型
* @param throwable 异常 * @param throwable 异常
* @param wrapThrowable 包装后的异常类 * @param wrapThrowable 包装后的异常类
* @return 包装后的异常 * @return 包装后的异常
* @since 3.3.0 * @since 3.3.0
@@ -90,7 +90,7 @@ public class ExceptionUtil {
/** /**
* 包装异常并重新抛出此异常<br> * 包装异常并重新抛出此异常<br>
* {@link RuntimeException} 和{@link Error} 直接抛出，其它检查异常包装为{@link UndeclaredThrowableException} 后抛出 * {@link RuntimeException} 和{@link Error} 直接抛出，其它检查异常包装为{@link UndeclaredThrowableException} 后抛出
* *
* @param throwable 异常 * @param throwable 异常
*/ */
public static void wrapAndThrow(Throwable throwable) { public static void wrapAndThrow(Throwable throwable) {
@@ -105,16 +105,17 @@ public class ExceptionUtil {
/** /**
* 将消息包装为运行时异常并抛出 * 将消息包装为运行时异常并抛出
*
* @param message 异常消息 * @param message 异常消息
* @since 5.5.2 * @since 5.5.2
*/ */
public static void wrapRuntimeAndThrow(String message){ public static void wrapRuntimeAndThrow(String message) {
throw new RuntimeException(message); throw new RuntimeException(message);
} }
/** /**
* 剥离反射引发的InvocationTargetException、UndeclaredThrowableException中间异常，返回业务本身的异常 * 剥离反射引发的InvocationTargetException、UndeclaredThrowableException中间异常，返回业务本身的异常
* *
* @param wrapped 包装的异常 * @param wrapped 包装的异常
* @return 剥离后的异常 * @return 剥离后的异常
*/ */
@@ -133,7 +134,7 @@ public class ExceptionUtil {
/** /**
* 获取当前栈信息 * 获取当前栈信息
* *
* @return 当前栈信息 * @return 当前栈信息
*/ */
public static StackTraceElement[] getStackElements() { public static StackTraceElement[] getStackElements() {
@@ -154,7 +155,7 @@ public class ExceptionUtil {
/** /**
* 获取入口堆栈信息 * 获取入口堆栈信息
* *
* @return 入口堆栈信息 * @return 入口堆栈信息
* @since 4.1.4 * @since 4.1.4
*/ */
@@ -165,7 +166,7 @@ public class ExceptionUtil {
/** /**
* 堆栈转为单行完整字符串 * 堆栈转为单行完整字符串
* *
* @param throwable 异常对象 * @param throwable 异常对象
* @return 堆栈转为的字符串 * @return 堆栈转为的字符串
*/ */
@@ -175,9 +176,9 @@ public class ExceptionUtil {
/** /**
* 堆栈转为单行完整字符串 * 堆栈转为单行完整字符串
* *
* @param throwable 异常对象 * @param throwable 异常对象
* @param limit 限制最大长度 * @param limit 限制最大长度
* @return 堆栈转为的字符串 * @return 堆栈转为的字符串
*/ */
public static String stacktraceToOneLineString(Throwable throwable, int limit) { public static String stacktraceToOneLineString(Throwable throwable, int limit) {
@@ -191,7 +192,7 @@ public class ExceptionUtil {
/** /**
* 堆栈转为完整字符串 * 堆栈转为完整字符串
* *
* @param throwable 异常对象 * @param throwable 异常对象
* @return 堆栈转为的字符串 * @return 堆栈转为的字符串
*/ */
@@ -201,9 +202,9 @@ public class ExceptionUtil {
/** /**
* 堆栈转为完整字符串 * 堆栈转为完整字符串
* *
* @param throwable 异常对象 * @param throwable 异常对象
* @param limit 限制最大长度 * @param limit 限制最大长度
* @return 堆栈转为的字符串 * @return 堆栈转为的字符串
*/ */
public static String stacktraceToString(Throwable throwable, int limit) { public static String stacktraceToString(Throwable throwable, int limit) {
@@ -212,9 +213,9 @@ public class ExceptionUtil {
/** /**
* 堆栈转为完整字符串 * 堆栈转为完整字符串
* *
* @param throwable 异常对象 * @param throwable 异常对象
* @param limit 限制最大长度 * @param limit 限制最大长度
* @param replaceCharToStrMap 替换字符为指定字符串 * @param replaceCharToStrMap 替换字符为指定字符串
* @return 堆栈转为的字符串 * @return 堆栈转为的字符串
*/ */
@@ -248,8 +249,8 @@ public class ExceptionUtil {
/** /**
* 判断是否由指定异常类引起 * 判断是否由指定异常类引起
* *
* @param throwable 异常 * @param throwable 异常
* @param causeClasses 定义的引起异常的类 * @param causeClasses 定义的引起异常的类
* @return 是否由指定异常类引起 * @return 是否由指定异常类引起
* @since 4.1.13 * @since 4.1.13
@@ -261,8 +262,8 @@ public class ExceptionUtil {
/** /**
* 获取由指定异常类引起的异常 * 获取由指定异常类引起的异常
* *
* @param throwable 异常 * @param throwable 异常
* @param causeClasses 定义的引起异常的类 * @param causeClasses 定义的引起异常的类
* @return 是否由指定异常类引起 * @return 是否由指定异常类引起
* @since 4.1.13 * @since 4.1.13
@@ -284,7 +285,7 @@ public class ExceptionUtil {
/** /**
* 判断指定异常是否来自或者包含指定异常 * 判断指定异常是否来自或者包含指定异常
* *
* @param throwable 异常 * @param throwable 异常
* @param exceptionClass 定义的引起异常的类 * @param exceptionClass 定义的引起异常的类
* @return true 来自或者包含 * @return true 来自或者包含
* @since 4.3.2 * @since 4.3.2
@@ -296,9 +297,9 @@ public class ExceptionUtil {
/** /**
* 判断指定异常是否来自或者包含指定异常 * 判断指定异常是否来自或者包含指定异常
* *
* @param throwable 异常 * @param throwable 异常
* @param exceptionClass 定义的引起异常的类 * @param exceptionClass 定义的引起异常的类
* @param checkCause 判断cause * @param checkCause 判断cause
* @return true 来自或者包含 * @return true 来自或者包含
* @since 4.4.1 * @since 4.4.1
*/ */
@@ -309,8 +310,8 @@ public class ExceptionUtil {
/** /**
* 转化指定异常为来自或者包含指定异常 * 转化指定异常为来自或者包含指定异常
* *
* @param <T> 异常类型 * @param <T> 异常类型
* @param throwable 异常 * @param throwable 异常
* @param exceptionClass 定义的引起异常的类 * @param exceptionClass 定义的引起异常的类
* @return 结果为null 不是来自或者包含 * @return 结果为null 不是来自或者包含
* @since 4.3.2 * @since 4.3.2
@@ -322,10 +323,10 @@ public class ExceptionUtil {
/** /**
* 转化指定异常为来自或者包含指定异常 * 转化指定异常为来自或者包含指定异常
* *
* @param <T> 异常类型 * @param <T> 异常类型
* @param throwable 异常 * @param throwable 异常
* @param exceptionClass 定义的引起异常的类 * @param exceptionClass 定义的引起异常的类
* @param checkCause 判断cause * @param checkCause 判断cause
* @return 结果为null 不是来自或者包含 * @return 结果为null 不是来自或者包含
* @since 4.4.1 * @since 4.4.1
*/ */
@@ -357,11 +358,11 @@ public class ExceptionUtil {
/** /**
* 获取异常链上所有异常的集合，如果{@link Throwable} 对象没有cause，返回只有一个节点的List<br> * 获取异常链上所有异常的集合，如果{@link Throwable} 对象没有cause，返回只有一个节点的List<br>
* 如果传入null，返回空集合 * 如果传入null，返回空集合
* *
* <p> * <p>
* 此方法来自Apache-Commons-Lang3 * 此方法来自Apache-Commons-Lang3
* </p> * </p>
* *
* @param throwable 异常对象，可以为null * @param throwable 异常对象，可以为null
* @return 异常链中所有异常集合 * @return 异常链中所有异常集合
* @since 4.6.2 * @since 4.6.2
@@ -379,11 +380,11 @@ public class ExceptionUtil {
* 获取异常链中最尾端的异常，即异常最早发生的异常对象。<br> * 获取异常链中最尾端的异常，即异常最早发生的异常对象。<br>
* 此方法通过调用{@link Throwable#getCause()} 直到没有cause为止，如果异常本身没有cause，返回异常本身<br> * 此方法通过调用{@link Throwable#getCause()} 直到没有cause为止，如果异常本身没有cause，返回异常本身<br>
* 传入null返回也为null * 传入null返回也为null
* *
* <p> * <p>
* 此方法来自Apache-Commons-Lang3 * 此方法来自Apache-Commons-Lang3
* </p> * </p>
* *
* @param throwable 异常对象，可能为null * @param throwable 异常对象，可能为null
* @return 最尾端异常，传入null参数返回也为null * @return 最尾端异常，传入null参数返回也为null
*/ */
@@ -394,7 +395,7 @@ public class ExceptionUtil {
/** /**
* 获取异常链中最尾端的异常的消息，消息格式为：{SimpleClassName}: {ThrowableMessage} * 获取异常链中最尾端的异常的消息，消息格式为：{SimpleClassName}: {ThrowableMessage}
* *
* @param th 异常 * @param th 异常
* @return 消息 * @return 消息
* @since 4.6.2 * @since 4.6.2