wicket.settings
Interface IExceptionSettings

All Known Implementing Classes:

Settings

Deprecated. will be removed in 2.0. See methods for details

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.UnexpectedExceptionDisplay Deprecated. will be moved to IApplicationSettings in 2.0

Field Summary

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

Method Summary

boolean	getThrowExceptionOnMissingResource() Deprecated. use IResourceSettings.getThrowExceptionOnMissingResource() instead
IExceptionSettings.UnexpectedExceptionDisplay	getUnexpectedExceptionDisplay() Deprecated. will be moved to IApplicationSettings in 2.0
void	setThrowExceptionOnMissingResource(boolean throwExceptionOnMissingResource) Deprecated. use IResourceSettings.setThrowExceptionOnMissingResource(boolean) instead
void	setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay) Deprecated. will be moved to IApplicationSettings in 2.0

Field Detail

SHOW_EXCEPTION_PAGE

static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_EXCEPTION_PAGE

Deprecated.

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

Deprecated.

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

Deprecated.

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

Method Detail

getThrowExceptionOnMissingResource

boolean getThrowExceptionOnMissingResource()

Deprecated. use IResourceSettings.getThrowExceptionOnMissingResource() instead

Returns:

Whether to throw an exception when a missing resource is requested

getUnexpectedExceptionDisplay

IExceptionSettings.UnexpectedExceptionDisplay getUnexpectedExceptionDisplay()

Deprecated. will be moved to IApplicationSettings in 2.0

Returns:

Returns the unexpectedExceptionDisplay.

setThrowExceptionOnMissingResource

void setThrowExceptionOnMissingResource(boolean throwExceptionOnMissingResource)

Deprecated. use IResourceSettings.setThrowExceptionOnMissingResource(boolean) instead

Parameters:

throwExceptionOnMissingResource - Whether to throw an exception when a missing resource is requested

setUnexpectedExceptionDisplay

void setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay)

Deprecated. will be moved to IApplicationSettings in 2.0

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.