軟體套件 javax.xml.soap

提供用於創建和建構 SOAP 訊息的 API。

請參見：
描述

介面摘要

Detail	DetailEntry 物件的容器。
DetailEntry	Detail 物件的內容，給出 SOAPFault 物件的詳細資訊。
Name	XML 名稱的表示形式。
Node	XML 文檔中節點（元素）的表示形式。
SOAPBody	表示 SOAP 訊息中 SOAP 正文元素內容的物件。
SOAPBodyElement	表示 SOAPBody 物件中內容的 SOAPBodyElement 物件。
SOAPConstants	與 SOAP 協議有關的常數的定義。
SOAPElement	表示 SOAP 規範允許使用但未特別規定的 SOAP 訊息元素的物件。
SOAPEnvelope	SOAPPart 物件的 SOAPHeader 和 SOAPBody 部分的容器。
SOAPFault	SOAPBody 物件中的元素，包含錯誤和/或狀態資訊。
SOAPFaultElement	SOAPFault 物件內容的表示形式。
SOAPHeader	SOAP 頭元素的表示形式。
SOAPHeaderElement	表示 SOAP 信封 SOAP 頭部分的內容的物件。
Text	值為文本的節點的表示形式。

類別摘要

AttachmentPart	SOAPMessage 物件的一個附件。
MessageFactory	創建 SOAPMessage 物件的處理器。
MimeHeader	存儲 MIME 頭名稱及其值的物件。
MimeHeaders	MimeHeader 物件的容器，這些物件表示出現在訊息的 MIME 部分的 MIME 頭。
SAAJMetaFactory	SAAJ API 中定義的處理器實作類別的存取點。
SAAJResult	以 SAAJ 階層樹的形式，充當 JAXP 轉換或 JAXB 編組結果的持有者。
SOAPConnection	客戶端可以用於直接將訊息發送到（例如，用 URL 表示的）遠端方的點對點連接。
SOAPConnectionFactory	創建 SOAPConnection 物件的處理器。
SOAPElementFactory	已過時。 - 使用 javax.xml.soap.SOAPFactory 創建 SOAPElements。
SOAPFactory	SOAPFactory 是用來創建存在於 SOAP XML 階層樹中的各種物件的處理器。
SOAPMessage	所有 SOAP 訊息的根類別。
SOAPPart	SOAPMessage 物件中特定於 SOAP 部分的容器。

異常摘要

SOAPException

當發生 SOAP 異常時，拋出此異常。

軟體套件 javax.xml.soap 的描述

提供用於創建和建構 SOAP 訊息的 API。此套件在 SOAP with Attachments API for Java^TM (SAAJ) 1.3 規範中進行了定義。

javax.xml.soap 套件中的 API 允許執行以下操作：

• 創建到指定端點的點對點連接
• 創建 SOAP 訊息
• 創建 XML 片段
• 將內容添加到 SOAP 訊息的頭
• 將內容添加到 SOAP 訊息的正文
• 創建附件部分並向其添加內容
• 存取/添加/修改 SOAP 訊息的一部分
• 創建/添加/修改 SOAP 錯誤資訊
• 提取 SOAP 訊息的內容
• 發送 SOAP 請求-回應訊息

此外，javax.xml.soap 套件中的 API 在 org.w3c.dom 套件中擴展了它們的對等項。這意味著 SOAPMessage 的 SOAPPart 也是一個 DOM Level 2 Document，它同樣可以由使用 DOM 的應用程序、工具和資源庫來操縱（有關更多資訊，請參閱 http://www.w3.org/DOM/）。務必注意，雖然可以使用 DOM API 將普通的 DOM 節點添加到 SAAJ 階層樹，但在檢查或操縱階層樹時，SAAJ API 仍需要返回 SAAJ 型別。要實作這一點，應允許 SAAJ API（特別是 SOAPElement.getChildElements()）用所需型別的等效物件正常地替換相對於 SAAJ 需求來說未正確型別化的物件。這些替換一定不能導致階層樹的邏輯結構發生更改，所以從 DOM API 的角度來看，階層樹將保持不變。但是，階層樹的物理混合將更改，從而對被替換的節點的參考將參考不再是階層樹的一部分的節點。如果不需要，則不允許 SAAJ API 進行這些替換，因此替換物件以後就不會被 SAAJ API 的後續調用正常地替換。

這實際上意味著，在使用 DOM API 操縱階層樹之後，開始使用 SAAJ API 來操縱階層樹的應用程序必須假定該階層樹已轉換為一個純 SAAJ 階層樹，並且使用 DOM API 獲取的對階層樹中物件的任何參考不再有效。從 SAAJ API 切換到 DOM API 不會導致無效參考，獨佔地使用 SAAJ API 也不會導致無效參考。只有從在特定 SAAJ 階層樹上使用 DOM API 切換到使用 SAAJ API 時，才有導致無效參考的風險。