在spring-webflux中处理错误的正确方法是什么

时间:2017-04-23 19:24:38

标签: spring-webflux

我一直在使用spring-webflux进行一些研究,我想了解使用路由器功能处理错误的正确方法。

我已经创建了一个小项目来测试几个场景,我想获得有关它的反馈,看看其他人在做什么。

到目前为止我所做的是。

提供以下路由功能:

@Component
public class HelloRouter {
    @Bean
    RouterFunction<?> helloRouterFunction() {
        HelloHandler handler = new HelloHandler();
        ErrorHandler error = new ErrorHandler();

        return nest(path("/hello"),
                nest(accept(APPLICATION_JSON),
                        route(GET("/"), handler::defaultHello)
                                .andRoute(POST("/"), handler::postHello)
                                .andRoute(GET("/{name}"), handler::getHello)
                )).andOther(route(RequestPredicates.all(), error::notFound));
    }
}

我在我的处理程序上执行此操作

class HelloHandler {

    private ErrorHandler error;

    private static final String DEFAULT_VALUE = "world";

    HelloHandler() {
        error = new ErrorHandler();
    }

    private Mono<ServerResponse> getResponse(String value) {
        if (value.equals("")) {
            return Mono.error(new InvalidParametersException("bad parameters"));
        }
        return ServerResponse.ok().body(Mono.just(new HelloResponse(value)), HelloResponse.class);
    }

    Mono<ServerResponse> defaultHello(ServerRequest request) {
        return getResponse(DEFAULT_VALUE);
    }

    Mono<ServerResponse> getHello(ServerRequest request) {
        return getResponse(request.pathVariable("name"));
    }

    Mono<ServerResponse> postHello(ServerRequest request) {
        return request.bodyToMono(HelloRequest.class).flatMap(helloRequest -> getResponse(helloRequest.getName()))
                .onErrorResume(error::badRequest);
    }
}

我的错误处理程序:

class ErrorHandler {

    private static Logger logger = LoggerFactory.getLogger(ErrorHandler.class);

    private static BiFunction<HttpStatus,String,Mono<ServerResponse>> response =
    (status,value)-> ServerResponse.status(status).body(Mono.just(new ErrorResponse(value)),
            ErrorResponse.class);

    Mono<ServerResponse> notFound(ServerRequest request){
        return response.apply(HttpStatus.NOT_FOUND, "not found");
    }

    Mono<ServerResponse> badRequest(Throwable error){
        logger.error("error raised", error);
        return response.apply(HttpStatus.BAD_REQUEST, error.getMessage());
    }
}

以下是完整的样本回购:

https://github.com/LearningByExample/reactive-ms-example

6 个答案:

答案 0 :(得分:7)

Spring 5提供了一个WebHandler,在JavaDoc中,有一行:

  

使用HttpWebHandlerAdapter将WebHandler调整为HttpHandler。 WebHttpHandlerBuilder提供了一种方便的方法,同时还可以选择配置一个或多个过滤器和/或异常处理程序。

目前,官方文档建议我们应该在启动任何服务器之前将路由器功能包装到HttpHandler中:

HttpHandler httpHandler = RouterFunctions.toHttpHandler(routerFunction);

WebHttpHandlerBuilder的帮助下,我们可以配置自定义异常处理程序:

HttpHandler httpHandler = WebHttpHandlerBuilder.webHandler(toHttpHandler(routerFunction))
  .prependExceptionHandler((serverWebExchange, exception) -> {

      /* custom handling goes here */
      return null;

  }).build();

答案 1 :(得分:6)

如果您认为路由器功能不是处理异常的正确位置,则抛出HTTP异常,这将导致正确的HTTP错误代码。 对于Spring-Boot(也是webflux),这是:

  import org.springframework.http.HttpStatus;
  import org.springframework.web.server.ResponseStatusException;
  .
  .
  . 

  new ResponseStatusException(HttpStatus.NOT_FOUND,  "Collection not found");})

