javax.xml.bind
接口 UnmarshallerHandler

所有超级接口：

ContentHandler

public interface UnmarshallerHandler
     

      extends 
      ContentHandler
     

作为 SAX ContentHandler 实现的 Unmarshaller。

应用程序可以使用此接口将其 JAXB 提供者用作 XML 管线中的一个组件。例如：

JAXBContext context = JAXBContext.newInstance( "org.acme.foo" );

Unmarshaller unmarshaller = context.createUnmarshaller();
 
UnmarshallerHandler unmarshallerHandler = unmarshaller.getUnmarshallerHandler();

SAXParserFactory spf = SAXParserFactory.newInstance();
spf.setNamespaceAware( true );
 
XMLReader xmlReader = spf.newSAXParser().getXMLReader();
xmlReader.setContentHandler( unmarshallerHandler );
xmlReader.parse(new InputSource( new FileInputStream( XML_FILE ) ) );

MyObject myObject= (MyObject)unmarshallerHandler.getResult();                          
 

此接口是可重用的：即使用户解组某一对象时失败，她/他仍可开始新一轮的解组。

从以下版本开始：

JAXB1.0

另请参见：

Unmarshaller.getUnmarshallerHandler()

getResult

Object getResult()
                 throws JAXBException,
                        IllegalStateException

获得解组的结果。此方法只能在此处理程序接收 endDocument SAX 事件之后调用。

返回：

总是返回被解组的非 null 有效对象。

抛出：

IllegalStateException - 如果在此处理程序接收 endDocument 事件之前调用此方法。

JAXBException - 如果出现任何解组错误。注意，允许该实现在解析错误期间抛出 SAXException。