|
||||||||||
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.AjaxErrorStrategy
How to handle errors while processing an Ajax request |
static class |
IExceptionSettings.ThreadDumpStrategy
Which threads' stacktrace to dump when a page lock timeout occurs |
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.ThreadDumpStrategy |
getThreadDumpStrategy()
|
IExceptionSettings.UnexpectedExceptionDisplay |
getUnexpectedExceptionDisplay()
|
void |
setAjaxErrorHandlingStrategy(IExceptionSettings.AjaxErrorStrategy strategy)
Sets strategy used to handle errors during Ajax request processing |
void |
setThreadDumpStrategy(IExceptionSettings.ThreadDumpStrategy strategy)
Sets the strategy to use for dumping stack traces of live threads in the JVM. |
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 |
---|
IExceptionSettings.UnexpectedExceptionDisplay getUnexpectedExceptionDisplay()
void 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.void setAjaxErrorHandlingStrategy(IExceptionSettings.AjaxErrorStrategy strategy)
strategy
- IExceptionSettings.AjaxErrorStrategy getAjaxErrorHandlingStrategy()
void setThreadDumpStrategy(IExceptionSettings.ThreadDumpStrategy strategy)
strategy
- IExceptionSettings.ThreadDumpStrategy getThreadDumpStrategy()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |