io.polaris.core.err

类 Exceptions

java.lang.Object

io.polaris.core.err.Exceptions

public class Exceptions
extends Object

异常处理工具类，提供各种处理异常的便捷方法。

该类包含以下功能：

• 异常类型查找和转换
• 异常根因分析
• 静默执行方法（忽略异常）
• 异常堆栈跟踪信息获取
• 异常匹配检查

使用示例：

 // 获取异常的根因
 Throwable rootCause = Exceptions.getRootCause(exception);

 // 静默执行代码，忽略可能的异常
 String result = Exceptions.getQuietly(() -> someMethodThatMayThrow());

 // 检查异常是否属于指定类型
 boolean isIOException = Exceptions.matches(exception, IOException.class);
 

从以下版本开始:

1.8

作者:

Qt

构造器概要

构造器

构造器和说明
Exceptions()

方法概要

限定符和类型	方法和说明
static <T> T	callQuietly(Callable<T> callable) 静默执行Callable，忽略可能发生的异常
static <T> T	callQuietly(Callable<T> callable, Consumer<Throwable> consumer) 静默执行Callable，使用指定的消费者处理可能发生的异常
static <T> T	callQuietly(Callable<T> callable, Throwable t) 静默执行Callable，将可能发生的异常添加为指定Throwable的抑制异常
static void	executeQuietly(Executable executable) 静默执行Executable，忽略可能发生的异常
static void	executeQuietly(Executable executable, Consumer<Throwable> consumer) 静默执行Executable，使用指定的消费者处理可能发生的异常
static void	executeQuietly(Executable executable, Throwable t) 静默执行Executable，将可能发生的异常添加为指定Throwable的抑制异常
static Set<Throwable>	getCausePath(Throwable t) 获取Throwable的因果链路径
static <T> T	getQuietly(Supplier<T> supplier) 静默获取Supplier的值，忽略可能发生的异常
static <T> T	getQuietly(Supplier<T> supplier, Consumer<Throwable> consumer) 静默获取Supplier的值，使用指定的消费者处理可能发生的异常
static <T> T	getQuietly(Supplier<T> supplier, Throwable t) 静默获取Supplier的值，将可能发生的异常添加为指定Throwable的抑制异常
static Throwable	getRootCause(Throwable t) 获取Throwable的根因异常
static Throwable	getRootCauseSafely(Throwable t) 安全地获取Throwable的根因异常，防止循环引用
static Throwable	getRootCauseSafelyUntil(Throwable t, Predicate<Throwable> predicate) 安全地获取Throwable的根因异常，直到满足指定条件为止，防止循环引用
static Throwable	getRootCauseUntil(Throwable t, Predicate<Throwable> predicate) 获取Throwable的根因异常，直到满足指定条件为止
static String	getStackTrace(Throwable t) 获取Throwable的堆栈跟踪信息
static Throwable	hasCause(Throwable t, Class<? extends Throwable> type) 检查Throwable或其因果链中是否存在指定类型的异常
static Throwable	hasCause(Throwable t, Predicate<Throwable> predicate) 检查Throwable或其因果链中是否存在满足条件的异常
static boolean	matches(Throwable throwable, boolean matchIfEmpty, Class<? extends Throwable>... targets) 检查抛出的异常是否与目标异常类型列表中的任何一个匹配
static boolean	matches(Throwable throwable, Class<? extends Throwable>... targets) 检查抛出的异常是否与目标异常类型列表中的任何一个匹配
static <T extends Exception> T	of(Throwable t, Class<T> type, Function<Throwable,T> builder) 从Throwable中查找指定类型的异常，如果找不到则使用Function构建器创建新的异常实例
static <T extends Exception> T	of(Throwable t, Class<T> type, Supplier<T> builder) 从Throwable中查找指定类型的异常，如果找不到则使用Supplier构建器创建新的异常实例
static void	quietlyClose(AutoCloseable closeable) 静默关闭AutoCloseable资源，忽略可能发生的异常
static void	quietlyClose(AutoCloseable closeable, Throwable t) 静默关闭AutoCloseable资源，将可能发生的异常添加为指定Throwable的抑制异常
static void	runQuietly(Runnable runnable) 静默执行Runnable，忽略可能发生的异常
static void	runQuietly(Runnable runnable, Consumer<Throwable> consumer) 静默执行Runnable，使用指定的消费者处理可能发生的异常
static void	runQuietly(Runnable runnable, Throwable t) 静默执行Runnable，将可能发生的异常添加为指定Throwable的抑制异常

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Exceptions

