|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Defines the approach for reporting errors that occur while parsing, validating or manipulating WSDL descriptions, such as XML parser errors or violations of the rules defined in the WSDL specification. That is, errors that relate specifically to the WSDL. It does not report system runtime or configuration errors, which are instead treated as exceptions.
There are four ways to report an error:
An error id and an array of message arguments are used to produce a formatted error message from some parameterized message text. The error may be reported with an target exception or without one.
An error id is specified with some ready-formatted message text. The error may be reported with an target exception or without one.
The error is handled according to the severity level (warning, error or fatal error) reported with the error.
The error reporter supports the 'en' (English) locale by default and has a default error handler (i.e. a default implementation of ErrorHandler). However, a different locale may be configured viasetLocale
and a custom error handler implementation
may be configured as a system property.
Field Summary | |
static short |
SEVERITY_ERROR
|
static short |
SEVERITY_FATAL_ERROR
|
static short |
SEVERITY_WARNING
|
Method Summary | |
ErrorHandler |
getErrorHandler()
Return the custom error handler if one has been set, otherwise return the default error handler. |
java.lang.String |
getFormattedMessage(java.lang.String errorId,
java.lang.Object[] arguments)
Returns a formatted message string for the specified message key and arguments. |
java.util.Locale |
getLocale()
|
void |
reportError(ErrorLocator errLoc,
java.lang.String errorId,
java.lang.Object[] arguments,
short severity)
Insert the message arguments into a parameterized message identified by errorId to produce a formatted error message, then report the message and the error location in the document according to the severity. |
void |
reportError(ErrorLocator errLoc,
java.lang.String errorId,
java.lang.Object[] arguments,
short severity,
java.lang.Exception exception)
Insert the message arguments into a parameterized message identified by errorId to produce a formatted error message, then report the message and the error location in the document according to the severity. |
void |
reportError(ErrorLocator errLoc,
java.lang.String errorId,
java.lang.String message,
short severity)
Report the message and the error location in the document according to the severity. |
void |
reportError(ErrorLocator errLoc,
java.lang.String errorId,
java.lang.String message,
short severity,
java.lang.Exception exception)
Report the message and the error location in the document according to the severity. |
void |
setErrorHandler(ErrorHandler errorHandler)
Set a custom error handler on this error reporter to replace the default error handler. |
void |
setLocale(java.util.Locale locale)
Set the Locale used for localization of error messages. |
Field Detail |
public static final short SEVERITY_WARNING
public static final short SEVERITY_ERROR
public static final short SEVERITY_FATAL_ERROR
Method Detail |
public void reportError(ErrorLocator errLoc, java.lang.String errorId, java.lang.Object[] arguments, short severity) throws WSDLException
errLoc
- ErrorLocator showing the location of the error in the document.errorId
- String that identifies the message for this error.arguments
- Object[] with values to be inserted into the message text.severity
- a short indicating warning, error or fatal error.
WSDLException
- if the severity is fatal errorpublic void reportError(ErrorLocator errLoc, java.lang.String errorId, java.lang.Object[] arguments, short severity, java.lang.Exception exception) throws WSDLException
errLoc
- ErrorLocator showing the location of the error in the document.errorId
- String that identifies the message for this error.arguments
- Object[] with values to be inserted into the message text.severity
- a short indicating warning, error or fatal error.exception
- the Exception that caused this error
WSDLException
- if the severity is fatal errorpublic void reportError(ErrorLocator errLoc, java.lang.String errorId, java.lang.String message, short severity) throws WSDLException
errLoc
- ErrorLocator showing the location of the error in the document.errorId
- String that identifies the message for this error.message
- message text.severity
- a short indicating warning, error or fatal error.
WSDLException
- if the severity is fatal errorpublic void reportError(ErrorLocator errLoc, java.lang.String errorId, java.lang.String message, short severity, java.lang.Exception exception) throws WSDLException
errLoc
- ErrorLocator showing the location of the error in the document.errorId
- String that identifies the message for this error.message
- message text.severity
- a short indicating warning, error or fatal error.exception
- the Exception that caused this error
WSDLException
- if the severity is fatal errorpublic void setErrorHandler(ErrorHandler errorHandler)
errorHandler
- the custom error handlerpublic ErrorHandler getErrorHandler()
public void setLocale(java.util.Locale locale)
locale
- the required localepublic java.util.Locale getLocale()
public java.lang.String getFormattedMessage(java.lang.String errorId, java.lang.Object[] arguments)
errorId
- a String representing the message keyarguments
- an Object array of message parameters
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |