Module org.apache.wicket.core

Package org.apache.wicket

Class DefaultExceptionMapper

java.lang.Object

org.apache.wicket.DefaultExceptionMapper

All Implemented Interfaces:

IExceptionMapper

public class DefaultExceptionMapper
extends Object
implements IExceptionMapper

If an exception is thrown when a page is being rendered this mapper will decide which error page to show depending on the exception type and application configuration

Constructor Summary

Constructors

Constructor	Description
DefaultExceptionMapper()

Method Summary

Modifier and Type	Method	Description
protected RenderPageRequestHandler	createPageRequestHandler(PageProvider pageProvider)	Creates a RenderPageRequestHandler for the target page provided by pageProvider.
protected Page	extractCurrentPage()
protected IRequestHandler	handleNestedException(Exception originalException, RuntimeException nestedException)	Handles the case when an exception is generated while mapping the original exception happened
protected boolean	isProcessingAjaxRequest()
IRequestHandler	map(Exception e)
protected IRequestHandler	mapExpectedExceptions(Exception e, Application application)	Maps expected exceptions (i.e.
protected IRequestHandler	mapUnexpectedExceptions(Exception e, Application application)	Maps unexpected exceptions to their corresponding IRequestHandler.

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultExceptionMapper

public DefaultExceptionMapper()

Method Details

map

public IRequestHandler map(Exception e)

Specified by:

map in interface IExceptionMapper

Returns:

IRequestHandler for given exception

handleNestedException

protected IRequestHandler handleNestedException(Exception originalException,
 RuntimeException nestedException)

Handles the case when an exception is generated while mapping the original exception happened

Parameters:

originalException - The original exception.

nestedException - The nested (second) exception produced

Returns:

IRequestHandler (by default ErrorCodeRequestHandler

mapExpectedExceptions

protected IRequestHandler mapExpectedExceptions(Exception e,
 Application application)

Maps expected exceptions (i.e. those internally used by Wicket) to their corresponding IRequestHandler.

Parameters:

e - the current exception

application - the current application object

Returns:

the IRequestHandler for the current exception

mapUnexpectedExceptions

protected IRequestHandler mapUnexpectedExceptions(Exception e,
 Application application)

Maps unexpected exceptions to their corresponding IRequestHandler.

Parameters:

e - the current exception

application - the current application object

Returns:

the IRequestHandler for the current exception

createPageRequestHandler

protected RenderPageRequestHandler createPageRequestHandler(PageProvider pageProvider)

Creates a RenderPageRequestHandler for the target page provided by pageProvider.

Uses RenderPageRequestHandler.RedirectPolicy.NEVER_REDIRECT policy to preserve the original page's URL for non-Ajax requests and RenderPageRequestHandler.RedirectPolicy.AUTO_REDIRECT for AJAX requests.

Parameters:

pageProvider - the page provider for the target page

Returns:

the request handler for the target page

isProcessingAjaxRequest

protected boolean isProcessingAjaxRequest()

Returns:

true if current request is an AJAX request, false otherwise.

extractCurrentPage

protected Page extractCurrentPage()

Returns:

the page being rendered when the exception was thrown, or null if it cannot be extracted