Интерфейс UnmarshallerHandler

public interface UnmarshallerHandler
extends ContentHandler

Реализация Unmarshaller как SAX ContentHandler.

Приложения могут использовать этот интерфейс для использования своего поставщика 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();

Этот интерфейс многократно используемый: даже если пользователь не смог разархивировать объект, он всё равно может начать новый раунд разархивирования.

Методы

getResult

Object getResult()
          throws JAXBException,
                 IllegalStateException

Получение разархивированного результата. Этот метод может быть вызван только после того, как этот обработчик получит событие SAX endDocument.

Возвращает:

всегда возвращает непустой действительный объект, который был разархивирован.

Исключения:

IllegalStateException - если этот метод вызывается до того, как этот обработчик получит событие endDocument.

JAXBException - если возникла ошибка разархивирования. Обратите внимание, что реализация разрешена для выброса SAXException во время разбора, когда она обнаруживает ошибку.