org.apache.wicket.settings
Interface IExceptionSettings

All Known Implementing Classes:

ExceptionSettings

public interface IExceptionSettings

Settings interface for configuring exception handling related settings.

unexpectedExceptionDisplay (defaults to SHOW_EXCEPTION_PAGE) - Determines how exceptions are displayed to the developer or user

throwExceptionOnMissingResource (defaults to true) - Set to true to throw a runtime exception if a required string resource is not found. Set to false to return the requested resource key surrounded by pairs of question mark characters (e.g. "??missingKey??")

Author:

Igor Vaynberg (ivaynberg)

Nested Class Summary

static class	IExceptionSettings.AjaxErrorStrategy How to handle errors while processing an Ajax request
static class	IExceptionSettings.UnexpectedExceptionDisplay Enumerated type for different ways of displaying unexpected exceptions.

Field Summary

static IExceptionSettings.UnexpectedExceptionDisplay	SHOW_EXCEPTION_PAGE Indicates that an exception page appropriate to development should be shown when an unexpected exception is thrown.
static IExceptionSettings.UnexpectedExceptionDisplay	SHOW_INTERNAL_ERROR_PAGE Indicates a generic internal error page should be shown when an unexpected exception is thrown.
static IExceptionSettings.UnexpectedExceptionDisplay	SHOW_NO_EXCEPTION_PAGE Indicates that no exception page should be shown when an unexpected exception is thrown.

Method Summary

IExceptionSettings.AjaxErrorStrategy	getAjaxErrorHandlingStrategy()
IExceptionSettings.UnexpectedExceptionDisplay	getUnexpectedExceptionDisplay()
void	setAjaxErrorHandlingStrategy(IExceptionSettings.AjaxErrorStrategy strategy) Sets strategy used to handle errors during Ajax request processing
void	setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay) The exception display type determines how the framework displays exceptions to you as a developer or user.

Field Detail

SHOW_EXCEPTION_PAGE

static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_EXCEPTION_PAGE

Indicates that an exception page appropriate to development should be shown when an unexpected exception is thrown.

SHOW_INTERNAL_ERROR_PAGE

static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_INTERNAL_ERROR_PAGE

Indicates a generic internal error page should be shown when an unexpected exception is thrown.

SHOW_NO_EXCEPTION_PAGE

static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_NO_EXCEPTION_PAGE

Indicates that no exception page should be shown when an unexpected exception is thrown.

Method Detail

getUnexpectedExceptionDisplay

IExceptionSettings.UnexpectedExceptionDisplay getUnexpectedExceptionDisplay()

Returns:

Returns the unexpectedExceptionDisplay.

setUnexpectedExceptionDisplay

void setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay)

The exception display type determines how the framework displays exceptions to you as a developer or user.

The default value for exception display type is SHOW_EXCEPTION_PAGE. When this value is set and an unhandled runtime exception is thrown by a page, a redirect to a helpful exception display page will occur.

This is a developer feature, however, and you may want to instead show an internal error page without developer details that allows a user to start over at the application's home page. This can be accomplished by setting the exception display type to SHOW_INTERNAL_ERROR_PAGE.

Finally, if you are having trouble with the exception display pages themselves, you can disable exception displaying entirely with the value SHOW_NO_EXCEPTION_PAGE. This will cause the framework to re-throw any unhandled runtime exceptions after wrapping them in a ServletException wrapper.

Parameters:

unexpectedExceptionDisplay - The unexpectedExceptionDisplay to set.

setAjaxErrorHandlingStrategy

void setAjaxErrorHandlingStrategy(IExceptionSettings.AjaxErrorStrategy strategy)

Sets strategy used to handle errors during Ajax request processing

Parameters:

strategy -

getAjaxErrorHandlingStrategy

IExceptionSettings.AjaxErrorStrategy getAjaxErrorHandlingStrategy()

Returns:

strategy used to handle errors during Ajax request processing