javax.xml.bind

Интерфейс UnmarshallerHandler

Все Суперинтерфейсы:

ContentHandler

public interface UnmarshallerHandler
extends ContentHandler

Анмэршаллер реализовывал как 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();
 

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

С тех пор:

JAXB1.0

См. Также:

Unmarshaller.getUnmarshallerHandler()

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	getResult() Получает неупорядоченный результат.

Методы, наследованные от интерфейса org.xml.sax. ContentHandler

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

Деталь метода

getResult

Object getResult()
          throws JAXBException,
                 IllegalStateException

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

Возвраты:

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

Броски:

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

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