程序包 org.springframework.web.servlet.handler

类 SimpleMappingExceptionResolver

    • 方法详细资料

      • setExceptionMappings

        public void setExceptionMappings​(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 javax.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​(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 resolver 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.

        另请参阅:
        setDefaultStatusCode(int)

      • setDefaultStatusCode

        public void setDefaultStatusCode​(int defaultStatusCode)
        Set the default HTTP status code that this exception resolver 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 (HttpServletResponse.SC_INTERNAL_SERVER_ERROR) or 404 (HttpServletResponse.SC_NOT_FOUND)
        另请参阅:
        setStatusCodes(Properties)

      • 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.

        另请参阅:
        DEFAULT_EXCEPTION_ATTRIBUTE

      • doResolveException

        @Nullable
protected ModelAndView doResolveException​(HttpServletRequest request,
                                          HttpServletResponse response,
                                          @Nullable
                                          Object handler,
                                          Exception 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.

        指定者:
        doResolveException 在类中 AbstractHandlerExceptionResolver
        参数:
        request - current HTTP request
        response - current HTTP response
        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

      • getDepth

        protected int getDepth​(String exceptionMapping,
                       Exception 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.

      • getModelAndView

        protected ModelAndView getModelAndView​(String viewName,
                                       Exception 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
        另请参阅:
        setExceptionAttribute(java.lang.String)