Creates an UnmarshalException from a SAXException.

  Creates an UnmarshalException from a SAXException. This is an utility method provided for the derived classes.

When a provider-implemented ContentHandler wants to throw a JAXBException, it needs to wrap the exception by a SAXException. If the unmarshaller implementation blindly wrap SAXException by JAXBException, such an exception will be a JAXBException wrapped by a SAXException wrapped by another JAXBException. This is silly.

This method checks the nested exception of SAXException and reduce those excessive wrapping.
Returns: the resulting UnmarshalException

  Return the current event handler or the default event handler if one hasn't been set.

  Return the current event handler or the default event handler if one
hasn't been set.
Returns: the current ValidationEventHandler or the default event handler if it hasn't been set
Throws:
- JAXBException - if an error was encountered while getting the current event handler

  Default implementation of the getProperty method always throws PropertyException since there are no required properties.

  Default implementation of the getProperty method always
throws PropertyException since there are no required
properties. If a provider needs to handle additional
properties, it should override this method in a derived class.

  Obtains a configured XMLReader.

  Obtains a configured XMLReader.

This method is used when the client-specified
SAXSource object doesn't have XMLReader.

Unmarshaller is not re-entrant, so we will
only use one instance of XMLReader.

  Indicates whether or not the Unmarshaller is configured to validate during unmarshal operations.

  Indicates whether or not the Unmarshaller is configured to validate during unmarshal operations.

Note: I named this method isValidating() to stay in-line with JAXP, as opposed to naming it getValidating().
Returns: true if the Unmarshaller is configured to validate during unmarshal operations, false otherwise
Throws:
- JAXBException - if an error occurs while retrieving the validating flag

  Allow an application to register a validation event handler.

  Allow an application to register a validation event handler.

The validation event handler will be called by the JAXB Provider if any validation errors are encountered during calls to any of the unmarshal methods. If the client application does not register a validation event handler before invoking the unmarshal methods, then all validation events will be silently ignored and may result in unexpected behaviour.
Parameters:
- handler - the validation event handler
Throws:
- JAXBException - if an error was encountered while setting the event handler

  Default implementation of the setProperty method always throws PropertyException since there are no required properties.

  Default implementation of the setProperty method always
throws PropertyException since there are no required
properties. If a provider needs to handle additional
properties, it should override this method in a derived class.

  Specifies whether or not the Unmarshaller should validate during unmarshal operations.

  Specifies whether or not the Unmarshaller should validate during unmarshal operations. By default, the Unmarshaller does not validate.

This method may only be invoked before or after calling one of the unmarshal methods.
Parameters:
- validating - true if the Unmarshaller should validate during unmarshal, false otherwise
Throws:
- JAXBException - if an error occurred while enabling or disabling validation at unmarshal time

  Unmarshals an object by using the specified XMLReader and the InputSource.

  Unmarshals an object by using the specified XMLReader and the InputSource.

The callee should call the setErrorHandler method of the XMLReader
so that errors are passed to the client-specified ValidationEventHandler.