javax.xml.bind.helpers

Class AbstractUnmarshallerImpl

java.lang.Object

javax.xml.bind.helpers.AbstractUnmarshallerImpl

All Implemented Interfaces:

Unmarshaller

public abstract class AbstractUnmarshallerImpl
extends Object
implements Unmarshaller

Partial default Unmarshaller implementation.

This class provides a partial default implementation for the Unmarshallerinterface.

A JAXB Provider has to implement five methods (getUnmarshallerHandler, unmarshal(Node), unmarshal(XMLReader,InputSource), unmarshal(XMLStreamReader), and unmarshal(XMLEventReader).

Since:

JAXB1.0

See Also:

Unmarshaller

Nested Class Summary

Nested classes/interfaces inherited from interface javax.xml.bind.Unmarshaller

Unmarshaller.Listener

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	validating whether or not the unmarshaller will validate

Constructor Summary

Constructors

Constructor and Description
AbstractUnmarshallerImpl()

Method Summary

Methods

Modifier and Type	Method and Description
protected UnmarshalException	createUnmarshalException(SAXException e) Creates an UnmarshalException from a SAXException.
<A extends XmlAdapter> A	getAdapter(Class<A> type) Gets the adapter associated with the specified type.
AttachmentUnmarshaller	getAttachmentUnmarshaller()
ValidationEventHandler	getEventHandler() Return the current event handler or the default event handler if one hasn't been set.
Unmarshaller.Listener	getListener() Return Unmarshaller.Listener registered with this Unmarshaller.
Object	getProperty(String name) Default implementation of the getProperty method always throws PropertyException since there are no required properties.
Schema	getSchema() Get the JAXP 1.3 Schema object being used to perform unmarshal-time validation.
protected XMLReader	getXMLReader() Obtains a configured XMLReader.
boolean	isValidating() Indicates whether or not the Unmarshaller is configured to validate during unmarshal operations.
<A extends XmlAdapter> void	setAdapter(Class<A> type, A adapter) Associates a configured instance of XmlAdapter with this unmarshaller.
void	setAdapter(XmlAdapter adapter) Associates a configured instance of XmlAdapter with this unmarshaller.
void	setAttachmentUnmarshaller(AttachmentUnmarshaller au) Associate a context that resolves cid's, content-id URIs, to binary data passed as attachments.
void	setEventHandler(ValidationEventHandler handler) Allow an application to register a validation event handler.
void	setListener(Unmarshaller.Listener listener) Register unmarshal event callback Unmarshaller.Listener with this Unmarshaller.
void	setProperty(String name, Object value) Default implementation of the setProperty method always throws PropertyException since there are no required properties.
void	setSchema(Schema schema) Specify the JAXP 1.3 Schema object that should be used to validate subsequent unmarshal operations against.
void	setValidating(boolean validating) Specifies whether or not the Unmarshaller should validate during unmarshal operations.
Object	unmarshal(File f) Unmarshal XML data from the specified file and return the resulting content tree.
Object	unmarshal(InputSource source) Unmarshal XML data from the specified SAX InputSource and return the resulting content tree.
Object	unmarshal(InputStream is) Unmarshal XML data from the specified InputStream and return the resulting content tree.
<T> JAXBElement<T>	unmarshal(Node node, Class<T> expectedType) Unmarshal XML data by JAXB mapped declaredType and return the resulting content tree.
Object	unmarshal(Reader reader) Unmarshal XML data from the specified Reader and return the resulting content tree.
Object	unmarshal(Source source) Unmarshal XML data from the specified XML Source and return the resulting content tree.
<T> JAXBElement<T>	unmarshal(Source source, Class<T> expectedType) Unmarshal XML data from the specified XML Source by declaredType and return the resulting content tree.
Object	unmarshal(URL url) Unmarshal XML data from the specified URL and return the resulting content tree.
Object	unmarshal(XMLEventReader reader) Unmarshal XML data from the specified pull parser and return the resulting content tree.
<T> JAXBElement<T>	unmarshal(XMLEventReader reader, Class<T> expectedType) Unmarshal root element to JAXB mapped declaredType and return the resulting content tree.
protected abstract Object	unmarshal(XMLReader reader, InputSource source) Unmarshals an object by using the specified XMLReader and the InputSource.
Object	unmarshal(XMLStreamReader reader) Unmarshal XML data from the specified pull parser and return the resulting content tree.
<T> JAXBElement<T>	unmarshal(XMLStreamReader reader, Class<T> expectedType) Unmarshal root element to JAXB mapped declaredType and return the resulting content tree.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.xml.bind.Unmarshaller

getUnmarshallerHandler, unmarshal

Field Detail

validating

protected boolean validating

whether or not the unmarshaller will validate

Constructor Detail

AbstractUnmarshallerImpl

public AbstractUnmarshallerImpl()

Method Detail

getXMLReader

protected XMLReader getXMLReader()
                          throws JAXBException

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.

Throws:

JAXBException

unmarshal

public Object unmarshal(Source source)
                 throws JAXBException

Description copied from interface: Unmarshaller

Unmarshal XML data from the specified XML Source and return the resulting content tree.

Implements Unmarshal Global Root Element.

SAX 2.0 Parser Pluggability

A client application can choose not to use the default parser mechanism supplied with their JAXB provider. Any SAX 2.0 compliant parser can be substituted for the JAXB provider's default mechanism. To do so, the client application must properly configure a SAXSource containing an XMLReader implemented by the SAX 2.0 parser provider. If the XMLReader has an org.xml.sax.ErrorHandler registered on it, it will be replaced by the JAXB Provider so that validation errors can be reported via the ValidationEventHandler mechanism of JAXB. If the SAXSource does not contain an XMLReader, then the JAXB provider's default parser mechanism will be used.

This parser replacement mechanism can also be used to replace the JAXB provider's unmarshal-time validation engine. The client application must properly configure their SAX 2.0 compliant parser to perform validation (as shown in the example above). Any SAXParserExceptions encountered by the parser during the unmarshal operation will be processed by the JAXB provider and converted into JAXB ValidationEvent objects which will be reported back to the client via the ValidationEventHandler registered with the Unmarshaller. Note: specifying a substitute validating SAX 2.0 parser for unmarshalling does not necessarily replace the validation engine used by the JAXB provider for performing on-demand validation.

The only way for a client application to specify an alternate parser mechanism to be used during unmarshal is via the unmarshal(SAXSource) API. All other forms of the unmarshal method (File, URL, Node, etc) will use the JAXB provider's default parser and validator mechanisms.

Specified by:

unmarshal in interface Unmarshaller

Parameters:

source - the XML Source to unmarshal XML data from (providers are only required to support SAXSource, DOMSource, and StreamSource)

Returns:

the newly created root object of the java content tree

Throws:

JAXBException - If any unexpected errors occur while unmarshalling

UnmarshalException - If the