SimpleMappingExceptionResolver (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.web.servlet.handler
Class SimpleMappingExceptionResolver

java.lang.Object
  org.springframework.web.servlet.handler.SimpleMappingExceptionResolver

All Implemented Interfaces:: Ordered, HandlerExceptionResolver

public class SimpleMappingExceptionResolver
extends Object
implements HandlerExceptionResolver, Ordered
extends Object
implements HandlerExceptionResolver, Ordered

Exception resolver that allows for mapping exception class names to view names, either for a list of given handlers or for all handlers in the DispatcherServlet.

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.

Since:: 22.11.2003
Author:: Juergen Hoeller

Field Summary

static String DEFAULT_EXCEPTION_ATTRIBUTE
          The default name of the exception attribute: "exception".

protected Log logger


Constructor Summary

SimpleMappingExceptionResolver()


Method Summary

protected String findMatchingViewName(Properties exceptionMappings, Exception ex)
          Find a matching view name in the given exception mappings

protected int getDepth(String exceptionMapping, Exception ex)
          Return the depth to the superclass matching. 0 means ex matches exactly.

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

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

int getOrder()
          Return the order value of this object, higher value meaning greater in terms of sorting.

ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
          Try to resolve the given exception that got thrown during on handler execution, returning a ModelAndView that represents a specific error page if appropriate.

void setDefaultErrorView(String defaultErrorView)
          Set the name of the default error view.

void setDefaultStatusCode(int defaultStatusCode)
          Set the default HTTP status code that this exception resolver will apply if it resolves an error view.

void setExceptionAttribute(String exceptionAttribute)
          Set the name of the model attribute as which the exception should be exposed.

void setExceptionMappings(Properties mappings)
          Set the mappings between exception class names and error view names.

void setMappedHandlers(Set mappedHandlers)
          Specify the set of handlers that this exception resolver should map.

void setOrder(int order)


Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Summary
`static String`	`DEFAULT_EXCEPTION_ATTRIBUTE` The default name of the exception attribute: "exception".
`protected Log`	`logger`

Constructor Summary
`SimpleMappingExceptionResolver()`

Method Summary
`protected String`	`findMatchingViewName(Properties exceptionMappings, Exception ex)` Find a matching view name in the given exception mappings
`protected int`	`getDepth(String exceptionMapping, Exception ex)` Return the depth to the superclass matching. 0 means ex matches exactly.
`protected ModelAndView`	`getModelAndView(String viewName, Exception ex)` Return a ModelAndView for the given view name and exception.
`protected ModelAndView`	`getModelAndView(String viewName, Exception ex, HttpServletRequest request)` Return a ModelAndView for the given request, view name and exception.
`int`	`getOrder()` Return the order value of this object, higher value meaning greater in terms of sorting.
`ModelAndView`	`resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)` Try to resolve the given exception that got thrown during on handler execution, returning a ModelAndView that represents a specific error page if appropriate.
`void`	`setDefaultErrorView(String defaultErrorView)` Set the name of the default error view.
`void`	`setDefaultStatusCode(int defaultStatusCode)` Set the default HTTP status code that this exception resolver will apply if it resolves an error view.
`void`	`setExceptionAttribute(String exceptionAttribute)` Set the name of the model attribute as which the exception should be exposed.
`void`	`setExceptionMappings(Properties mappings)` Set the mappings between exception class names and error view names.
`void`	`setMappedHandlers(Set mappedHandlers)` Specify the set of handlers that this exception resolver should map.
`void`	`setOrder(int order)`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

DEFAULT_EXCEPTION_ATTRIBUTE

public static final String DEFAULT_EXCEPTION_ATTRIBUTE

The default name of the exception attribute: "exception".

See Also:: Constant Field Values

logger

protected final Log logger

Constructor Detail

SimpleMappingExceptionResolver

public SimpleMappingExceptionResolver()

Method Detail

setOrder

public void setOrder(int order)

getOrder

public int getOrder()

Description copied from interface: Ordered

Return the order value of this object, higher value meaning greater in terms of sorting. Normally starting with 0 or 1, Integer.MAX_VALUE indicating greatest. Same order values will result in arbitrary positions for the affected objects.

Higher value can be interpreted as lower priority, consequently the first object has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Specified by:: getOrder in interface Ordered

Returns:: the order value

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.

Follows the same matching algorithm as RuleBasedTransactionAttribute and RollbackRuleAttribute.

Parameters:: mappings - exception patterns (can also be fully qualified class names) as keys, and error view names as values
See Also:: RuleBasedTransactionAttribute, RollbackRuleAttribute

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.

setMappedHandlers

public void setMappedHandlers(Set mappedHandlers)

Specify the set of handlers that this exception resolver should map. The exception mappings and the default error view will only apply to the specified handlers.

If no handlers set, both the exception mappings and the default error view will apply to all handlers. This means that a specified default error view will be used as fallback for all exceptions; any further HandlerExceptionResolvers in the chain will be ignored in this case.

setDefaultStatusCode

public void setDefaultStatusCode(int defaultStatusCode)

Set the default HTTP status code that this exception resolver will apply if it resolves an error view.

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

Parameters:: defaultStatusCode - HTTP status code value, for example 500 (SC_INTERNAL_SERVER_ERROR) or 404 (SC_NOT_FOUND)
See Also:: HttpServletResponse.SC_INTERNAL_SERVER_ERROR, HttpServletResponse.SC_NOT_FOUND

setExceptionAttribute

public void setExceptionAttribute(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.

See Also:: DEFAULT_EXCEPTION_ATTRIBUTE

resolveException

public ModelAndView resolveException(HttpServletRequest request,
                                     HttpServletResponse response,
                                     Object handler,
                                     Exception ex)

Description copied from interface: HandlerExceptionResolver

Try to resolve the given exception that got thrown during on handler execution, returning a ModelAndView that represents a specific error page if appropriate.

Specified by:: resolveException in interface HandlerExceptionResolver

Parameters:: 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
Returns:: a corresponding ModelAndView to forward to, or null for default processing

findMatchingViewName

protected String findMatchingViewName(Properties exceptionMappings,
                                      Exception ex)

Find a matching view name in the given exception mappings

Parameters:: exceptionMappings - mappings between exception class names and error view names; ex - the exception that got thrown during handler execution
Returns:: the view name, or null if none found
See Also:: setExceptionMappings(java.util.Properties)

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.

Follows the same algorithm as RollbackRuleAttribute.

See Also:: RollbackRuleAttribute

getModelAndView

protected ModelAndView getModelAndView(String viewName,
                                       Exception ex,
                                       HttpServletRequest request)

Return a ModelAndView for the given request, view name and exception. Default implementation delegates to getModelAndView(viewName, ex).

Parameters:: viewName - the name of the error view; ex - the exception that got thrown during handler execution; request - current HTTP request (useful for obtaining metadata)
Returns:: the ModelAndView instance
See Also:: getModelAndView(String, Exception)

getModelAndView

protected ModelAndView getModelAndView(String viewName,
                                       Exception ex)

Return a ModelAndView for the given view name and exception. Default implementation adds the specified exception attribute. Can be overridden in subclasses.

Parameters:: viewName - the name of the error view; ex - the exception that got thrown during handler execution
Returns:: the ModelAndView instance
See Also:: setExceptionAttribute(java.lang.String)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

SimpleMappingExceptionResolver (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

org.springframework.web.servlet.handler Class SimpleMappingExceptionResolver

DEFAULT_EXCEPTION_ATTRIBUTE

logger

SimpleMappingExceptionResolver

setOrder

getOrder

setExceptionMappings

setDefaultErrorView

setMappedHandlers

setDefaultStatusCode

setExceptionAttribute

resolveException

findMatchingViewName

getDepth

getModelAndView

getModelAndView

org.springframework.web.servlet.handler
Class SimpleMappingExceptionResolver