javax.xml.bind
Interface ValidationEvent

All Known Subinterfaces:
NotIdentifiableEvent, ParseConversionEvent, PrintConversionEvent
All Known Implementing Classes:
NotIdentifiableEventImpl, ParseConversionEventImpl, PrintConversionEventImpl, ValidationEventImpl, ValidationEventImpl

public interface ValidationEvent

An instance of ValidationEvent indicates some error condition, which occurred when validating a JAXB object. The purpose of the ValidationEventHandler is to customize the reply on instances of ValidationEvent. The default event handler will throw an exception in case of events, but application specific validation event handlers need not do the same.

Since:
JAXB1.0
Author:
JSR-31
See Also:
Validator, ValidationEventHandler

Field Summary
static int ERROR
          This value indicates an "error", as specified by section 1.2 of the W3C XML 1.0 Recommendation.
static int FATAL_ERROR
          This value indicates a "fatal error", as specified by section 1.2 of the W3C XML 1.0 Recommendation.
static int WARNING
          In contrast to errors or fatal errors, this indicates an event which can possibly be ignored.
 
Method Summary
 java.lang.Throwable getLinkedException()
          Returns a Throwable related to the event.
 ValidationEventLocator getLocator()
          Returns a description of the location, where the event occurred.
 java.lang.String getMessage()
          Returns a textual description of the event.
 int getSeverity()
          Returns the events severity: Either of WARNING, ERROR, or FATAL_ERROR.
 

Field Detail

WARNING

static final int WARNING

In contrast to errors or fatal errors, this indicates an event which can possibly be ignored. This constant has the value 0. See section 1.2 of the W3C XML 1.0 Recommendation for details.

See Also:
ERROR, FATAL_ERROR, getSeverity(), Constant Field Values

ERROR

static final int ERROR

This value indicates an "error", as specified by section 1.2 of the W3C XML 1.0 Recommendation. The constant value is 1.

See Also:
WARNING, FATAL_ERROR, getSeverity(), Constant Field Values

FATAL_ERROR

static final int FATAL_ERROR

This value indicates a "fatal error", as specified by section 1.2 of the W3C XML 1.0 Recommendation. The constant value is 2.

See Also:
WARNING, ERROR, getSeverity(), Constant Field Values
Method Detail

getSeverity

int getSeverity()

Returns the events severity: Either of WARNING, ERROR, or FATAL_ERROR.

Returns:
Returns the events severity.

getMessage

java.lang.String getMessage()

Returns a textual description of the event.


getLinkedException

java.lang.Throwable getLinkedException()

Returns a Throwable related to the event. In most cases an exception causing the event.


getLocator

ValidationEventLocator getLocator()

Returns a description of the location, where the event occurred.