de.ispsoft.jaxme.jaxb
Interface UnmarshallerHandler

All Superinterfaces:

org.xml.sax.ContentHandler

All Known Implementing Classes:

UnmarshallerHandlerImpl

Deprecated. Soon to be replaced with javax.xml.bind.UnmarshallerHandler

public interface UnmarshallerHandler

extends org.xml.sax.ContentHandler

Unmarshaller implemented as SAX ContentHandler.

TODO: This class needs better documentation. It is not intended to be used by novice JAXB users - it is a more advanced interface available for clients wishing to integrate their JAXB unmarshal into an XML pipeline.

Application can use this interface to use JAXB provider as a component in an XML pipeline.

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

Since:

JAXB1.0

Version:

$Revision: 1.3 $ $Date: 2003/05/21 03:30:18 $

Author:

• Kohsuke KAWAGUCHI, Sun Microsystems, Inc.

See Also:

Unmarshaller.getUnmarshallerHandler()

Method Summary

java.lang.Object

getResult() Deprecated. Obtains the unmarshalled result.

Methods inherited from interface org.xml.sax.ContentHandler

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

Method Detail

getResult

public java.lang.Object getResult()
                           throws JAXBException,
                                  java.lang.IllegalStateException

Deprecated.

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:

java.lang.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.