Package jakarta.xml.bind

Interface UnmarshallerHandler

All Superinterfaces:

ContentHandler

All Known Implementing Classes:

SAXConnector

public interface UnmarshallerHandler
extends ContentHandler

Unmarshaller implemented as SAX ContentHandler.

Applications can use this interface to use their Jakarta XML Binding provider as a component in an XML pipeline. For example:

This interface is reusable: even if the user fails to unmarshal an object, s/he can still start a new round of unmarshalling.

Since:

1.6, JAXB 1.0

Author:

• Kohsuke KAWAGUCHI, Sun Microsystems, Inc.

See Also:

• Unmarshaller.getUnmarshallerHandler()

Method Summary

Modifier and Type	Method	Description
Object	getResult()	Obtains the unmarshalled result.

Methods inherited from interface org.xml.sax.ContentHandler

characters, declaration, endDocument, endElement, endPrefixMapping, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping

Method Details

getResult

Object getResult()
          throws JAXBException,
IllegalStateException

Obtains the unmarshalled result.

This method can be called only after this handler receives the endDocument SAX event.

Returns:

always return a non-null valid object which was unmarshalled.

Throws:

IllegalStateException - if this method is called before this handler receives the endDocument event.

JAXBException - if there is any unmarshalling error. Note that the implementation is allowed to throw SAXException during the parsing when it finds an error.