public Exceptions()

方法详细资料

of

public static <T extends Exception> T of(Throwable t,
                                         Class<T> type,
                                         Function<Throwable,T> builder)

从Throwable中查找指定类型的异常，如果找不到则使用Function构建器创建新的异常实例

类型参数:

T - 异常类型

参数:

t - 要查找的Throwable对象，可以为null

type - 要查找的异常类型

builder - 当找不到指定类型异常时用于创建新异常的函数

返回:

找到的指定类型异常或新创建的异常实例

of

public static <T extends Exception> T of(Throwable t,
                                         Class<T> type,
                                         Supplier<T> builder)

从Throwable中查找指定类型的异常，如果找不到则使用Supplier构建器创建新的异常实例

类型参数:

T - 异常类型

参数:

t - 要查找的Throwable对象，可以为null

type - 要查找的异常类型

builder - 当找不到指定类型异常时用于创建新异常的供应器

返回:

找到的指定类型异常或新创建的异常实例

getRootCauseUntil

public static Throwable getRootCauseUntil(@Nonnull
                                          Throwable t,
                                          Predicate<Throwable> predicate)

获取Throwable的根因异常，直到满足指定条件为止

参数:

t - Throwable对象

predicate - 判断条件

返回:

满足条件的Throwable对象或最后一个根因异常

getRootCauseSafelyUntil

public static Throwable getRootCauseSafelyUntil(@Nonnull
                                                Throwable t,
                                                Predicate<Throwable> predicate)

安全地获取Throwable的根因异常，直到满足指定条件为止，防止循环引用

参数:

t - Throwable对象

predicate - 判断条件

返回:

满足条件的Throwable对象或最后一个根因异常

getRootCause

public static Throwable getRootCause(@Nonnull
                                     Throwable t)

获取Throwable的根因异常

参数:

t - Throwable对象

返回:

根因异常

getRootCauseSafely

public static Throwable getRootCauseSafely(@Nonnull
                                           Throwable t)

安全地获取Throwable的根因异常，防止循环引用

参数:

t - Throwable对象

返回:

根因异常

getCausePath

public static Set<Throwable> getCausePath(@Nonnull
                                          Throwable t)

获取Throwable的因果链路径

参数:

t - Throwable对象

返回:

包含所有因果关系异常的集合

hasCause

public static Throwable hasCause(@Nonnull
                                 Throwable t,
                                 Predicate<Throwable> predicate)

检查Throwable或其因果链中是否存在满足条件的异常

参数:

t - Throwable对象

predicate - 判断条件

返回:

满足条件的Throwable对象，如果不存在则返回null

hasCause

public static Throwable hasCause(@Nonnull
                                 Throwable t,
                                 Class<? extends Throwable> type)

检查Throwable或其因果链中是否存在指定类型的异常

参数:

t - Throwable对象

type - 要检查的异常类型

返回:

找到的指定类型异常，如果不存在则返回null

getStackTrace

public static String getStackTrace(Throwable t)

获取Throwable的堆栈跟踪信息

参数:

t - Throwable对象

返回:

堆栈跟踪信息字符串

quietlyClose

public static void quietlyClose(AutoCloseable closeable)

静默关闭AutoCloseable资源，忽略可能发生的异常

参数:

closeable - 可关闭的资源

quietlyClose

public static void quietlyClose(AutoCloseable closeable,
                                Throwable t)

静默关闭AutoCloseable资源，将可能发生的异常添加为指定Throwable的抑制异常

参数:

closeable - 可关闭的资源

t - 用于添加抑制异常的Throwable

runQuietly

public static void runQuietly(Runnable runnable)

