异常解析
未处理的异常将向上冒泡到 Shell 的 ResultHandlerService
,然后最终由某个 ResultHandler
实例处理。可以使用 ExceptionResolver
实现链来解析异常,这为您提供了灵活性,可以将要写入控制台的消息与封装在 CommandHandlingResult
中的退出码一起返回。CommandHandlingResult
可能包含一个消息和/或退出码。
static class CustomExceptionResolver implements CommandExceptionResolver {
@Override
public CommandHandlingResult resolve(Exception e) {
if (e instanceof CustomException) {
return CommandHandlingResult.of("Hi, handled exception\n", 42);
}
return null;
}
}
CommandExceptionResolver
实现可以全局定义为 Bean。
@Bean
CustomExceptionResolver customExceptionResolver() {
return new CustomExceptionResolver();
}
或者如果仅适用于特定命令本身,则可以为每个 CommandRegistration
定义。
CommandRegistration.builder()
.withErrorHandling()
.resolver(new CustomExceptionResolver())
.and()
.build();
随命令定义的解析器在全局解析器之前处理。 |
如果您想在那里定义退出码,请使用您自己的异常类型,它们也可以是 boot 的 ExitCodeGenerator
实例。
static class CustomException extends RuntimeException implements ExitCodeGenerator {
@Override
public int getExitCode() {
return 0;
}
}
Spring Shell 注册了一些内置的 CommandExceptionResolver
Bean 来处理命令解析抛出的常见异常。这些 Bean 按照 CommandExceptionResolver.DEFAULT_PRECEDENCE
中定义的顺序优先级注册。由于这些 Bean 按照给定顺序使用,因此可以使用 @Order
注解或 Ordered
接口,就像在任何其他 Spring 应用中一样。如果您需要控制自己的 Bean 在默认 Bean 之前或之后使用,这通常非常有用。