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

javax.xml.bind.util
Класс JAXBResult

java.lang.Object
  javax.xml.transform.sax.SAXResult
      javax.xml.bind.util.JAXBResult

Все Реализованные Интерфейсы:

javax.xml.transform. Результат

public class JAXBResult
расширяет javax.xml.transform.sax. SAXResult

JAXP Result реализация, которая неупорядочивает объект JAXB.

Эта утилита class полезна, чтобы объединить JAXB с другими технологиями Java/XML.

Следующий пример показывает, как использовать JAXB, чтобы неупорядочить документ, следующий из преобразования XSLT.

       JAXBResult result = new JAXBResult(
         JAXBContext.newInstance("org.acme.foo") );
       
       // set up XSLT transformation
       TransformerFactory tf = TransformerFactory.newInstance();
       Transformer t = tf.newTransformer(new StreamSource("test.xsl"));
       
       // run transformation
       t.transform(new StreamSource("document.xml"),result);
 
       // obtain the unmarshalled content tree
       Object o = result.getResult();
    

Фактом, что JAXBResult происходит из SAXResult, является деталь реализации. Таким образом в общих приложениях строго отговариваются получить доступ к методам, определенным на SAXResult.

В особенности это никогда не должно пытаться вызвать setHandler, setLexicalHandler, и setSystemId методы.

Автор:

Kohsuke Кавагути (kohsuke.kawaguchi@sun.com)

Полевая Сводка

Поля, наследованные от class javax.xml.transform.sax. SAXResult

FEATURE

Поля, наследованные от интерфейса javax.xml.transform. Результат

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

Сводка конструктора

JAXBResult(JAXBContext context)
Создает новый экземпляр, который использует указанный JAXBContext, чтобы неупорядочить.

JAXBResult(Unmarshaller _unmarshaller)
Создает новый экземпляр, который использует указанный Unmarshaller, чтобы неупорядочить объект.

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

java.lang.Object

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

Методы, наследованные от class javax.xml.transform.sax. SAXResult

getHandler, getLexicalHandler, getSystemId, setHandler, setLexicalHandler, setSystemId

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

JAXBResult

public JAXBResult(JAXBContext context)
           throws JAXBException

Создает новый экземпляр, который использует указанный JAXBContext, чтобы неупорядочить.

Параметры:

context - JAXBContext, который будет использоваться, чтобы создать необходимый Unmarshaller. Этот параметр не должен быть нулем.

Броски:

JAXBException - если с ошибкой встречаются, создавая JAXBResult или если параметр контекста является нулем.

JAXBResult

public JAXBResult(Unmarshaller _unmarshaller)
           throws JAXBException

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

Этот объект JAXBResult будет использовать указанный экземпляр Unmarshaller. Это - обязанность вызывающей стороны не использовать тот же самый Unmarshaller в других целях, в то время как это используется этим объектом.

Основная цель этого метода состоит в том, чтобы позволить клиенту конфигурировать Unmarshaller. Если Вы не знаете то, что Вы делаете, это легче и более безопасно передать JAXBContext.

Параметры:

_unmarshaller - unmarshaller. Этот параметр не должен быть нулем.

Броски:

JAXBException - если с ошибкой встречаются, создавая JAXBResult, или параметр Unmarshaller является нулем.

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

getResult

public java.lang.Object getResult()
                           throws JAXBException

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

Возвраты:

Всегда возвращайте ненулевой объект.

Броски:

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

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