静默执行Runnable，忽略可能发生的异常

参数:

runnable - 要执行的Runnable

runQuietly

public static void runQuietly(Runnable runnable,
                              Consumer<Throwable> consumer)

静默执行Runnable，使用指定的消费者处理可能发生的异常

参数:

runnable - 要执行的Runnable

consumer - 用于处理异常的消费者

runQuietly

public static void runQuietly(Runnable runnable,
                              Throwable t)

静默执行Runnable，将可能发生的异常添加为指定Throwable的抑制异常

参数:

runnable - 要执行的Runnable

t - 用于添加抑制异常的Throwable

getQuietly

public static <T> T getQuietly(Supplier<T> supplier)

静默获取Supplier的值，忽略可能发生的异常

类型参数:

T - 返回值类型

参数:

supplier - 提供值的Supplier

返回:

Supplier提供的值，如果发生异常则返回null

getQuietly

public static <T> T getQuietly(Supplier<T> supplier,
                               Consumer<Throwable> consumer)

静默获取Supplier的值，使用指定的消费者处理可能发生的异常

类型参数:

T - 返回值类型

参数:

supplier - 提供值的Supplier

consumer - 用于处理异常的消费者

返回:

Supplier提供的值，如果发生异常则返回null

getQuietly

public static <T> T getQuietly(Supplier<T> supplier,
                               Throwable t)

静默获取Supplier的值，将可能发生的异常添加为指定Throwable的抑制异常

类型参数:

T - 返回值类型

参数:

supplier - 提供值的Supplier

t - 用于添加抑制异常的Throwable

返回:

Supplier提供的值，如果发生异常则返回null

executeQuietly

public static void executeQuietly(Executable executable)

静默执行Executable，忽略可能发生的异常

参数:

executable - 要执行的Executable

executeQuietly

public static void executeQuietly(Executable executable,
                                  Consumer<Throwable> consumer)

静默执行Executable，使用指定的消费者处理可能发生的异常

参数:

executable - 要执行的Executable

consumer - 用于处理异常的消费者

executeQuietly

public static void executeQuietly(Executable executable,
                                  Throwable t)

静默执行Executable，将可能发生的异常添加为指定Throwable的抑制异常

参数:

executable - 要执行的Executable

t - 用于添加抑制异常的Throwable

callQuietly

public static <T> T callQuietly(Callable<T> callable)

静默执行Callable，忽略可能发生的异常

类型参数:

T - 返回值类型

参数:

callable - 要执行的Callable

返回:

Callable的执行结果，如果发生异常则返回null

callQuietly

public static <T> T callQuietly(Callable<T> callable,
                                Consumer<Throwable> consumer)

静默执行Callable，使用指定的消费者处理可能发生的异常

类型参数:

T - 返回值类型

参数:

callable - 要执行的Callable

consumer - 用于处理异常的消费者

返回:

Callable的执行结果，如果发生异常则返回null

callQuietly

public static <T> T callQuietly(Callable<T> callable,
                                Throwable t)

静默执行Callable，将可能发生的异常添加为指定Throwable的抑制异常

类型参数:

T - 返回值类型

参数:

callable - 要执行的Callable

t - 用于添加抑制异常的Throwable

返回:

Callable的执行结果，如果发生异常则返回null

matches

@SafeVarargs
public static boolean matches(Throwable throwable,
                                            Class<? extends Throwable>... targets)

检查抛出的异常是否与目标异常类型列表中的任何一个匹配

参数:

throwable - 要检查的抛出异常

targets - 目标异常类型列表

返回:

如果throwable是targets中任何一种类型的实例则返回true，否则返回false

matches

@SafeVarargs
public static boolean matches(Throwable throwable,
                                            boolean matchIfEmpty,
                                            Class<? extends Throwable>... targets)

检查抛出的异常是否与目标异常类型列表中的任何一个匹配

参数:

throwable - 要检查的抛出异常

matchIfEmpty - 当targets为空时的默认返回值

targets - 目标异常类型列表

返回:

如果throwable是targets中任何一种类型的实例则返回true，否则返回false