spring securities AccessDeniedException也将被正确处理(403/401响应代码)。

如果您有微服务,并且想要使用REST,这可能是一个不错的选择,因为这些http异常非常接近业务逻辑,在这种情况下应该放在业务逻辑附近。因为在微服务中你不应该有太多的商业逻辑和例外,它也不应该混乱你的代码......(当然,这一切都取决于)。

答案 2 :(得分:3)

为什么不通过从处理程序函数中抛出异常并实现自己的WebExceptionHandler来捕获所有内容,从而采用旧式方法:

@Component
class ExceptionHandler : WebExceptionHandler {
    override fun handle(exchange: ServerWebExchange?, ex: Throwable?): Mono<Void> {
        /* Handle different exceptions here */
        when(ex!!) {
            is NoSuchElementException -> exchange!!.response.statusCode = HttpStatus.NOT_FOUND
            is Exception -> exchange!!.response.statusCode = HttpStatus.INTERNAL_SERVER_ERROR
        }

        /* Do common thing like logging etc... */

        return Mono.empty()
    }
}

以上示例是在Kotlin,因为我只是从我正在处理的项目中复制粘贴它,因为原始问题还没有为java标记。

答案 3 :(得分:2)

将异常映射到http响应状态的快速方法是抛出org.springframework.web.server.ResponseStatusException /或创建自己的子类......

完全控制http响应状态+ spring将添加一个响应正文,并添加reason选项。

在Kotlin中,它看起来就像

一样简单
@Component
class MyHandler(private val myRepository: MyRepository) {

    fun getById(req: ServerRequest) = req.pathVariable("id").toMono()
            .map { id -> uuidFromString(id) }  // throws ResponseStatusException
            .flatMap { id -> noteRepository.findById(id) }
            .flatMap { entity -> ok().json().body(entity.toMono()) }
            .switchIfEmpty(notFound().build())  // produces 404 if not found

}

fun uuidFromString(id: String?) = try { UUID.fromString(id) } catch (e: Throwable) { throw BadRequestStatusException(e.localizedMessage) }

class BadRequestStatusException(reason: String) : ResponseStatusException(HttpStatus.BAD_REQUEST, reason)

回应机构:

{
    "timestamp": 1529138182607,
    "path": "/api/notes/f7b.491bc-5c86-4fe6-9ad7-111",
    "status": 400,
    "error": "Bad Request",
    "message": "For input string: \"f7b.491bc\""
}

答案 4 :(得分:1)

您可以编写具有自定义响应数据和响应代码的Global异常处理程序,如下所示。该代码在Kotlin中。但是您可以轻松地将其转换为Java:

@Component
@Order(-2)
class GlobalWebExceptionHandler(
  private val objectMapper: ObjectMapper
) : ErrorWebExceptionHandler {

  override fun handle(exchange: ServerWebExchange, ex: Throwable): Mono<Void> {

    val response = when (ex) {
      // buildIOExceptionMessage should build relevant exception message as a serialisable object
      is IOException -> buildIOExceptionMessage(ex)
      else -> buildExceptionMessage(ex)
    }

    // Or you can also set them inside while conditions
    exchange.response.headers.contentType = MediaType.APPLICATION_PROBLEM_JSON
    exchange.response.statusCode = HttpStatus.valueOf(response.status)
    val bytes = objectMapper.writeValueAsBytes(response)
    val buffer = exchange.response.bufferFactory().wrap(bytes)
    return exchange.response.writeWith(Mono.just(buffer))
  }
}

答案 5 :(得分:0)

我目前正在做的只是提供一个bean我的WebExceptionHandler:

@Bean
@Order(0)
public WebExceptionHandler responseStatusExceptionHandler() {
    return new MyWebExceptionHandler();
}

我自己创建HttpHandler的好处是,如果我提供自己的WebFluxConfigurer或使用ServerCodecConfigurer

,我可以更好地与SpringSecurity集成