javax.xml.bind.util
類別 JAXBResult

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

所有已實作的介面：

Result

public class JAXBResult
extends SAXResult

解組 JAXB 物件的 JAXP Result 實作。

此實用工具類別對於將 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();
    

SAXResult 派生於 JAXBResult 是一個實作細節。因此，通常應用程序最好不要存取 SAXResult 上定義的方法。

尤其不能嘗試調用 setHandler、setLexicalHandler 和 setSystemId 方法。

欄位摘要

從類別 javax.xml.transform.sax.SAXResult 繼承的欄位

FEATURE

從介面 javax.xml.transform.Result 繼承的欄位

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

建構子摘要

JAXBResult(JAXBContext context)
創建一個使用指定 JAXBContext 來解組的新實例。

JAXBResult(Unmarshaller _unmarshaller)
創建一個使用指定 Unmarshaller 來解組物件的新實例。

方法摘要

Object

getResult() 獲取通過轉換創建的已解組物件。

從類別 javax.xml.transform.sax.SAXResult 繼承的方法

getHandler, getLexicalHandler, getSystemId, setHandler, setLexicalHandler, setSystemId

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

JAXBResult

public JAXBResult(JAXBContext context)
           throws JAXBException

創建一個使用指定 JAXBContext 來解組的新實例。

參數：

context - 用於創建必需的 Unmarshaller 的 JAXBContext。此參數不能為 null。

拋出：

JAXBException - 如果創建 JAXBResult 時發生錯誤，或者上下文參數為 null。

JAXBResult

public JAXBResult(Unmarshaller _unmarshaller)
           throws JAXBException

創建一個使用指定 Unmarshaller 來解組物件的新實例。

此 JAXBResult 物件將使用指定的 Unmarshaller 實例。在此物件使用某個 Unmarshaller 時，調用者負責保證該 Unmarshaller 不做其他用途。

此方法的主要目的是允許客戶端配置 Unmarshaller。如果不知道操作的後果，更容易也更安全的方式是傳遞 JAXBContext。

參數：

_unmarshaller - Unmarshaller。此參數不得為 null。

拋出：

JAXBException - 如果創建 JAXBResult 時遇到錯誤，或者 Unmarshaller 參數為 null。

方法詳細資訊

getResult

public Object getResult()
                 throws JAXBException

獲取通過轉換創建的已解組物件。

返回：

總是返回非 null 物件。

拋出：

IllegalStateException - 如果在解組物件前調用此方法。

JAXBException - 如果發生解組錯誤。注意，允許實作在解析錯誤期間拋出 SAXException。