|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.springframework.web.portlet.handler.SimpleMappingExceptionResolver
public class SimpleMappingExceptionResolver
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 DispatcherPortlet.
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.
Field Summary | |
---|---|
static String |
DEFAULT_EXCEPTION_ATTRIBUTE
|
protected Log |
logger
|
Fields inherited from interface org.springframework.core.Ordered |
---|
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE |
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,
RenderRequest request)
Return a ModelAndView for the given request, view name and exception. |
int |
getOrder()
Return the order value of this object, with a higher value meaning greater in terms of sorting. |
ModelAndView |
resolveException(RenderRequest request,
RenderResponse 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 |
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)
|
void |
setRenderWhenMinimized(boolean renderWhenMinimized)
Set if the resolver should render a view when the portlet is in a minimized window. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String DEFAULT_EXCEPTION_ATTRIBUTE
protected final Log logger
Constructor Detail |
---|
public SimpleMappingExceptionResolver()
Method Detail |
---|
public void setOrder(int order)
public int getOrder()
Ordered
Normally starting with 0 or 1, with Ordered.LOWEST_PRECEDENCE
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).
Note that order values below 0 are reserved for framework purposes. Application-specified values should always be 0 or greater, with only framework components (internal or third-party) supposed to use lower values.
getOrder
in interface Ordered
Ordered.LOWEST_PRECEDENCE
public void setExceptionMappings(Properties mappings)
javax.portet.PortletException
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.
mappings
- exception patterns (can also be fully qualified class names)
as keys, and error view names as valuesRuleBasedTransactionAttribute
,
RollbackRuleAttribute
public void setDefaultErrorView(String defaultErrorView)
Default is none.
public void setMappedHandlers(Set mappedHandlers)
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.
public void setExceptionAttribute(String exceptionAttribute)
DEFAULT_EXCEPTION_ATTRIBUTE
public void setRenderWhenMinimized(boolean renderWhenMinimized)
PortletRequest.getWindowState()
,
WindowState.MINIMIZED
public ModelAndView resolveException(RenderRequest request, RenderResponse response, Object handler, Exception ex)
HandlerExceptionResolver
resolveException
in interface HandlerExceptionResolver
request
- current portlet requestresponse
- current portlet responsehandler
- 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
protected String findMatchingViewName(Properties exceptionMappings, Exception ex)
exceptionMappings
- mappings between exception class names and error view namesex
- the exception that got thrown during handler execution
null
if none foundsetExceptionMappings(java.util.Properties)
protected int getDepth(String exceptionMapping, Exception ex)
Follows the same algorithm as RollbackRuleAttribute.
RollbackRuleAttribute
protected ModelAndView getModelAndView(String viewName, Exception ex, RenderRequest request)
getModelAndView(viewName, ex)
.
viewName
- the name of the error viewex
- the exception that got thrown during handler executionrequest
- current portlet request (useful for obtaining metadata)
getModelAndView(String, Exception)
protected ModelAndView getModelAndView(String viewName, Exception ex)
viewName
- the name of the error viewex
- the exception that got thrown during handler execution
setExceptionAttribute(java.lang.String)
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |