程序包 cn.taketoday.web.handler

类 SimpleMappingExceptionHandler

java.lang.Object
cn.taketoday.core.OrderedSupport
cn.taketoday.web.handler.AbstractHandlerExceptionHandler
cn.taketoday.web.handler.SimpleMappingExceptionHandler
所有已实现的接口:
cn.taketoday.core.Ordered, HandlerExceptionHandler
public class SimpleMappingExceptionHandler extends AbstractHandlerExceptionHandler
HandlerExceptionHandler implementation that allows for mapping exception class names to view names, either for a set of given handlers or for all handlers in the DispatcherHandler.

Error views are analogous to error page JSPs, but can be used with any kind of exception including any checked one, with fine-granular mappings for specific handlers.

从以下版本开始:
4.0 2022/3/3 9:41
作者:
Juergen Hoeller, Arjen Poutsma, Rossen Stoyanchev, Harry Yang

  • 字段详细资料

    • DEFAULT_EXCEPTION_ATTRIBUTE

      public static final String DEFAULT_EXCEPTION_ATTRIBUTE
      The default name of the exception attribute: "exception".
      另请参阅:

    • exceptionMappings

      @Nullable private Properties exceptionMappings

    • excludedExceptions

      @Nullable private Class<?>[] excludedExceptions

    • defaultErrorView

      @Nullable private String defaultErrorView

    • defaultStatusCode

      @Nullable private Integer defaultStatusCode

    • statusCodes

      private final HashMap<String,Integer> statusCodes

    • exceptionAttribute

      @Nullable private String exceptionAttribute

  • 构造器详细资料

    • SimpleMappingExceptionHandler

      public SimpleMappingExceptionHandler()

  • 方法详细资料

    • setExceptionMappings

      public void setExceptionMappings(@Nullable Properties mappings)
      Set the mappings between exception class names and error view names. The exception class name can be a substring, with no wildcard support at present. A value of "ServletException" would match jakarta.servlet.ServletException and subclasses, for example.

      NB: Consider carefully how specific the pattern is, and whether to include package information (which isn't mandatory). For example, "Exception" will match nearly anything, and will probably hide other rules. "java.lang.Exception" would be correct if "Exception" was meant to define a rule for all checked exceptions. With more unusual exception names such as "BaseBusinessException" there's no need to use a FQN.

      参数:
      mappings - exception patterns (can also be fully qualified class names) as keys, and error view names as values

    • setExcludedExceptions

      public void setExcludedExceptions(Class<?>... excludedExceptions)
      Set one or more exceptions to be excluded from the exception mappings. Excluded exceptions are checked first and if one of them equals the actual exception, the exception will remain unresolved.
      参数:
      excludedExceptions - one or more excluded exception types

    • setDefaultErrorView

      public void setDefaultErrorView(@Nullable String defaultErrorView)
      Set the name of the default error view. This view will be returned if no specific mapping was found.

      Default is none.

    • setStatusCodes

      public void setStatusCodes(Properties statusCodes)
      Set the HTTP status code that this exception handler will apply for a given resolved error view. Keys are view names; values are status codes.

      Note that this error code will only get applied in case of a top-level request. It will not be set for an include request, since the HTTP status cannot be modified from within an include.

      If not specified, the default status code will be applied.

      另请参阅:

    • addStatusCode

      public void addStatusCode(String viewName, int statusCode)
      An alternative to setStatusCodes(Properties) for use with Java-based configuration.

    • getStatusCodesAsMap

      public Map<String,Integer> getStatusCodesAsMap()
      Returns the HTTP status codes provided via setStatusCodes(Properties). Keys are view names; values are status codes.

    • setDefaultStatusCode

      public void setDefaultStatusCode(int defaultStatusCode)
      Set the default HTTP status code that this exception handler will apply if it resolves an error view and if there is no status code mapping defined.

      Note that this error code will only get applied in case of a top-level request. It will not be set for an include request, since the HTTP status cannot be modified from within an include.

      If not specified, no status code will be applied, either leaving this to the controller or view, or keeping the servlet engine's default of 200 (OK).

      参数:
      defaultStatusCode - the HTTP status code value, for example 500 (HttpStatus.INTERNAL_SERVER_ERROR) or 404 (HttpStatus.NOT_FOUND)
      另请参阅:

    • setExceptionAttribute

      public void setExceptionAttribute(@Nullable String exceptionAttribute)
      Set the name of the model attribute as which the exception should be exposed. Default is "exception".

      This can be either set to a different attribute name or to null for not exposing an exception attribute at all.

      另请参阅:

    • handleInternal

      @Nullable protected ModelAndView handleInternal(RequestContext request, @Nullable Object handler, Throwable ex)
      Actually resolve the given exception that got thrown during on handler execution, returning a ModelAndView that represents a specific error page if appropriate.

      May be overridden in subclasses, in order to apply specific exception checks. Note that this template method will be invoked after checking whether this resolved applies ("mappedHandlers" etc), so an implementation may simply proceed with its actual exception handling.

      指定者:
      handleInternal 在类中 AbstractHandlerExceptionHandler
      参数:
      request - current HTTP request
      handler - the executed handler, or null if none chosen at the time of the exception (for example, if multipart resolution failed)
      ex - the exception that got thrown during handler execution
      返回:
      a corresponding ModelAndView to forward to, or null for default processing in the resolution chain

    • determineViewName

      @Nullable protected String determineViewName(Throwable ex, RequestContext request)
      Determine the view name for the given exception, first checking against the "excludedExecptions", then searching the "exceptionMappings", and finally using the "defaultErrorView" as a fallback.
      参数:
      ex - the exception that got thrown during handler execution
      request - current HTTP request (useful for obtaining metadata)
      返回:
      the resolved view name, or null if excluded or none found

    • findMatchingViewName

      @Nullable protected String findMatchingViewName(Properties exceptionMappings, Throwable ex)
      Find a matching view name in the given exception mappings.
      参数:
      exceptionMappings - mappings between exception class names and error view names
      ex - the exception that got thrown during handler execution
      返回:
      the view name, or null if none found
      另请参阅:

    • getDepth

      protected int getDepth(String exceptionMapping, Throwable ex)
      Return the depth to the superclass matching.

      0 means ex matches exactly. Returns -1 if there's no match. Otherwise, returns depth. Lowest depth wins.

    • getDepth

      private int getDepth(String exceptionMapping, Class<?> exceptionClass, int depth)

    • determineStatusCode

      @Nullable protected Integer determineStatusCode(RequestContext request, String viewName)
      Determine the HTTP status code to apply for the given error view.

      The default implementation returns the status code for the given view name (specified through the statusCodes property), or falls back to the defaultStatusCode if there is no match.

      Override this in a custom subclass to customize this behavior.

      参数:
      request - current HTTP request
      viewName - the name of the error view
      返回:
      the HTTP status code to use, or null for the servlet container's default (200 in case of a standard error view)
      另请参阅:

    • applyStatusCodeIfPossible

      protected void applyStatusCodeIfPossible(RequestContext request, int statusCode)
      Apply the specified HTTP status code to the given response, if possible (that is, if not executing within an include request).
      参数:
      request - current HTTP request
      statusCode - the status code to apply
      另请参阅:

    • getModelAndView

      protected ModelAndView getModelAndView(String viewName, Throwable ex, RequestContext request)
      Return a ModelAndView for the given request, view name and exception.

      The default implementation delegates to getModelAndView(String, Throwable).

      参数:
      viewName - the name of the error view
      ex - the exception that got thrown during handler execution
      request - current HTTP request (useful for obtaining metadata)
      返回:
      the ModelAndView instance

    • getModelAndView

      protected ModelAndView getModelAndView(String viewName, Throwable ex)
      Return a ModelAndView for the given view name and exception.

      The default implementation adds the specified exception attribute. Can be overridden in subclasses.

      参数:
      viewName - the name of the error view
      ex - the exception that got thrown during handler execution
      返回:
      the ModelAndView instance
      另请参阅: