Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind
Интерфейс UnmarshallerHandler

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

org.xml.sax. ContentHandler

public interface UnmarshallerHandler
расширяет org.xml.sax. 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

Автор:

• Kohsuke КАВАГУТИ, Sun Microsystems, Inc.

См. Также:

Unmarshaller#getUnmarshallerHandler()

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

java.lang.Object

getResult() Получает неупорядоченный результат.

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

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

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

getResult

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

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

Возвраты:

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

Броски:

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

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