|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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??")
Nested Class Summary | |
---|---|
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 | |
---|---|
boolean |
getThrowExceptionOnMissingResource()
Deprecated. use IResourceSettings.getThrowExceptionOnMissingResource() instead |
IExceptionSettings.UnexpectedExceptionDisplay |
getUnexpectedExceptionDisplay()
|
void |
setThrowExceptionOnMissingResource(boolean throwExceptionOnMissingResource)
Deprecated. use IResourceSettings.setThrowExceptionOnMissingResource(boolean) instead |
void |
setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay)
The exception display type determines how the framework displays exceptions to you as a developer or user. |
Field Detail |
---|
static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_EXCEPTION_PAGE
static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_INTERNAL_ERROR_PAGE
static final IExceptionSettings.UnexpectedExceptionDisplay SHOW_NO_EXCEPTION_PAGE
Method Detail |
---|
boolean getThrowExceptionOnMissingResource()
IResourceSettings.getThrowExceptionOnMissingResource()
instead
IExceptionSettings.UnexpectedExceptionDisplay getUnexpectedExceptionDisplay()
void setThrowExceptionOnMissingResource(boolean throwExceptionOnMissingResource)
IResourceSettings.setThrowExceptionOnMissingResource(boolean)
instead
throwExceptionOnMissingResource
- Whether to throw an exception when a missing resource is requestedvoid setUnexpectedExceptionDisplay(IExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay)
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.
unexpectedExceptionDisplay
- The unexpectedExceptionDisplay to set.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |