Class DefaultErrorWebExceptionHandler

java.lang.Object
org.springframework.boot.webflux.autoconfigure.error.AbstractErrorWebExceptionHandler
org.springframework.boot.webflux.autoconfigure.error.DefaultErrorWebExceptionHandler
All Implemented Interfaces:
InitializingBean, ErrorWebExceptionHandler, WebExceptionHandler
public class DefaultErrorWebExceptionHandler extends AbstractErrorWebExceptionHandler
Basic global WebExceptionHandler, rendering ErrorAttributes.

More specific errors can be handled either using Spring WebFlux abstractions (e.g. @ExceptionHandler with the annotation model) or by adding RouterFunction to the chain.

This implementation will render error as HTML views if the client explicitly supports that media type. It attempts to resolve error views using well known conventions. Will search for templates and static assets under '/error' using the status code and the status series.

For example, an HTTP 404 will search (in the specific order):

  • '/<templates>/error/404.<ext>'
  • '/<static>/error/404.html'
  • '/<templates>/error/4xx.<ext>'
  • '/<static>/error/4xx.html'
  • '/<templates>/error/error'
  • '/<static>/error/error.html'

If none found, a default "Whitelabel Error" HTML view will be rendered.

If the client doesn't support HTML, the error information will be rendered as a JSON payload.

Since:
4.0.0
Author:
Brian Clozel, Scott Frederick, Moritz Halbritter

  • Constructor Details

    • DefaultErrorWebExceptionHandler

      public DefaultErrorWebExceptionHandler(ErrorAttributes errorAttributes, WebProperties.Resources resources, ErrorProperties errorProperties, ApplicationContext applicationContext)
      Create a new DefaultErrorWebExceptionHandler instance.
      Parameters:
      errorAttributes - the error attributes
      resources - the resources configuration properties
      errorProperties - the error configuration properties
      applicationContext - the current application context

  • Method Details

    • getRoutingFunction

      protected RouterFunction<ServerResponse> getRoutingFunction(ErrorAttributes errorAttributes)
      Description copied from class: AbstractErrorWebExceptionHandler
      Create a RouterFunction that can route and handle errors as JSON responses or HTML views.

      If the returned RouterFunction doesn't route to a HandlerFunction, the original exception is propagated in the pipeline and can be processed by other WebExceptionHandlers.

      Specified by:
      getRoutingFunction in class AbstractErrorWebExceptionHandler
      Parameters:
      errorAttributes - the ErrorAttributes instance to use to extract error information
      Returns:
      a RouterFunction that routes and handles errors

    • renderErrorView

      protected reactor.core.publisher.Mono<ServerResponse> renderErrorView(ServerRequest request)
      Render the error information as an HTML view.
      Parameters:
      request - the current request
      Returns:
      a Publisher of the HTTP response

    • renderErrorResponse

      protected reactor.core.publisher.Mono<ServerResponse> renderErrorResponse(ServerRequest request)
      Render the error information as a JSON payload.
      Parameters:
      request - the current request
      Returns:
      a Publisher of the HTTP response

    • getErrorAttributeOptions

      protected ErrorAttributeOptions getErrorAttributeOptions(ServerRequest request, MediaType mediaType)

    • isIncludeStackTrace

      protected boolean isIncludeStackTrace(ServerRequest request, MediaType produces)
      Determine if the stacktrace attribute should be included.
      Parameters:
      request - the source request
      produces - the media type produced (or MediaType.ALL)
      Returns:
      if the stacktrace attribute should be included

    • isIncludeMessage

      protected boolean isIncludeMessage(ServerRequest request, MediaType produces)
      Determine if the message attribute should be included.
      Parameters:
      request - the source request
      produces - the media type produced (or MediaType.ALL)
      Returns:
      if the message attribute should be included

    • isIncludeBindingErrors

      protected boolean isIncludeBindingErrors(ServerRequest request, MediaType produces)
      Determine if the errors attribute should be included.
      Parameters:
      request - the source request
      produces - the media type produced (or MediaType.ALL)
      Returns:
      if the errors attribute should be included

    • isIncludePath

      protected boolean isIncludePath(ServerRequest request, MediaType produces)
      Determine if the path attribute should be included.
      Parameters:
      request - the source request
      produces - the media type produced (or MediaType.ALL)
      Returns:
      if the path attribute should be included

    • getHttpStatus

      protected int getHttpStatus(Map<String, @Nullable Object> errorAttributes)
      Get the HTTP error status information from the error map.
      Parameters:
      errorAttributes - the current error information
      Returns:
      the error HTTP status

    • acceptsTextHtml

      protected RequestPredicate acceptsTextHtml()
      Predicate that checks whether the current request explicitly support "text/html" media type.

      The "match-all" media type is not considered here.

      Returns:
      the request predicate