public class ExceptionSettings extends Object
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??")
Modifier and Type | Class and Description |
---|---|
static class |
ExceptionSettings.AjaxErrorStrategy
How to handle errors while processing an Ajax request
|
static class |
ExceptionSettings.ThreadDumpStrategy
Which threads' stacktrace to dump when a page lock timeout occurs
|
static class |
ExceptionSettings.UnexpectedExceptionDisplay
Enumerated type for different ways of displaying unexpected exceptions.
|
Modifier and Type | Field and Description |
---|---|
static ExceptionSettings.UnexpectedExceptionDisplay |
SHOW_EXCEPTION_PAGE
Indicates that an exception page appropriate to development should be shown when an
unexpected exception is thrown.
|
static ExceptionSettings.UnexpectedExceptionDisplay |
SHOW_INTERNAL_ERROR_PAGE
Indicates a generic internal error page should be shown when an unexpected exception is
thrown.
|
static ExceptionSettings.UnexpectedExceptionDisplay |
SHOW_NO_EXCEPTION_PAGE
Indicates that no exception page should be shown when an unexpected exception is thrown.
|
Constructor and Description |
---|
ExceptionSettings() |
Modifier and Type | Method and Description |
---|---|
ExceptionSettings.AjaxErrorStrategy |
getAjaxErrorHandlingStrategy() |
ExceptionSettings.ThreadDumpStrategy |
getThreadDumpStrategy() |
ExceptionSettings.UnexpectedExceptionDisplay |
getUnexpectedExceptionDisplay() |
ExceptionSettings |
setAjaxErrorHandlingStrategy(ExceptionSettings.AjaxErrorStrategy errorHandlingStrategyDuringAjaxRequests)
Sets strategy used to handle errors during Ajax request processing
|
ExceptionSettings |
setThreadDumpStrategy(ExceptionSettings.ThreadDumpStrategy strategy)
Sets the strategy to use for dumping stack traces of live threads in the JVM.
|
ExceptionSettings |
setUnexpectedExceptionDisplay(ExceptionSettings.UnexpectedExceptionDisplay unexpectedExceptionDisplay)
The exception display type determines how the framework displays exceptions to you as a
developer or user.
|
public static final ExceptionSettings.UnexpectedExceptionDisplay SHOW_EXCEPTION_PAGE
public static final ExceptionSettings.UnexpectedExceptionDisplay SHOW_INTERNAL_ERROR_PAGE
public static final ExceptionSettings.UnexpectedExceptionDisplay SHOW_NO_EXCEPTION_PAGE
public ExceptionSettings.UnexpectedExceptionDisplay getUnexpectedExceptionDisplay()
public ExceptionSettings setUnexpectedExceptionDisplay(ExceptionSettings.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.this
object for chainingpublic ExceptionSettings.AjaxErrorStrategy getAjaxErrorHandlingStrategy()
public ExceptionSettings setAjaxErrorHandlingStrategy(ExceptionSettings.AjaxErrorStrategy errorHandlingStrategyDuringAjaxRequests)
errorHandlingStrategyDuringAjaxRequests
- this
object for chainingpublic ExceptionSettings setThreadDumpStrategy(ExceptionSettings.ThreadDumpStrategy strategy)
strategy
- this
object for chainingpublic ExceptionSettings.ThreadDumpStrategy getThreadDumpStrategy()
Copyright © 2006–2014 Apache Software Foundation. All rights reserved.