mirror of
https://gitee.com/dromara/hutool.git
synced 2025-04-05 17:37:59 +08:00
add method
This commit is contained in:
Looly
parent
db2b350684
commit
a329a1c44c
@ -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）
|
||||
|
||||
@ -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 {
|
||||
|
||||
/**
|
||||
* 使用运行时异常包装编译异常<br>
|
||||
*
|
||||
* <p>
|
||||
* 如果传入参数已经是运行时异常，则直接返回，不再额外包装
|
||||
*
|
||||
*
|
||||
* @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 <T> 被包装的异常类型
|
||||
* @param throwable 异常
|
||||
* @param <T> 被包装的异常类型
|
||||
* @param throwable 异常
|
||||
* @param wrapThrowable 包装后的异常类
|
||||
* @return 包装后的异常
|
||||
* @since 3.3.0
|
||||
@ -90,7 +90,7 @@ public class ExceptionUtil {
|
||||
/**
|
||||
* 包装异常并重新抛出此异常<br>
|
||||
* {@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 <T> 异常类型
|
||||
* @param throwable 异常
|
||||
* @param <T> 异常类型
|
||||
* @param throwable 异常
|
||||
* @param exceptionClass 定义的引起异常的类
|
||||
* @return 结果为null 不是来自或者包含
|
||||
* @since 4.3.2
|
||||
@ -322,10 +323,10 @@ public class ExceptionUtil {
|
||||
/**
|
||||
* 转化指定异常为来自或者包含指定异常
|
||||
*
|
||||
* @param <T> 异常类型
|
||||
* @param throwable 异常
|
||||
* @param <T> 异常类型
|
||||
* @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<br>
|
||||
* 如果传入null，返回空集合
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* 此方法来自Apache-Commons-Lang3
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param throwable 异常对象，可以为null
|
||||
* @return 异常链中所有异常集合
|
||||
* @since 4.6.2
|
||||
@ -379,11 +380,11 @@ public class ExceptionUtil {
|
||||
* 获取异常链中最尾端的异常，即异常最早发生的异常对象。<br>
|
||||
* 此方法通过调用{@link Throwable#getCause()} 直到没有cause为止，如果异常本身没有cause，返回异常本身<br>
|
||||
* 传入null返回也为null
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* 此方法来自Apache-Commons-Lang3
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param throwable 异常对象，可能为null
|
||||
* @return 最尾端异常，传入null参数返回也为null
|
||||
*/
|
||||
@ -394,7 +395,7 @@ public class ExceptionUtil {
|
||||
|
||||
/**
|
||||
* 获取异常链中最尾端的异常的消息，消息格式为：{SimpleClassName}: {ThrowableMessage}
|
||||
*
|
||||
*
|
||||
* @param th 异常
|
||||
* @return 消息
|
||||
* @since 4.6.2
|
||||
|
||||
Loading…
Reference in New Issue
Block a user