@ExceptionResolver

@ShellComponent 类可以包含 @ExceptionResolver 方法来处理组件方法中的异常。这些方法适用于带注解的方法。

异常可能与正在传播的顶级异常匹配(例如,直接抛出的 IOException),或者与包装异常内的嵌套原因匹配(例如,包装在 IllegalStateException 内部的 IOException)。这可以在任意原因级别进行匹配。

对于匹配异常类型,最好将目标异常声明为方法参数,如前面的示例所示。当多个异常方法匹配时,通常优先选择根异常匹配而不是原因异常匹配。更具体地说,ExceptionDepthComparator 用于根据异常类型与已抛出异常类型的深度来对异常进行排序。

或者,注解声明可以缩小要匹配的异常类型范围,如下例所示

@ExceptionResolver({ RuntimeException.class })
CommandHandlingResult errorHandler(Exception e) {
	// Exception would be type of RuntimeException,
	// optionally do something with it
	return CommandHandlingResult.of("Hi, handled exception\n", 42);
}
@ExceptionResolver
CommandHandlingResult errorHandler(RuntimeException e) {
	return CommandHandlingResult.of("Hi, handled custom exception\n", 42);
}

@ExceptionResolver 也可以返回 String,它用作控制台的输出。可以使用 @ExitCode 注解来定义返回码。

@ExceptionResolver
@ExitCode(code = 5)
String errorHandler(Exception e) {
	return "Hi, handled exception";
}

返回类型为 void@ExceptionResolver 会自动处理为已处理异常。然后,您还可以定义 @ExitCode 并使用 Terminal,如果您需要向控制台写入内容。

@ExceptionResolver
@ExitCode(code = 5)
void errorHandler(Exception e, Terminal terminal) {
	PrintWriter writer = terminal.writer();
	String msg =  "Hi, handled exception " + e.toString();
	writer.println(msg);
	writer.flush();
}

方法参数

@ExceptionResolver 方法支持以下参数

方法参数 描述

异常类型

用于访问引发的异常。这可以是任何类型的 ExceptionThrowable

终端

用于访问底层的 JLine 终端,例如获取其终端写入器。

返回值

@ExceptionResolver 方法支持以下返回值

返回值 描述

String

要返回到 Shell 的纯文本。在这种情况下,使用退出码 1。

CommandHandlingResult

具有消息和退出码的普通 CommandHandlingResult

void

返回类型为 void 的方法被认为已完全处理异常。通常,您会将 Terminal 作为方法参数并使用其中的终端写入器来写入响应。由于异常已完全处理,因此在这种情况下使用退出码 0。