javax.xml.ws
介面 LogicalMessage

public interface LogicalMessage

LogicalMessage 介面表示協議無關的 (protocol agnostic) XML 訊息，並包含一些方法提供對訊息負載的存取。

從以下版本開始：

JAX-WS 2.0

方法摘要

Source	getPayload() 以 XML 源的形式獲取訊息負載，可以在相同的 LogicalMessage 實例上多次調用，總是返回可以用來檢索整個訊息負載的新的 Source。
Object	getPayload(JAXBContext context) 以 JAXB 物件的形式獲取訊息負載。
void	setPayload(Object payload, JAXBContext context) 設置訊息負載
void	setPayload(Source payload) 設置訊息負載

方法詳細資訊

getPayload

Source getPayload()

以 XML 源的形式獲取訊息負載，可以在相同的 LogicalMessage 實例上多次調用，總是返回可以用來檢索整個訊息負載的新的 Source。

如果返回的 Source 是 DOMSource 的實例，則對封裝的 DOM 階層樹的修改現場更改訊息負載，不需要隨後調用 setPayload。其他型別的 Source 只提供對訊息負載的讀取存取。

返回：

所含的訊息負載；如果此訊息中沒有淨荷，則返回 null。

setPayload

void setPayload(Source payload)

設置訊息負載

參數：

payload - 訊息負載

拋出：

WebServiceException - 如果在此訊息中設置淨荷過程中發生任何錯誤

UnsupportedOperationException - 如果不支持該操作

getPayload

Object getPayload(JAXBContext context)

以 JAXB 物件的形式獲取訊息負載。注意，返回的物件和訊息負載之間沒有任何連接，更改淨荷需要調用 setPayload。

參數：

context - 應該用來解組訊息負載的 JAXBContext

返回：

所含的訊息負載；如果此訊息中沒有淨荷，則返回 null

拋出：

WebServiceException - 如果使用提供的 JAXBContext 解組淨荷時發生錯誤。WebServiceException 的 cause 是初始 JAXBException。

setPayload

void setPayload(Object payload,
                JAXBContext context)

設置訊息負載

參數：

payload - 訊息負載

context - 應該用來對淨荷進行編組的 JAXBContext

拋出：

UnsupportedOperationException - 如果不支持此操作

WebServiceException - 如果在使用提供的 JAXBContext 對淨荷進行編組時發生錯誤。WebServiceException 的 cause 是初始 JAXBException。