用JAXM發送和接收SOAP消息
在本篇技巧文章中,作者兼開發人員 Nicholas Chase 向您演示如何使用用于XML消息傳遞的 Java API(Java API for XML Messaging (JAXM))簡化創建和發送 SOAP 消息的過程。Web 服務的基礎在于以標準格式發送和接收消息以便使所有系統都能理解。通常,那種格式是簡單對象訪問協議(Simple Object Access Protocol (SOAP))。SOAP 消息可以手工生成和發送,但是用于 XML 消息傳遞的 Java API(JAXM)使許多必需步驟(如創建連接或創建并發送實際消息)自動化。這篇技巧文章記錄了一個同步 SOAP 消息的創建和發送。
這個過程包括創建 SOAP 連接、創建 SOAP 消息、填充消息、發送消息、檢索應答。
JAXM 可以作為 Java XML Pack(2002 年春季版)的一部分和 Java Web Services Developer Pack EA2(請參閱參考資料)的一部分而獲得。后者還包含了一份 Tomcat Web 服務器以及樣本應用程序的副本。那些樣本 Web 服務之一作為本技巧文章中 SOAP 消息的目的地,這個例子中實際服務的內容和功能卻不是很重要。
一個基本的SOAP消息由包含兩個主要部分(報頭和主體)的封套組成。應用程序決定如何使用這些部分,但整個消息必須遵循特定的 XML 結構,例如:
|
在這個例子中,報頭為空,而主體包含目的地為一個日歷應用程序的信息。
請注意這個消息的結構。Envelope 包含 Header 和 Body 元素,而三者全都是 http://schemas.xmlsoap.org/soap/envelope/ 名稱空間的一部分。整個消息將通過一個 SOAP 連接發送到一個 Web 服務中。
第一步是創建整個類和連接:
創建連接
|
SOAP消息可以通過使用SOAPConnection直接發送,或使用消息傳遞提供程序間接發送。在這個例子中,應用程序通過使用工廠(factory)創建 SOAPConnection 對象。
工廠也創建消息本身:
創建消息對象
|
首先,通過使用 MessageFactory 來創建消息本身。這個消息已包含如 envelope 和 header 等基本部分的空白版本。SOAPPart 包含 envelope,而 envelope 包含主體。同時創建所需對象(如 SOAPBody)的引用。
接著,填充 SOAPBody:
|
SOAP 消息的主體就象任何其它 XML 元素,您可以在其中添加子元素(如 schedule 元素)。通常,您可以使用 addChildElement(elementname),但是這里演示的 envelope.createName() 方法使用用于數據或有效負載的名稱空間聲明簡化了元素的創建。的確,創建 schedule 元素從而創建了 bodyElement SOAPElement 對象。然后,bodyElement 對象可以給其自己的子元素 cal:newitem 添加其自己的文本節點。通過這種方式,您可以象構建任何其它 XML 文檔一樣構建 XML 結構。
然而,使用 JAXM,您也有機會通過使用外部文件直接創建消息的 SOAPPart。例如,第一個清單中的 XML 結構保存在文件 prepped.msg 中,而且可以調用它來替代手工構建文檔。
|
結果就是準備發送的 SOAP 消息。
發送消息
對于同步消息,發送 SOAP 消息和接收應答是在單個步驟中發生的:
|
實際的消息是使用 call() 方法發送的,該方法把消息本身和目的地作為參數,然后返回第二個 SOAPMessage 作為應答。目的地必須是一個 Endpoint 對象,或者是這個例子中的 URLEndpoint。這個示例使用來自 JWSDP 的一個樣本 servlet,它只用于獲取響應。
call() 方法一直處于阻塞狀態,直到它接收到返回的 SOAPMessage 為止。
返回的 SOAPMessage — reply — 是 SOAP 消息,它與已發送的消息格式相同,因此可以象操作任何其它 XML 消息那樣操作它。SOAP 允許您通過使用 XSLT 直接轉換應答:
|
象在任何 XSLT 應用程序中那樣創建 Transformer 對象。在這個例子中,我們只希望輸出內容,所以沒有用到樣式表。這里,內容本身就是消息的整個 SOAP 部分(與可能包含附件的 SOAP 消息本身不同)。您還可以在處理之前抽取封套和主體。這個例子中的結果只是 System.out,但它可以是通常用于轉換的任何選擇。照常進行轉換。
雖然本示例中的端點是提供靜態響應的 servlet,但是實際的響應取決于服務的功能和請求的性質。同時,雖然本篇技巧文章演示了消息的同步發送和接收,但是通過使用 ProviderConnection 對象而不是 SOAPConnection,JAXM 允許使用消息傳遞提供程序進行異步發送。該提供程序一直保存這個消息,直到成功發送消息為止。
JAXM 還允許使用 profile,這樣很容易創建諸如 SOAP-RP 或 ebXML 消息那樣的專門 SOAP 消息,而且還能使非 XML 附件能夠附加到 SOAP 消息中。
參考資料
請查看 W3C 中的各種與 Web 服務相關的建議書的情況。
JAXM 可以作為 Java XML Pack(2002 年春季版)的一部分和 Java Web Services Developer Pack EA2 的一部分而獲得。
IBM WebSphere Studio Application Developer 是用于構建、測試和部署 Web 服務的易用的集成開發環境。
要獲取完整的 Web 服務工具箱,請下載 IBM 的 Web Services Development Kit。
在 developerWorks 的 XML 和 Web 服務專區查找更多參考資料。
關于作者
Nicholas Chase 一直在參與如 Lucent Technologies、Sun Microsystems、Oracle 和 Tampa Bay Buccaneers 等公司的網站開發。Nick 曾經是一位高中物理教師、低級放射性廢物設備的管理員、在線科幻小說雜志的編輯、多媒體工程師和 Oracle 講師。近來,他是佛羅里達州克利爾沃特 Site Dynamics Interactive Communications 的首席技術官,而且是有關 Web 開發的三本書,包括 Java and XML From Scratch(Que)和即將出版的 Primer Plus XML Programming(Sams)的作者。他愿意傾聽讀者的意見,可以通過 nicholas@nicholaschase.com 與他聯系。
posted on 2005-12-15 11:25 Victor 閱讀(547) 評論(0) 編輯 收藏 所屬分類: web services